MTR票价专业版

MTR票价专业版

Minecraft Transit Railway 票价系统附加组件。支持4种票价计算模式,包括基于距离、基于区域、基于路径和路径-区域票价计算,并支持站点到站点的图形路由。

游戏机制

模组介绍

基本信息

  • 模组名称:MTR Fare Pro
  • 版本:0.2-beta
  • 作者:hhd
  • 适用版本:
    • Minecraft 1.18.2、1.19.2、1.19.4、1.20.1、1.20.4(Fabric)-MTR4
    • Minecraft 1.18.2、1.19.2、1.19.4、1.20.1(Fabric)-MTR3
  • 运行环境:客户端需装,服务端需装
  • 适配 MTR 版本:4.0.3 ~ 4.0.5(MTR4);3.2.2-hotfix-1(MTR3)
  • 前置模组:
    • Fabric Loader ≥ 0.15.11,Fabric API(所有版本)
    • Minecraft Transit Railway 4.0.3 ~ 4.0.5(MTR4+1.18.2、MTR4+1.19.2、MTR4+1.19.4、MTR4+1.20.4)
    • Minecraft Transit Railway 4.0.3 ~ 4.0.5,Metropolis 0.4.3+(仅 MTR4+1.20.1)
    • YMTR3.6.1+,Metropolis 0.4.0+(仅 MTR3+1.20.1)
    • Minecraft Transit Railway 3.2.2-hotfix-1,Metropolis 0.4.0(MTR3+1.19.2)
    • Minecraft Transit Railway 3.2.2-hotfix-1,Metropolis 0.3.0(MTR3+1.18.2)

功能说明

MTR Fare Pro 是 Minecraft Transit Railway(MTR)的附属模组。它在游戏内实现了更灵活、更真实的铁路计费系统。模组提供四种独立的计费模式,服务器管理员可通过配置文件根据需要自由切换。玩家进出站时,模组会自动计算并扣除相应车费。此外,模组还支持 Metropolis 的票务系统(仅 Minecraft 1.20.1)。

四种计费模式

1. ZONE

  • 原理:采用 MTR 原生的区间计费逻辑,不进行任何修改。
  • 计费规则:遵循 MTR 内置的区域划分,根据进出站所在区域确定票价。
  • 特点:与原版 MTR 机制完全一致,无额外计算开销。适合线性地铁网络以及希望保留 MTR 默认计费体验的玩家。

2. DISTANCE

  • 原理:根据进出站之间的地理直线距离计算票价。
  • 计费规则:读取各车站的中心坐标,计算两站之间的三维欧几里得距离。票价按 距离(km) × 单位票价 计算,最低票价为 1 个货币单位。
  • 公式:fare = max(1, round(√((x₂-x₁)² + (y₂-y₁)² + (z₂-z₁)²) / 1000 × unit_fare))
  • 特点:计算简单,不依赖轨道网络。即使两站之间没有轨道连接,也能生成票价。但直线距离可能与实际乘车路线长度存在偏差。

3. PATH【默认模式】

  • 原理:基于铁路网络中最短的物理乘车路径计算票价。
  • 计费规则:服务器使用所有轨道和车站构建加权图(边权为相邻站之间的直线距离)。通过 Dijkstra 算法计算任意两站之间的最短路径距离,然后按 路径距离(km) × 单位票价 计算票价。
  • 公式:fare = max(1, round(最短路径距离(km) × unit_fare))
  • 特点:无需手动设置收费区,即可提供最真实的计费体验,反映玩家实际乘车的路径长度。路径数据会缓存到本地文件并通过网络同步,避免重复计算。针对大型非线性地铁网络进行了优化。若两站之间没有轨道连接,则改用 DISTANCE 模式的票价。

4. PATHAREA

  • 原理:结合最短乘车路径与区域划分的混合计费方式。
  • 计费规则:沿最短路线遍历经过的每个车站,累加相邻站之间区域编号(zone)的差值绝对值,然后乘以单位票价。
  • 公式:fare = max(1, Σ|zone(i+1) - zone(i)| × unit_fare)
  • 特点:总票价随行程中累计的区域差值增加而上升。适合为单个轨道区段自定义定价,兼顾真实乘车路线与个性化票价设置。若两站之间没有轨道连接,则改用 DISTANCE 模式的票价。

配置文件

配置文件路径:config/mtr-fare-pro.json

默认内容:

{
  "fare_mode": "PATH",
  "unit_fare": 1
}
字段 说明 可选值
fare_mode 计费模式 ZONE、DISTANCE、PATH、PATHAREA
unit_fare 基础票价费率(元/km 或元/段) ≥ 0

网络同步

服务器会自动将配置、车站坐标和路径图数据同步给所有已连接的客户端,无需客户端单独配置。在多人服务器中游玩时,所有游戏内计费规则以服务器的配置为准。

其他特性

  • 路径缓存:计算结果自动保存到 config/MTR-Fare-Pro-path-cache.json,避免服务器重启后重新计算。修改收费区或车站布局后,请运行 /mtrfare reload 命令刷新票价。
  • 车站坐标自动获取:车站中心坐标直接从 MTR 的 Simulator 或 MinecraftClientData 中提取,无需手动配置。
  • 闸机兼容:通过闸机时自动记录入口站数据,出站时实现准确计费。
  • MTR 票务系统兼容:通过 Mixin 注入挂接到 MTR 的 TicketSystem,在出站时覆盖原生计费逻辑。对于 Minecraft 1.20.1,本模组也与 Metropolis 票务系统完全兼容。