Files
Oshima-Game/templates/2d-character-v1/README.md
T
2026-09-19 17:24:02 +08:00

2.3 KiB

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:从母版到交付包的阶段检查表。