4.0 KiB
4.0 KiB
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 接入建议
- 创建项目后先按完整 PNG 帧动画接入,不立即搭建 Skeleton2D。
- 每个运行时方向建立
idle与throw两组动画,帧顺序和时长直接读取模板清单。 - 角色根节点与每组帧都使用底部中心原点;禁止按单帧 Alpha 范围重新居中。
- 移动朝向采用主轴判定与 15% 斜向滞回区,临界区保持上一方向。
- 身体只使用四个方向;投射物、准星和技能 VFX 保持自由角度。
- LEFT/RIGHT 不得互相水平镜像;UP/DOWN 也具有独立的固定侧别和附件关系。
- 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