first commit
This commit is contained in:
@@ -0,0 +1,53 @@
|
||||
# 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`:从母版到交付包的阶段检查表。
|
||||
Reference in New Issue
Block a user