StarRailExpress - Wathe 附加组件

星穹铁道快车 - Harpy列车增强模组（Wathe附加包）

🚂 简介

星穹铁道快车（Harpy列车）是一款基于 Minecraft 1.21.1 Fabric 的多人在线社交推理游戏模组。它深度重构了经典的“列车谋杀之谜”（Wathe）玩法，融合了众多知名角色模组的精华，同时引入了大量原创内容。本模组完全开源免费，采用 GPL-3.0-only 许可协议，致力于提供最流畅、功能最丰富、视觉最震撼的列车游戏体验。

本附加包包含 Harpymodloader、StupidExpress、Noellesroles、Harpy Simple Roles 以及部分 KinsWathe 的功能。如果你同时安装 StarRailExpress 和上述模组，将会产生冲突。 请不要将 StarRailExpress 的 Bug 反馈给上述模组。

✨ 核心特性

🎭 庞大角色系统（100+ 角色）

我们整合并创造了超过 100 个独特角色，横跨四大阵营，确保每局游戏都充满惊喜：

• 平民阵营：约 40+ 角色。包括医生、侦探、运动员、巨星、心理学家等。通过完成任务或协助正义使者取得胜利。
• 杀手阵营：约 25+ 角色。包括忍者、执法者、爆破专家、变形者、傀儡师等。目标是消灭所有非杀手玩家。
• 中立阵营：约 30+ 角色。包括赌徒、小偷、食尸鬼、年兽、黑白熊等。每个角色都有独特的个人胜利条件。
• 正义使者/警长阵营：约 10+ 角色。包括巡逻者、高级正义使者、棒球手等。拥有消灭杀手的能力。
• 原创招牌角色：例如“愚者”（塔罗会机制）、“影隼”（潜行刺杀）、“飞行员”（空中支援）等。
• 地图特性职业：类似《鹅鸭杀》，我们制作了一些只会在特定地图上出现的角色。你可以在配置中设置角色出现在哪些地图中。例如，水下区域地图、大规模地图、追逃风格地图，以及包含飞行太空舱的地图。

🧩 丰富修饰符系统（20+ 修饰符）

为每局游戏增添随机性与趣味：

• 体质类型：健壮、不屈、Jeb_。
• 经济类型：富豪（开局拥有额外金钱）、纳税人。
• 特殊类型：双重人格（两名玩家操控一个身体）、骑士、黑白、难民、远征。 提示：你需要在配置中手动调整双重人格的出现概率。

🎊 更多游戏模式（20+ 游戏模式）

我们额外加入了 3 个主要模式和众多娱乐模式。

三种主要模式

• 阳光选角模式：游戏开始时你可以选择心仪的角色。
• 邪恶战争：杀手 vs 超级闲人。
• 修机逃生：逃生者需要修复密码破译器才能活着逃出去。

娱乐模式

• 第四房间：4-8 人卡牌对战模式。
• 轮盘赌：经典轮盘赌加道具对战。
• 捉迷藏：躲藏者隐藏到最后，不被追捕者发现。
• 烫手山芋：利用角色优势将炸弹传递给他人，存活到最后。
• 更多其他有趣模式：例如，所有玩家都是特定角色或带有特定修饰符、狙击枪射击模式等。

🗺️ 快速地图编辑/选择与投票系统

• 可视化地图配置：支持 JSON 格式，可快速定义出生点、等待区、游戏区域、房间位置和背景滚动方向。
• 地图投票（Votemap）：内置 /tmm:votemap 命令，支持暂停、恢复和终止投票，让玩家共同决定下一张地图。
• 异步复制优化：大幅减少地图重置过程中的服务器卡顿和网络数据包压力，实现无缝回合切换。
• 丰富的预设地图：模组附带多张精心设计的列车与场景地图，并支持社区自定义地图导入。
• 地图建造工具：我们提供了一个地图建造工具，你可以在“OP”创造模式标签页中找到它。
• 地图交互方块：我们为任意场景实体交互方块提供了地图交互方块。你可以通过这个方块制作任何地图交互内容，只需从创造模式管理标签页中取用即可。

💻 焕然一新的 UI 与交互体验

• 更美观的界面：完全重写了游戏内 HUD、角色选择界面、商店界面和结算面板。现代设计风格，色彩鲜明且信息层级清晰。
• 体力条显示：实时显示奔跑体力，为追捕与逃脱增加策略深度。
• 任务点指示器：智能任务导航系统，在屏幕上提供清晰的方向提示和距离信息——再也不怕迷路了！
• 操作提示：屏幕右上角显示友好的使用提示。

🛠️ 强大的游戏功能与命令

• 全面的命令系统：
  • /tmm:money - 管理员金钱管理。
  • /tmm:switchmap - 快速加载、保存、扫描和随机切换地图。
  • /tmm:game - 游戏流程控制（开始、结束、强制胜利）。
  • /tmm:showStats - 查看详细的个人及服务器统计数据。
• 多样化的游戏模式：
  • 经典谋杀：传统杀手 vs 平民/正义使者玩法。
  • 赌徒模式：赌徒必须在限时内通过高风险赌局存活；超时即被淘汰。
  • TNT 标签：紧张刺激的“烫手山芋”式炸弹传递——最后持有者被淘汰。
  • 昼夜激战：深度融合昼夜循环、生存元素与阵营战斗的深度玩法。
  • 更多趣味模式：包括捉迷藏、狙击对决、恶魔轮盘以及 15+ 种其他独特模式。
• 回放系统：记录关键游戏事件，支持赛后回放精彩时刻。

⚡ 性能与网络优化

• 网络数据包减少：通过非正式但有效的测试，本模组相比原版 Wathe/TMM 显著减少了数据包传输，大大降低了服务器带宽压力。
• 客户端性能优化：对原版内容的大量优化可将 FPS 提升 2-6 倍。
• 数据组件优化：优化了 CCA（Cardinal Components API）数据同步逻辑，减少不必要的网络传输。

⚠️ 重要说明

兼容性

• 与其他 Wathe 扩展不兼容：本模组会封锁原版 Wathe 运行时。切勿同时安装其他 Wathe 附加包，如 Harpymodloader、StupidExpress、Noellesroles。
• 需要 Wathe 作为前置：仅用于基础装饰方块资源；本模组不使用其任何逻辑。
• 冲突模组：CustomSkinLoader（可能导致皮肤加载问题）。
• 推荐模组：Sodium、Iris、ModMenu、Simple Voice Chat、Cloth Config API。

技术特性

• 使用 Mojang 映射重写，代码更简洁。
• 命名空间保持为 trainmurdermystery 和 starrailexpress，以兼容现有地图。
• 完全独立的运行时逻辑，稳定性更高。

🎯 目标场景

• 大型多人在线社交推理服务器
• 朋友间的派对小游戏
• 角色扮演（RP）地图
• 自定义 PVP/PVE 混合玩法

💻 开发信息

• 地图制作文档：腾讯文档
• 完整 API 文档：API — 涵盖角色注册、事件系统、技能系统、HUD 渲染等。
• 扩展创建指南：创建扩展 — 快速上手编写你自己的扩展模组。
• 开源许可：GNU General Public License v3.0 only（GPL-3.0-only）

---

注意：在开发扩展时，切勿引用 Wathe 库文件——这会导致崩溃！

加入社区：欢迎加入我们的 QQ 群或 Discord，获取最新地图、报告 Bug 或讨论游戏策略。