Agent Skills › jasonkneen/tiny-world-builder › tinyworld-25d-template-sprites

tinyworld-25d-template-sprites

GitHub

指导TinyWorld项目中2.5D角色模板精灵图的克隆、分类配置及动画播放逻辑，涵盖运行时API使用、资源路径管理及生成脚本调用。

.codex/skills/tinyworld-25d-template-sprites/SKILL.md jasonkneen/tiny-world-builder

Trigger Scenarios

修改可玩角色的2.5D模板精灵图将精灵图克隆到不同的角色类中配置空闲/行走/攻击的精灵表播放逻辑

Install

npx skills add jasonkneen/tiny-world-builder --skill tinyworld-25d-template-sprites -g -y

More Options

Non-standard path

npx skills add https://github.com/jasonkneen/tiny-world-builder/tree/main/.codex/skills/tinyworld-25d-template-sprites -g -y

Use without installing

npx skills use jasonkneen/tiny-world-builder@tinyworld-25d-template-sprites

指定 Agent (Claude Code)

npx skills add jasonkneen/tiny-world-builder --skill tinyworld-25d-template-sprites -a claude-code -g -y

安装 repo 全部 skill

npx skills add jasonkneen/tiny-world-builder --all -g -y

预览 repo 内 skill

npx skills add jasonkneen/tiny-world-builder --list

SKILL.md

Frontmatter

{
    "name": "tinyworld-25d-template-sprites",
    "description": "Use when changing the playable 2.5D template sprite, cloning it into character classes, or wiring idle\/walk\/attack sprite-sheet playback."
}

TinyWorld 25D Template Sprites

This is not the crowd system. Do not route playable template work through vendor/tiny-crowd-layer.js, crowd/, or engine/world/11-vehicle-crowd.js.

Runtime:

engine/world/47-worlds-room.js owns the playable in-world/player-room avatar from these template sheets.
The character is runtime-only and must not write into world[x][z], cellMeshes, export JSON, saved worlds, or crowd people.
Movement uses WASD/arrows. Jump uses Space. Attack uses F. Class cycling uses [ / ].
The world-room avatar class API is exposed via window.__tinyworldWorlds: setAvatarClass(name), cycleAvatarClass(delta), avatarClass(), and avatarClasses().
Warrior/orc side-view avatars in engine/world/47-worlds-room.js are also 64px grid sheets: columns are animation frames and rows are directions. Crop to a single row with repeat.y = 1 / rows; do not sample a full 256px-tall column, or four stacked bodies render in-world.
The Worlds avatar picker/runtime should use the side-view Without_shadow sheets for swordsman/orc avatars unless the user explicitly asks for baked ground shadows.
Side-view swordsman/orc row order is front/down, left, right, back/up. Movement should update the sampled row from the camera-relative sector; do not fake left/right by flipping a single side row when the sheet has real side rows.

Assets:

Source template sheets live under models/people/25D/.
Idle/walk/run sheets are 64px grid sheets.
Attack sheets are 96px grid sheets.
Rows are ordered: down, downRight, right, upRight, up, upLeft, left, downLeft.
Generated class sheets live under models/people/25D/classes/<class>/ as idle.png, walk.png, and attack.png.
Regenerate class sheets with python3 tools/generate-playable-25d-classes.py.

When adding a class:

Add the class name to CLASSES and an overlay function in tools/generate-playable-25d-classes.py.
Add the class name to AVATAR_CLASSES in engine/world/47-worlds-room.js.
Regenerate sheets, then run npm test and npm run build.