# 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。 ## 使用方法 在项目根目录运行: ```powershell python tools/scaffold_2d_character.py 03-example --name-zh "角色名" --name-en "English Name" ``` 先使用 `--dry-run` 可只查看将创建的内容: ```powershell 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`:从母版到交付包的阶段检查表。