Files
Oshima-Game/docs/02汐月心音模板角色交付说明.md
2026-09-19 17:24:02 +08:00

4.0 KiB
Raw Permalink Blame History

02 汐月心音模板角色交付说明

交付状态:art-template-ready
引擎状态:not-started-no-godot-project
推荐首轮接入方式:完整 PNG 关键帧动画;分解件与枢轴清单保留给后续 Skeleton2D

1. 唯一入口

未来建立 Godot 项目时,应优先读取:

  • assets/images/2d-game-characters/02-xinyin/template-package-v1.json

该清单已经汇总四方向别名、装配图、动作清单、固定裁切框、脚底原点、关键帧时长、循环预览和当前限制。不要通过文件夹名称猜测运行时方向。

四方向选择规则仍以以下文件为准:

  • assets/images/2d-game-characters/02-xinyin/direction-map-v1.json

2. 四方向映射

运行时方向 素材方向 ID 构图 状态
up up 严格背面 中性装配、动作、三档循环已验证
down down 严格正面 中性装配、动作、三档循环已验证
left front-right 三分之四侧身,朝画面左 中性装配、动作、三档循环已验证
right front-left 三分之四侧身,朝画面右 中性装配、动作、三档循环已验证

LEFT 与 RIGHT 保留历史目录,只为兼容现有清单和重建工具。运行时必须使用 template-package-v1.json 的 runtimeDirection 与 assetDirectionId 映射。

3. 动画契约

四个方向都使用 600 × 760 px 透明动作画布和相同的七个关键帧:

关键帧 时长
idle-inhale 420 ms
idle-neutral 260 ms
idle-exhale 420 ms
throw-ready 150 ms
throw-windup 110 ms
throw-release 90 ms
throw-recover 180 ms

待机循环为 inhale → neutral → exhale → neutral,周期 1360 ms。投掷播放为 ready → windup → release → recover → neutral,周期 790 ms;投掷本身不循环。

所有方向都已经用联合固定裁切框进行播放验证,不允许逐帧重新居中。Sprite 原点使用固定裁切框的底部中心。

4. 显示规格

档位 角色显示高度 参考菱形格
100% 176 px 128 × 64 px
75% 132 px 96 × 48 px
50% 88 px 64 × 32 px

176 px 为当前默认战场显示基准。132 px 和 88 px 用于远景及可读性压力测试,不代表最终镜头缩放值已经在引擎中冻结。

5. 首轮 Godot 接入建议

  1. 创建项目后先按完整 PNG 帧动画接入,不立即搭建 Skeleton2D。
  2. 每个运行时方向建立 idle 与 throw 两组动画,帧顺序和时长直接读取模板清单。
  3. 角色根节点与每组帧都使用底部中心原点;禁止按单帧 Alpha 范围重新居中。
  4. 移动朝向采用主轴判定与 15% 斜向滞回区,临界区保持上一方向。
  5. 身体只使用四个方向;投射物、准星和技能 VFX 保持自由角度。
  6. LEFT/RIGHT 不得互相水平镜像;UP/DOWN 也具有独立的固定侧别和附件关系。
  7. 176/132 px 首选线性过滤;88 px 需要在实际镜头中并列比较线性与最近邻后再冻结。

6. 尚未完成的引擎工作

  • Godot 导入预设、纹理过滤、压缩与 mipmap 策略;
  • AnimatedSprite2D/SpriteFrames 或 AnimationPlayer 资源;
  • 碰撞体、选择框、导航占位、阴影、Y 排序和遮挡规则;
  • 投射物出生点、手部/武器/VFX Socket;
  • 实际地图上的 176/132/88 px 镜头验证与性能测试;
  • Skeleton2D、分解件极限旋转、关节补缝及插值动画。

因此当前版本是“可投入引擎接入的美术模板”,不是已经完成引擎验收的游戏角色。

7. 重建与验证

模板总清单与交付总览可通过以下脚本重复生成:

python tools/build_xinyin_template_package.py

四方向循环预览由 tools/build_xinyin_motion_playback.py 生成。UP 示例:

python tools/build_xinyin_motion_playback.py --direction up --motion-version 1

交付总览:

  • assets/images/2d-game-characters/02-xinyin/previews/xinyin-template-role-handoff-v1.png