File contents 精灵朝向变化下的法线光照一致性
效果预览
同一原鸟水平翻面再恢复,固定灯在左;用原sprite上的标量亮暗诊断示意旧光照随纹理翻转与修正后世界方向一致。
左侧为使用前,右侧为使用后;斜视 2.5D 短循环,用途示意(非引擎实测;音频相关预览仅示意触发关系,不含声音)。
输入与边界
取得项目引擎/版本、实际渲染后端与材质路径、精灵颜色图和法线图、导入与采样设置、动画帧/图集对应、方向选择规则,以及灯的位置和光照计算空间。列出项目实际使用的翻面、UV 镜像、局部旋转、父级负缩放和换方向图方式,不能把这些视为同一个操作。
先确认法线纹理的空间、编码、轴向/绿色通道约定和渲染器解码方式;不明确时查项目 shader、导入器和匹配版本的引擎实现,并用已知方向的诊断纹理校准。无法确定时保留基线并报告缺项,不批量反相通道或生成方向资产。
只修正渲染表面的朝向与受光关系。角色移动、瞄准、灯控制、碰撞和命中规则保持原有权威来源;非镜像的不同方向原画可能代表不同表面,应按各自画面配法线,不能用向量变换制造缺失的表面信息。
实施流程
建立最小检查场景:一张左右/上下不对称的精灵、配对法线图、一个有可见位置标记的固定灯。固定相机、曝光和环境光,暂时关掉其他灯、闪白等干扰。保存未修改材质的原朝向结果,同时准备无凹凸的平面法线对照和具有已知倾斜方向的诊断法线图。不要仅凭复杂原画的高光猜轴向。
分开验证采样与方向。先显示颜色图、法线图采样区域及解码后的法线方向,确认同一帧、相同裁切/偏移、图集布局和有效 UV;再检查法线经哪一步进入光照空间。查清翻面改变了顶点、UV、切线基还是多个部分,以及引擎是否已经补偿。镜像 texel 位置与变换其中编码的方向是两件事,但最终可以由同一渲染路径正确完成。
对每种实际朝向操作做未修改基线:原向、水平翻、垂直翻、双翻和支持的旋转。先逐项,再测旋转加翻面及负缩放父级;记录有效变换顺序,不将组合结果凭 XOR 或某个通道的符号猜出。保持灯不动检查表面相对灯的反应,再固定精灵移动灯到不同侧边。正确结果应符合变换后的表面方向,不要求所有姿态亮度相同。
根据证据选择一条纠正路径,并明确唯一负责层:
渲染器已正确处理:保留同一镜像可复用的法线资产,不加 shader 通道翻转;继续检查图集/动画配对或导入差异。
内建路径存在缺失:先查项目版本适用的修复或受支持设置,在隔离场景验证,再决定是否采用;不要因历史修复存在就认定当前后端、材质和负缩放路径都已覆盖,也不为局部问题盲目升级项目。
必须自定义 shader:在法线解码后,使用已确认的法线空间和有效朝向,将法线/基转换到灯计算所用空间;优先复用引擎的法线解码及变换接口。写清采样 UV、方向变换、父级变换的职责,补偿仅执行一次,变换后按管线要求归一化。任意旋转、非均匀缩放和反射组合不能套用未经验证的单通道反相;不明确适用矩阵或轴约定时停止扩展该路径。
管线无法提供所需变换,或方向原画确实不同:选择显式方向法线资产,并定义它在选定 shader 中代表的朝向。仍要测试引擎是否再次变换,避免资产预补偿与 shader/渲染器重复修正。不要把新增贴图当所有镜像问题的必选解。
将颜色帧、法线帧/区域、材质实例及纠正模式作为同一次显示状态提交。朝向或动画帧改变时从当前权威显示状态重建,不把上一帧修正继续累乘。贴图未就绪或缺帧时用项目批准的配对基线/无凹凸显示,并暴露缺失诊断,不借用另一个方向或上一对象的法线。异步加载完成时先核对显示代次、帧/方向标识及对象实例代次仍匹配当前状态;旧完成通知不直接安装其贴图,而是释放自己持有的过期引用并按当前状态重新解析绑定,不能覆盖后来换向或池化复用后的配对。用实例参数隔离不同角色,不随意改共享材质。
在整套动画、运行时换装/换精灵、对象复用和重新启用中重复验证。显式清理旧方向资产与实例纠正参数,再按当前帧重建绑定。先验证普通单帧,再启用图集、压缩、批处理及项目实际光照层;若某一步才失败,定位该步骤,不同时改贴图和 shader 掩盖原因。
最后恢复正式灯光和游戏画面,在实际显示比例/目标设备测轮廓、像素采样、亮暗可读性及帧耗。对比关闭法线与开启法线的同场景资源/渲染成本,再确定质量档与回退。若降低强度或关闭凹凸,保持颜色帧、朝向和玩法不变。
调参顺序
先调正确性:贴图配对 → 导入编码/轴向 → 渲染器已有变换 → 唯一纠正层 → 组合变换。全部正确后才调凹凸强度、灯高度/方向、过滤、压缩与图集边缘处理。像素画的颜色图与法线图应保持像素位置对应,但具体过滤/编码必须符合各自用途,不盲目复制颜色贴图的导入预设。没有统一的强度、灯距离、方向数或新增贴图数量。
验收
失败恢复
只有镜像受光反向:先查该翻面是否已变换法线基,再看 shader/资产有无二次补偿;逐层关闭自定义修正对照,勿先全图反色。
全部姿态都上下反向:先检查导入与法线轴约定;方向特例不是修复全局约定的办法。
单独翻面正确、旋转或父级缩放后错误:检查法线空间、变换顺序与反射处理;暂回已验证的表示方式并明确未支持组合,不篡改角色方向掩盖。
只有部分帧/图集错位:先定位帧配对、裁切、打包旋转和边缘采样;不要用光照强度抵消错图。
所有角色一起改变或复用后闪烁:检查共享材质写入、实例重置及帧绑定是否原子更新。性能超预算时比较法线通道、额外通道/纹理与层批次成本,选择已批准降级,不宣称额外贴图或 shader 修正免费。
按需组合
移动方向动画 选择显示姿态,分件瞄准 管理持握与绘制层级,面向相对灯控制 决定灯方向。本页只消费这些既有状态,校正表面受光。
运行状态表面动画 拥有转速到 UV 相位的映射;薄片卷曲 拥有几何形变后的法线更新,不能由本页精灵翻面流程替代。
需要核查出处、适用版本线索和证据边界时,读取来源参考。
1 --- 2 name: gameplay-sprite-normal-orientation 3 description: "精灵翻面、旋转或换方向帧后法线光照反向、跳变或与表面不符时,检查贴图配对、法线空间与渲染器已有变换,只在缺失处修正一次;不把每个镜像方向都变成新法线资产,也不接管角色朝向或灯的控制。" 4 metadata: 5 source: https://skillmd.com/skills/ziyou-lu/gameplay-sprite-normal-orientation 6 --- 7 8 # 精灵朝向变化下的法线光照一致性 9 10 ## 效果预览 11 12 同一原鸟水平翻面再恢复,固定灯在左;用原sprite上的标量亮暗诊断示意旧光照随纹理翻转与修正后世界方向一致。 13 14 左侧为使用前,右侧为使用后;斜视 2.5D 短循环,用途示意(非引擎实测;音频相关预览仅示意触发关系,不含声音)。 15 16  17 18 ## 输入与边界 19 20 取得项目引擎/版本、实际渲染后端与材质路径、精灵颜色图和法线图、导入与采样设置、动画帧/图集对应、方向选择规则,以及灯的位置和光照计算空间。列出项目实际使用的翻面、UV 镜像、局部旋转、父级负缩放和换方向图方式,不能把这些视为同一个操作。 21 22 先确认法线纹理的空间、编码、轴向/绿色通道约定和渲染器解码方式;不明确时查项目 shader、导入器和匹配版本的引擎实现,并用已知方向的诊断纹理校准。无法确定时保留基线并报告缺项,不批量反相通道或生成方向资产。 23 24 只修正渲染表面的朝向与受光关系。角色移动、瞄准、灯控制、碰撞和命中规则保持原有权威来源;非镜像的不同方向原画可能代表不同表面,应按各自画面配法线,不能用向量变换制造缺失的表面信息。 25 26 ## 实施流程 27 28 1. 建立最小检查场景:一张左右/上下不对称的精灵、配对法线图、一个有可见位置标记的固定灯。固定相机、曝光和环境光,暂时关掉其他灯、闪白等干扰。保存未修改材质的原朝向结果,同时准备无凹凸的平面法线对照和具有已知倾斜方向的诊断法线图。不要仅凭复杂原画的高光猜轴向。 29 2. 分开验证采样与方向。先显示颜色图、法线图采样区域及解码后的法线方向,确认同一帧、相同裁切/偏移、图集布局和有效 UV;再检查法线经哪一步进入光照空间。查清翻面改变了顶点、UV、切线基还是多个部分,以及引擎是否已经补偿。镜像 texel 位置与变换其中编码的方向是两件事,但最终可以由同一渲染路径正确完成。 30 3. 对每种实际朝向操作做未修改基线:原向、水平翻、垂直翻、双翻和支持的旋转。先逐项,再测旋转加翻面及负缩放父级;记录有效变换顺序,不将组合结果凭 XOR 或某个通道的符号猜出。保持灯不动检查表面相对灯的反应,再固定精灵移动灯到不同侧边。正确结果应符合变换后的表面方向,不要求所有姿态亮度相同。 31 4. 根据证据选择一条纠正路径,并明确唯一负责层: 32 - 渲染器已正确处理:保留同一镜像可复用的法线资产,不加 shader 通道翻转;继续检查图集/动画配对或导入差异。 33 - 内建路径存在缺失:先查项目版本适用的修复或受支持设置,在隔离场景验证,再决定是否采用;不要因历史修复存在就认定当前后端、材质和负缩放路径都已覆盖,也不为局部问题盲目升级项目。 34 - 必须自定义 shader:在法线解码后,使用已确认的法线空间和有效朝向,将法线/基转换到灯计算所用空间;优先复用引擎的法线解码及变换接口。写清采样 UV、方向变换、父级变换的职责,补偿仅执行一次,变换后按管线要求归一化。任意旋转、非均匀缩放和反射组合不能套用未经验证的单通道反相;不明确适用矩阵或轴约定时停止扩展该路径。 35 - 管线无法提供所需变换,或方向原画确实不同:选择显式方向法线资产,并定义它在选定 shader 中代表的朝向。仍要测试引擎是否再次变换,避免资产预补偿与 shader/渲染器重复修正。不要把新增贴图当所有镜像问题的必选解。 36 5. 将颜色帧、法线帧/区域、材质实例及纠正模式作为同一次显示状态提交。朝向或动画帧改变时从当前权威显示状态重建,不把上一帧修正继续累乘。贴图未就绪或缺帧时用项目批准的配对基线/无凹凸显示,并暴露缺失诊断,不借用另一个方向或上一对象的法线。异步加载完成时先核对显示代次、帧/方向标识及对象实例代次仍匹配当前状态;旧完成通知不直接安装其贴图,而是释放自己持有的过期引用并按当前状态重新解析绑定,不能覆盖后来换向或池化复用后的配对。用实例参数隔离不同角色,不随意改共享材质。 37 6. 在整套动画、运行时换装/换精灵、对象复用和重新启用中重复验证。显式清理旧方向资产与实例纠正参数,再按当前帧重建绑定。先验证普通单帧,再启用图集、压缩、批处理及项目实际光照层;若某一步才失败,定位该步骤,不同时改贴图和 shader 掩盖原因。 38 7. 最后恢复正式灯光和游戏画面,在实际显示比例/目标设备测轮廓、像素采样、亮暗可读性及帧耗。对比关闭法线与开启法线的同场景资源/渲染成本,再确定质量档与回退。若降低强度或关闭凹凸,保持颜色帧、朝向和玩法不变。 39 40 ## 调参顺序 41 42 先调正确性:贴图配对 → 导入编码/轴向 → 渲染器已有变换 → 唯一纠正层 → 组合变换。全部正确后才调凹凸强度、灯高度/方向、过滤、压缩与图集边缘处理。像素画的颜色图与法线图应保持像素位置对应,但具体过滤/编码必须符合各自用途,不盲目复制颜色贴图的导入预设。没有统一的强度、灯距离、方向数或新增贴图数量。 43 44 ## 验收 45 46 - [ ] 用已知倾斜方向的诊断图验证每个支持朝向、旋转/翻面顺序和父级负缩放;固定灯与移动灯两组结果均符合预期,不靠“看起来差不多”认定通过。 47 - [ ] 平面法线对照不产生无来源的局部凹凸;未翻面原态没有因修复镜像而变坏。对比内建基线与纠正路径,确认不存在双重纠正。 48 - [ ] 动画每帧、图集边缘和换装均配对,无错位、邻格采样、方向闪帧或旧法线残留;两个共享素材、不同朝向的实例互不污染;旧方向贴图在新方向或对象复用后才加载完成时,当前配对保持正确。 49 - [ ] 重启、复用、资源延迟/缺失都有确定显示与诊断;同一显示状态重复提交不积累额外旋转或反相。 50 - [ ] 各支持后端/质量档在目标画幅与设备下完成视觉和成本检查;记录实际覆盖范围,未测的旋转、缩放或后端不能写成已支持。纯显示变更不改移动、瞄准、灯控制与碰撞规则。 51 52 ## 失败恢复 53 54 - 只有镜像受光反向:先查该翻面是否已变换法线基,再看 shader/资产有无二次补偿;逐层关闭自定义修正对照,勿先全图反色。 55 - 全部姿态都上下反向:先检查导入与法线轴约定;方向特例不是修复全局约定的办法。 56 - 单独翻面正确、旋转或父级缩放后错误:检查法线空间、变换顺序与反射处理;暂回已验证的表示方式并明确未支持组合,不篡改角色方向掩盖。 57 - 只有部分帧/图集错位:先定位帧配对、裁切、打包旋转和边缘采样;不要用光照强度抵消错图。 58 - 所有角色一起改变或复用后闪烁:检查共享材质写入、实例重置及帧绑定是否原子更新。性能超预算时比较法线通道、额外通道/纹理与层批次成本,选择已批准降级,不宣称额外贴图或 shader 修正免费。 59 60 ## 按需组合 61 62 [移动方向动画](../gameplay-movement-feedback/SKILL.md)选择显示姿态,[分件瞄准](../gameplay-aim-pose/SKILL.md)管理持握与绘制层级,[面向相对灯控制](../gameplay-facing-relative-light-aim/SKILL.md)决定灯方向。本页只消费这些既有状态,校正表面受光。 63 64 [运行状态表面动画](../gameplay-state-driven-surface-motion/SKILL.md)拥有转速到 UV 相位的映射;[薄片卷曲](../gameplay-sheet-curl/SKILL.md)拥有几何形变后的法线更新,不能由本页精灵翻面流程替代。 65 66 需要核查出处、适用版本线索和证据边界时,读取[来源参考](references/sources.md)。
ziyou-lu/bkb-gameplay-skills commit 498a8529a0
Frequently asked questions How do I install the Gameplay Sprite Normal Orientation skill? Run npx get-skill add ziyou-lu/gameplay-sprite-normal-orientation in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the Gameplay Sprite Normal Orientation skill do? 精灵翻面、旋转或换方向帧后法线光照反向、跳变或与表面不符时,检查贴图配对、法线空间与渲染器已有变换,只在缺失处修正一次;不把每个镜像方向都变成新法线资产,也不接管角色朝向或灯的控制。 It is listed under Coding & Dev Tools on SkillMD.
Is Gameplay Sprite Normal Orientation safe to use? This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with Gameplay Sprite Normal Orientation? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is Gameplay Sprite Normal Orientation free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published Gameplay Sprite Normal Orientation? ziyou-lu (@ziyou-lu) published this skill. Their other Agent Skills are listed on their SkillMD profile.