[AI制作][MTR 4.0.5+ 1.20.1 Fabric]MTR仿12306线上国铁购票模组 mtr12306 beta 1.0.0

9 w0 A* \6 s2 O8 O% ^1 g$ q% L8 ]" T
注：本模组由Deepseek V4.1 Flash 1017编写，各位大佬们测试出bug请反馈喵，我会及时修正压力AI的喵
: w1 ^$ g1 D& ~5 M0 j. x3 y下面是模组简介和下载链接：
* t. p% _1 ~  X( N
适用版本：Minecraft 1.20.1 / Fabric，需要 MTR 4.0.5 或更高（强制前置）
当前版本：b1.0.0-hotfix1（Beta 1）
7 z, o/ r6 V# I6 a1 e* k开源协议：MIT
源码仓库：https://github.com/LangriSunnyawa/mtr12306
) v8 D  r1 H. F5 J. I3 j* @下载地址：https://github.com/LangriSunnyawa/mtr12306/releases/tag/b1.0.0
════════════════════════════════════════
一、这是什么
════════════════════════════════════════
一个建立在 MTR（Minecraft Transit Railway）之上的网页式铁路客票系统。
玩家在浏览器里像逛 12306 一样查车次、选坐席、挑座位、付钱出票；
服务器里摆放检票闸机，闸机只放行「本站正在检票车次」的持票旅客 —— 有票抬杆放行并显示乘坐区间，无票原地拦下并说明原因。
换句话说：MTR 负责把车开起来，这个模组负责让人「买票 — 检票 — 上车 — 出站」这一整套客运流程跑起来。
【图 1：网页购票页截图】
4 m9 W& D( U3 ^/ }1 V) W' X【图 2：闸机检票通过时的标题栏「乘坐区间」提示】
  b8 h1 H0 I# ]2 V# \+ y) v5 B════════════════════════════════════════
