# Gameplay Skeletal Planar Shadows

> 用复用主角色骨骼姿态的低模副网格和材质顶点平面投影制作可调角度、长度的黑色角色阴影；用于风格化轮廓，不是落点圆斑、复杂地形贴合或物理光照替代。

- Skill: `ziyou-lu/gameplay-skeletal-planar-shadows` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-skeletal-planar-shadows`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-skeletal-planar-shadows/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ziyou-lu (https://skillmd.com/u/ziyou-lu)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/ziyou-lu/gameplay-skeletal-planar-shadows

---


# 低模骨骼副网格的平面阴影

## 效果预览

相同跳动与旋转，用原鸟alpha派生简化显示轮廓投平地；不添加第二套动画或碰撞。

左侧为使用前，右侧为使用后；斜视 2.5D 短循环，用途示意（非引擎实测；音频相关预览仅示意触发关系，不含声音）。

![影子要跟着角色的轮廓动：使用前后对比](assets/before-after.webp)

## 触发与输入

角色需要与插画环境一致的硬朗黑色轮廓，且项目允许阴影投到一个明确的接收平面时使用。取得主角色骨骼与姿态输出、可简化的蒙皮网格、骨骼映射、世界接收平面、艺术投影朝向与长度范围、目标相机和最大同屏角色数。先确定哪些场景属于平面适用范围；没有有效平面或跨层时隐藏，不默认自动贴合地形。

## 实施流程

1. **制作第二份简化骨骼网格。** 保留影响远近相机下轮廓的头、躯干、肢体和必要装备，优先删内部与不可见细节。保持兼容的骨骼层级、绑定姿势和蒙皮映射；不能仅因骨骼同名就假定兼容。先用站立、伸展、攻击姿态对照剪影，决定可接受的简化量。
2. **复用主角色姿态。** 把主角色设为 leader，由副网格消费主角色已求值的骨骼姿态，而不是再挂一套独立动画状态机。检查跟随组件所需的骨骼是否在主角色当前 LOD 中仍可提供，并校对根变换与更新顺序。主角色隐藏、暂停或降级更新时，明确副网格同步策略，避免其使用过期姿态。姿态复用不等于免除副网格蒙皮或绘制成本。
3. **先蒙皮，后平面投影。** 材质使用当前蒙皮后的顶点位置，将其转换到与接收平面一致的坐标系，再投到指定地面。只操作显示位置，不压扁主网格或角色碰撞体。先在单一平地验证脚部接触与轮廓，再接入移动的平面参数；需要数学起点时读取[工程投影参考](references/sources.md#可选平面投影工程推导)。
4. **分离方向与长度控制。** 固定地面接触基准，暴露平面内朝向和高度对应的水平伸长量。选择世界固定方向或随角色旋转方向，并在转身时检查，不让模型局部轴偶然决定影子方向。限定最大伸展范围，禁止近乎平行于平面的投影产生无限长影子。
5. **设置纯表现材质与组件。** 选择不受场景光强驱动的黑色/指定色材质；先用不透明轮廓验证，确需半透明再检查肢体重叠造成的加深与排序。按项目剔除模式处理压平三角形消失，必要时评估双面。用小而可调的平面法线偏移处理深度争夺，确认远景不漂浮。副网格关闭玩法碰撞，并决定是否禁用其额外投射实时阴影，防止重复阴影。
6. **限定显示与清理。** 让渲染包围盒覆盖最大投影伸展范围，不能只照搬未压平角色的 bounds。角色销毁、换装、切换骨架或传送时重绑/清理对应副网格。无有效接收平面、楼层不明确或地形超出契约时隐藏；要支持台阶/墙体遮挡需另设计接收面方案，不靠本平面投影承诺解决。

## 调参顺序

- 先调骨骼兼容性、低模轮廓和脚底对齐，再调方向、水平伸长与上限。
- 用项目最小/最大相机距离分别调材质颜色、深度偏移和剔除；不能用大偏移掩盖接收面选错。
- 固定同屏数量和动画场景，对照主角色单独渲染与加入阴影后的动画求值次数、蒙皮、绘制和包围盒开销；以实测决定低模细度、距离裁剪和可见性策略。

## 验收与失败恢复

- 站立、跑动、快速攻击、转身、暂停/恢复、主角色 LOD 切换时，影子肢体与主姿态同步；滞后一帧先查更新顺序，缺肢先查映射与 LOD 骨骼，不能用第二套动画求值掩盖。
- 同一平面上水平移动与升降时投影基准稳定；旋转角色不意外旋转世界固定方向。近退化方向被拒绝或回退到已选的有效方向，不输出巨型网格。
- 最大长度与屏幕边缘位置下影子不会提前消失；若消失检查投影后 bounds，而非全局禁用剔除。
- 地面近景无闪烁，远景无悬浮；重叠肢体、正反面和透明排序均符合选定风格。
- 台阶边缘、楼层切换、无地面测试触发已声明的隐藏/降级，不穿到无关层。阴影没有碰撞、阻挡、受击或导航作用。
- 以目标同屏数量检查没有副网格独立动画求值；记录实际总成本，不把简化网格当作已经证明的性能收益。

## 职责边界

[世界内位置参照](../gameplay-worldspace-indicators/SKILL.md)的软圆斑强调当前地面位置，不需要角色骨骼剪影；[表面余效](../gameplay-surface-aftermath/SKILL.md)按事件生成并采样边界/地形网格，不消费角色连续姿态。本技能仅负责与角色姿态同步的平面轮廓，不替代二者。

核对来源支持范围与工程推导时读取[来源参考](references/sources.md)。

