Rollingcats 公共交通扩展

RTE — Rollingcats Transit Expansion

为 Minecraft Transit Railway 4.0 设计的轨道几何与建造工具。

轨道几何

• 四种路径模式：原生、自动贝塞尔、多点曲线拟合、手动贝塞尔
• 垂直曲线可配置半径，坡度以 ‰ 显示
• 超高（外轨抬高） — 侧倾沿轨道分布；车辆、摄像头和玩家站立平面均会跟随
• 通过统一的 TrackPath 接口进行弧长采样
• 几何分析：曲率、最小半径、坡度等级

建造工具

物品	用途
轨道路径编辑器	打开与当前路径模式匹配的编辑器
路线路径创建器	沿路线批量建造轨道
复合创建器	绘制一次横截面，沿线扫掠生成
位移工具	整体平移轨道

支持平行线复制、沿线阵列、接触网规划、带可拖拽端点手柄的手动轨道链，以及撤销（潜行 + 右键点击空气）。

旧版资源包兼容性

MTR 3.x 资源包在 4.0 下会丢失大量功能。RTE 为迁移过渡期添加了兼容层 —— 以下每一项均可单独开关：

• 两种 JS 运行时（Rhino / GraalJS），通过 engine 字段按资源包选择
• 逐函数脚本回退，避免单个错误脚本影响所有帧
• 3.x（刻/秒）与 4.0（毫秒）之间的时间基准转换
• default.png 按文件名而非精确路径匹配
• 放宽对旧版 MC 资源包的 pack_format 验证
• 根据车门位置推导 DOORWAY 部件（3.x 无此概念）
• 当资源包自带风挡时抑制内置风挡
• 超大纹理在读取时自动缩小

在 322 个社区资源包上的实测结果：加载错误从 567 个降至 19 个。

服务端数据同步

MTR 仅同步玩家附近的数据。当 服务端安装了 RTE 时，会新增三个按需请求（未安装时回退到原版行为）：

• 完整车辆路径 — 修复资源包衍生的预计到达时间与平均速度
• 完整轨道集（分页）— 仪表盘不再因距离丢失路段
• 视口内车辆位置（10 Hz，外推）

资源工作台

游戏内车辆资源编辑器：列出已加载车辆、快照、通过递归 JSON 编辑器修改字段、预览模型、导入纹理、导出为 JSON 或自包含的资源包 zip。

包含内容

带属性编辑器的装饰物件（7 个内置模型）、直接节点以及可统计访客的闸机。界面基于 ImGui 构建，无需 Cloth Config。支持 10 种语言。

---

依赖： MTR 4.0+、Architectury API。Fabric 版本还需要 Fabric API。 可选： MSD（启用接触网规划器）。

许可证：版权所有。 允许在个人或服务器环境免费下载和使用；欢迎在注明出处的情况下进行录制、直播和截图。 再分发、修改和衍生作品需获得书面许可。

本模组需要 Minecraft Transit Railway 4.0 或更高版本， 以及 Architectury API。 Fabric 用户还需要 Fabric API。