二、功能一览
$ o* B* d* Z9 |2 ]$ R+ @: W════════════════════════════════════════
■ 网页购票（12306 风格）
4 u' [, D/ ]9 @9 Y* P& M- q· 选出发站 / 到达站 / 日期 → 查询车次 → 选择坐席（直接显示票价与余票）→ 选车厢 → 在座位图上点座位（可留空自动分配）→ 扣款出票
) ~9 v" F( i2 f" W· 我的车票 / 退票：未检票且未发车可退票，票款原路退回
· 检票动态：今日发车与「检票中 / 已强制停检」状态，10 秒自动刷新
· 出票包含：票号、车次、乘车日期、区间、坐席、座位号、检票口、票价
■ 坐席 / 车厢 / 餐车
$ e( u4 D9 {# [1 ?1 E3 v" s  q· 支持二等座、一等座、商务座、城际（自由席）、无座
· 城际为不对号入座：出票不分配座位号，票面显示「XX车 自由席」，按定员限量
3 m* ^7 k) ?; w, a* H! U: i! M· 餐车可以单独标注：在任意坐席里填「餐车车厢号」，餐车会出现在座位图中但不可选座、不参与排座
· 每节车厢可设置排数与座位排列（如 A B C|D F，竖线为过道），座位号按「排 + 列字母」生成，例如 12F
1 m$ k( `/ @6 I& M■ 票价：统一 0.1 元/公里
· 停靠站填写累计里程，票价 = 里程差 × 0.1 元/公里 × 坐席倍率（farePerKm 可改）
· 扣费直接走 MTR 自带的 fares 钱包（计分板 mtr_balance），与 MTR 售票机、票价闸机共用同一余额
· 余额不足直接拒票并提示差额；退票自动退款；管理员可用 /mtr12306 balance <玩家> <金额> 充值
■ 车次：批量开行 + 在线修改
' N1 ]. C7 w4 I3 F: p· 批量开行：填号段（前缀 + 起止号 + 步长 + 位数）、停站模板（区间运行分钟 / 停站分钟 / 区间里程）、车底与坐席、首班时刻 + 发车间隔，一次生成整批车次并自动推算时刻表与累计里程
& }+ |7 K) O" N# F* {( k# P$ \  {　例：G1101~G1105，06:00 首发、间隔 20 分钟，自动得到 06:00 / 06:20 / 06:40 …
· 车次列表点「修改」即可载入既有配置，改完保存覆盖；支持「每天开行」或指定日期、跨日车次（天偏移字段）
8 @, [$ |0 l' G3 K■ 检票闸机（模型沿用 MTR）
· 模型几何直接沿用 MTR 的 ticket barrier（MIT 许可），只重做了贴图，可以和 MTR 自带闸机混排
: z6 |$ R% ~+ Q6 Z  A2 X· 四种闸机，放在独立创造物品栏「MTR-12306 检票闸机」里：
: j# \  f  \# ]% A9 ?　进站闸机：校验车票 → 绿箭头放行并核销车票；无票红箭头推回并提示原因
: C9 W6 E" Q" d, u/ d　出站闸机：只放行从站台侧走出，并记录车票「已出闸」
　双向闸机：进站查票；出站要求「今日已有已检票车票」
　换乘闸机：一次通过同时完成「上一段出闸」+「接续车次检票」，两段区间分别显示
0 k) u  l2 I0 ^4 j· 配置面板物品：拿「闸机配置面板」右键闸机（需 OP）才会打开配置菜单，可设置所属检票口与通行模式
· 检票口限定在闸机所在 MTR 车站：模组会读 MTR 的车站区域，配置菜单只列出该车站的检票口；不在任何车站内时列表为空并提示
■ 后台与账号
· 管理后台（/admin）：车站（一键导入全部 MTR 车站）、检票口、车次 / 坐席 / 车厢、闸机绑定、检票控制（手动开检 / 强制停检）、检票校验、票价钱包、车票总览
: W9 @/ G- y5 |· 网页注册：昵称 + Minecraft 名称 + 密码注册（加盐多轮哈希），之后用昵称 + 密码登录；车票会记录下单账号；也保留「游戏内 /ticket login 取验证码」登录方式
════════════════════════════════════════
6 c  q5 S2 ]4 [4 |2 _& O三、运行环境
════════════════════════════════════════
· Minecraft：1.20.1
· 模组加载器：Fabric Loader ≥ 0.15
· 依赖：Fabric API、MTR 4.0.5 或更高（必需）
& W) Z# H; F/ _" S4 D+ @8 z· Java：17
· 安装位置：客户端 + 服务端都要装（闸机是方块，含模型、贴图与配置界面）
════════════════════════════════════════
四、安装与开服
════════════════════════════════════════
" Y# ?7 _" A" z: N1. 把 mtr12306-b1.0.0-hotfix1.jar 放进客户端与服务端的 mods 文件夹；
% ^- X; a" s6 G8 u3 s/ T, k2. 装好 fabric-api 与 MTR 4.0.5+；
$ }1 u- |+ a+ Z2 l" A; t$ [( e3. 启动服务器，会自动生成 config/mtr12306.json；
4. 看启动日志，会打印网页地址：
5 A: [2 b( _( I6 O8 S( H4 w: H　[MTR-12306] 网页购票系统已启动：http://localhost:8123/
1 d9 T1 Y8 y  n; y1 j/ t5 c* h　[MTR-12306] 局域网访问地址：http://192.168.x.x:8123/
/ o5 u0 H) w* g$ }: S9 A8 u5. 浏览器打开 http://服务器IP:8123/ 购票，/admin 进管理后台（默认密码 mtr12306，请务必修改）。
! a7 F0 @# Q3 e# h+ c$ u; {: ?! \* P常用配置（config/mtr12306.json）：
　{
　　"webPort": 8123,
9 j4 ?  ^0 b" d( b　　"adminPassword": "改成你自己的密码",
　　"timezone": "Asia/Shanghai",
　　"farePerKm": 0.1,
　　"boardingOpenMinutes": 15,
　　"lateGraceMinutes": 2,
　　"transferWindowMinutes": 30,
+ ?( x' l4 i! @2 |+ d　　"requirePayment": true,
4 m! h) q8 K* @# i2 ]" _　　"requirePlayerAuth": true
　}
. E9 r1 Y, i, k; w& Q- Y════════════════════════════════════════
五、五分钟上手
" Z0 t4 m* J, ^3 u& ~1 A════════════════════════════════════════
1. 在 MTR 里划好车站（车站工具 / MTR 面板），记下车站名；
2. 后台「车站管理」→ 一键导入全部 MTR 车站（保持同名，闸机才能绑到该站的检票口）；
3. 「检票口管理」→ 新建 A1（可指定负责站台，留空 = 全部）；
: r: f1 [  u. {1 k% }4. 「车次管理」→ 填车次号、停靠站（站台 / 到达 / 发车 / 天偏移 / 累计里程）、坐席与车厢（含餐车、城际自由席）→ 保存；
2 U6 L! R0 v9 k+ V# t! H　 或者用「批量开行」按号段一次生成一整批；
* o4 D- H, m3 h0 c7 h# y; `$ I/ ]5. 游戏内 /give @s mtr12306:ticket_gate_entry（或从创造物品栏取），在站厅摆一排，放置时面向站台一侧；
9 Z  [2 a' S- i- G/ }6. 拿「闸机配置面板」右键闸机 → 选检票口 + 模式 → 保存；
  H0 X" F* O" H) V+ f7. 玩家网页注册 / 登录 → 买票 → 到检票时间走过闸机 → 抬杆 + 屏幕显示「乘坐区间」；
- b8 _* q) A9 ~% N" \7 p8. 管理员可用 /mtr12306 boarding open <车次> <车站ID> 15 立即开检 15 分钟演示。
8 j/ O( n5 g/ {: P( \1 h【图 3：管理后台车次 / 坐席配置】
【图 4：座位图选座】
════════════════════════════════════════
六、命令速查
════════════════════════════════════════
管理员（权限等级 2）：
　/mtr12306 help
　/mtr12306 web start|stop|info
　/mtr12306 station add <名称> [站台…] | list | remove <id>
　/mtr12306 checkpoint add <车站id> <检票口名> [站台…] | list | remove <id>
7 B) Z6 }/ p. I4 [4 _' y! [. s　/mtr12306 service list | remove <车次>
　/mtr12306 gate bind <检票口id> [ENTRY|EXIT|BOTH|TRANSFER] | unbind | info
　/mtr12306 boarding list | open <车次> <车站id> [分钟] | close <车次> <车站id>
　/mtr12306 ticket buy <玩家> <车次> <出发站id> <到达站id> [坐席码]
  K3 l0 T3 P2 \$ R7 ]; p　/mtr12306 ticket list
　/mtr12306 balance <玩家> [充值金额]
" H* @8 a: Z) T( {- R( M3 R　/mtr12306 login <玩家>　　（为其签发网页登录验证码，控制台可用）
% f) s- n: n. J$ {1 d: i6 p; t所有玩家：
　/ticket　　　　我的车票与余额
　/ticket list　　　同上
　/ticket login　　获取网页登录验证码
════════════════════════════════════════
% s1 o+ h6 q1 F/ J# @七、已知限制 / 注意事项
2 R8 {8 r$ T2 N6 ^════════════════════════════════════════
, _" x% z. H* e# O" G· 闸机没有「栏杆」：MTR 的闸机模型本身只有机柜，所以拦截是靠推回实现（和 MTR 一致）。介意的话可以在闸机间加玻璃板做视觉隔断。
# F! W0 @! e+ w* [4 t· 闸机必须在 MTR 车站范围内才能选检票口；本系统车站要与 MTR 车站同名（用「一键导入」最省事）。
· 后台「闸机管理」的下拉框是管理员通道，允许跨站改绑；玩家侧 / 游戏内配置严格按车站过滤。
· 网页默认监听 0.0.0.0:8123 且是 HTTP 明文：公网部署请改端口 / 防火墙，或套一层 TLS 反向代理，并一定修改默认管理密码。
· 换乘闸机依赖两个条件：①上一段车票已检票进站且未出闸；②本站有已购接续车票且在检票窗口或 transferWindowMinutes（默认 30 分钟）内。
; Q' r: }7 L( d9 ^; j4 L! S* X5 o════════════════════════════════════════
0 r; A. V! [) ^; X0 Y八、下载
════════════════════════════════════════
  O( w, i: o( B6 V! V& r· Release（推荐）：https://github.com/LangriSunnyawa/mtr12306/releases/tag/b1.0.0-hotfix1
　　mtr12306-b1.0.0-hotfix1.jar（模组本体）
7 S$ l% N' C! s9 i2 p% i　　mtr12306-b1.0.0-hotfix1-sources.jar（源码包）
# Y  m, c  J* G· 源码仓库：https://github.com/LangriSunnyawa/mtr12306
　　自己构建：./gradlew build → build/libs/mtr12306-b1.0.0-hotfix1.jar
════════════════════════════════════════
九、致谢与协议
3 i. Y# q( ^: [════════════════════════════════════════
· 闸机模型几何来自 MTR（Minecraft Transit Railway）的 ticket_barrier，MTR 采用 MIT 许可；本模组仅复用其几何结构，贴图与全部代码为独立实现。
· 本模组以 MIT 协议发布，欢迎自行修改、二次分发；转载 / 整合包请保留出处与许可。
' Q9 @) O) Y) {1 s8 Z) L' a反馈与建议：b1.0.0-hotfix1 是首个 Beta，欢迎在本帖回复报 Bug（请附上 latest.log、MTR 版本、以及出现的问题喵）
0 }4 @7 J4 j8 e9 z, M, s/ k( Y

可以适配3.2.2吗？或者要米？

深圳地铁L5-0578 发表于 2026-11-11 18:19
: ]1 l: J& ]4 Q3 ^2 O+ U可以适配3.2.2吗？或者要米？

$ B* K' Y" S7 _0 m( K# H0 R% b1 U) T# y正式版绝对不会付费的，3.2.2的话我去压力AI（