OSM 2D 角色空白模板 v1
本模板由 02 汐月心音的完整美术生产流程抽象而来,用于新角色的四方向 2D 战场素材。它只复用目录、命名、动画契约和验收门槛,不复制心音的造型、固定侧别或历史目录。
固定基线
- 角色比例:4.75 头身的成年轻 Q 战斗比例;允许在角色设定要求下调整,但必须重新做三档尺寸验证。
- 运行时身体方向:
up / down / left / right。 - 新角色目录直接使用四方向名称,不使用
front-left / front-right历史别名。 - 标准动作画布:600 × 760 px,透明背景,原点为底部中心。
- 默认显示高度:176 px;压力测试高度为 132 px 和 88 px。
- 身体使用四方向;投射物、准星和技能 VFX 可以自由角度瞄准。
- LEFT 与 RIGHT 默认独立制作。只有角色完全对称且通过专门审查后,才可以考虑镜像。
标准动画契约
| 关键帧 | 时长 |
|---|---|
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。
使用方法
在项目根目录运行:
python tools/scaffold_2d_character.py 03-example --name-zh "角色名" --name-en "English Name"
先使用 --dry-run 可只查看将创建的内容:
python tools/scaffold_2d_character.py 03-example --name-zh "角色名" --dry-run
脚手架拒绝覆盖已存在的角色目录。创建后,从 source/up、source/down、source/left、source/right 开始制作,按 production-checklist.md 逐阶段提升状态。
模板文件
template-manifest.json:模板自身的版本、文件入口和验证结果。character-config.template.json:角色级美术与运行时约束。direction-map.template.json:四方向状态与路径入口。template-package.template.json:未来引擎接入的统一入口占位。character-readme.template.md:新角色目录内的说明。validation-rules-v1.json:可机器读取的硬性验收规则。production-checklist.md:从母版到交付包的阶段检查表。