SuperAPI AI 工具集

tinyworld-25d-template-sprites

设计与创作

查看项目

更新于 10-30 13:08

技能介绍

用途

本技能(tinyworld-25d-template-sprites)用于在 TinyWorld 项目中处理可玩的 2.5D 模板精灵:替换模板精灵、将其克隆为角色职业,以及接通待机/行走/攻击精灵表的播放。它明确区别于人群系统,不应通过 vendor/tiny-crowd-layer.js、crowd/ 或 engine/world/11-vehicle-crowd.js 处理可玩模板相关工作。

运行时与交互

运行时由 engine/world/47-worlds-room.js 负责,从这些模板表生成世界内/玩家房间的头像。角色是运行时对象,不得写入 world[x][z]、cellMeshes、导出 JSON、已保存世界或人群人物。

操作方式:WASD/方向键移动,空格跳跃,F 攻击,[ / ] 循环切换职业。

世界房间头像类 API 通过 window.__tinyworldWorlds 暴露:setAvatarClass(name)、cycleAvatarClass(delta)、avatarClass() 和 avatarClasses()。

素材结构与生成

源模板表位于 models/people/25D/。待机/行走/奔跑表为 64px 网格表;攻击表为 96px 网格表。行顺序为:down、downRight、right、upRight、up、upLeft、left、downLeft。

生成的职业表位于 models/people/25D/classes/<class>/,包含 idle.png、walk.png、attack.png。使用 python3 tools/generate-playable-25d-classes.py 重新生成职业表。

侧面头像注意事项

engine/world/47-worlds-room.js 中的剑士/兽人侧面头像同样是 64px 网格表:列为动画帧,行为方向。需用 repeat.y = 1 / rows 裁剪到单行;不要采样完整的 256px 高列,否则会在世界中渲染出四个叠放的身体。

除非用户明确要求烘焙地面阴影,世界头像选择器/运行时应对剑士/兽人使用侧面 Without_shadow 表。侧面剑士/兽人的行顺序为前/下、左、右、后/上。移动时应根据相机相对扇区更新采样行;当表中有真实侧向行时,不要通过翻转单侧行来伪造左/右。

新增职业步骤

  1. 在 tools/generate-playable-25d-classes.py 的 CLASSES 中添加职业名,并添加叠加函数。
  2. 在 engine/world/47-worlds-room.js 的 AVATAR_CLASSES 中添加职业名。
  3. 重新生成素材表,然后运行 npm test 和 npm run build。

适用场景与限制

适用于 TinyWorld 2.5D 模板精灵的替换、职业克隆与动画播放接线。资料未提供该技能的收费、价格、平台依赖或效果说明,暂未提供。