SuperAPI AI 工具集

tinyworld-tinyverse-race-track

编程与开发

查看项目

更新于 10-30 12:08

技能介绍

用途

Tinyverse Race Track 用于为 Tiny World Builder 的 Tinyverse 地面表面添加一条环形赛道(ground-surface race track)、外围桥梁环路(perimeter bridge loop)和拉力卡丁车(rally karts),并提供一个与 poser surface 显示/隐藏联动的 HUD 钩子。赛道逻辑集中在一个文件中:engine/world/61-tinyverse-race-track.js。

主要能力

  • 与角色文件隔离:赛道系统通过包装 window.__tinyworldPoserSurface.{build,show,hide} 接入,并在 poser-surface 组下挂载一个根组。
  • 层级隔离:遵守天空岛与地面表面的分离,不把赛道网格直接加入 worldGroup,也不修改可编辑岛屿或 home-grid 单元格。
  • 缩放补偿:poser surface 的 Y 轴缩放是 X/Z 的三倍,因此保持 root.scale.y = 1 / 3,并在放置赛道/卡丁车几何体前将采样地形高度乘以 3。
  • 复用水材质族:使用现有 TinyWorld 材质族(M.path、M.pathTrim、M.bridgeWood、M.bridgeWoodD、M.castleStoneD),不为赛道新增纹理资源;如需 fog=false 的可读性可本地克隆材质,但不修改共享的 M.* 材质。
  • 静态与动态分离:静态道路/桥梁部件放在静态子组中,编写完成后运行 mergeStaticBaseMeshesByMaterial(...);动态卡丁车放在独立子组,仅通过变换做动画。
  • HUD 联动:HUD 仅在 poser surface 可见时显示;PS.hide() 必须隐藏 HUD 并清除活动比赛状态。
  • 用户入口:Play rally 启动器应调用 watch(),下降到 poser surface,从地面层取景路线,并在下降稳定后开始比赛,避免仅控制台或隐藏按键功能。
  • 观看模式:watch() 可设置 body.tinyverse-rally-watch 以清除干扰的编辑器面板并使用轻量跟随相机;该状态仅限 watch() 内,hide 时清除。
  • 主循环集成:不创建本地 requestAnimationFrame 循环;模块暴露 window.__tinyworldRaceTrack._tick(dt),由 25-animation-loop-schema.js 从主循环调用,_tick 在隐藏时保持快速空操作。

公开运行时接口

window.__tinyworldRaceTrack 提供:show()、hide()、watch()、startRace()、stopRace()、rebuild()、group()、routeLength()。

使用方式与验证

  • 语法检查:node --check engine/world/61-tinyverse-race-track.js
  • 项目检查:node tools/check.js
  • 视觉检查:点击 Play rally 或调用 window.__tinyworldRaceTrack.watch(),确认应用下降到地面岛屿、取景道路环路、显示 HUD,并开始移动卡丁车。

适用场景

适用于在 Tiny World Builder 的 Tinyverse 地面层添加或修改赛道、桥梁环路与拉力卡丁车,以及维护 poser surface 显隐联动的 HUD 和观看模式。

限制

资料仅给出模块规则与验证方式,未提供具体安装步骤、依赖版本、性能指标或收费信息。