MTRneedvilager beta0.4.1正式发布！

* i) T6 @4 \) \) s" IMTRNV（MTR需要乘客）是一款为了让4.0.5MTR的村民能够进入你（费劲巴拉）建造出来的绝美车站并且乘车而开发的模组，能够让你的城市活起来！详情请看Readme.md……
6 W2 N7 ]0 I) f
README.md：
* c, U* z( t- r- x; Y

8 F% K3 A: [+ \$ u  o# MTRneedVillager
### By [@呱瓜多米](https://space.bilibili.com/1434735329?spm_id_from=333.1007.0.0)
9 M8 J5 Y( |, n) Y% C* t
> 一个让村民真正「活」起来的 MTR 扩展模组 —— 村民会自主走进车站、通过闸机、乘坐列车。
! \  B& ]- {0 x! _. ]>
> By **[@呱瓜多米](https://space.bilibili.com/1434735329?spm_id_from=333.1007.0.0)** ｜ Minecraft 1.20.1 Fabric ｜ MTR 4.0.5+ ｜ 当前版本 **0.4.1beta**
9 A$ y, O$ c! L5 K. k* L) i
  P; u$ F' k. U' T---

## 宗旨
6 o0 W- Z# V8 J* s
在这个模组出现之前，MTR 的世界里，车站、列车、站台都只为**玩家**服务——__村民永远只是背景板里的木偶，再繁华的都市也没有一丝烟火气。__

**MTRneedVillager 想让轨道交通世界真正「活着」。**

2 A/ p2 x3 ^: E7 z  g, n, P! V我们追求：

/ s- |6 |- ^+ K: }' e9 u2 ]) U- **自然**：村民的行为完全自主，无人操控、无按钮、无界面，一切像生活本身一样发生。
- **严谨**：完整遵循 MTR 原版闸机机制与方向逻辑，入口进、出口出，不破坏原版平衡。
- **克制**：村民只是「偶尔」行动，不会整村蜂拥挤成一团，都市依然井然有序。
- **零配置**：安装即生效，与 MTR 车站 100% 兼容，无需任何设置。
( K, \. K- p; q
---
# N! L8 V" @* F5 y3 s( e, t8 x
3 r4 K+ e+ v! B( G8 h! n( e  M4 Q## 功能

### 🚶 村民自主进站、出站

- 村民会**偶尔**（平均约每 2 分钟随机触发一次）自主走向附近的车站闸机；
1 _# K" b1 K" R# l1 o# \% B- 站台外的村民走向**入口闸机** → **进站**；
- 站台内的村民走向**出口闸机** → **出站**；
- 完全符合现实交通逻辑：入口进、出口出。

6 ^* p! D" J# r### 🚇 闸机自动为村民开合
  [/ L" s2 e' s
4 o/ f; j9 e2 V  M2 k! k- H- 村民触碰关闭的闸机时，闸机自动打开；村民通过后立即关闭；
- 若村民在门口停留，闸机会在 2 秒后自动关闭，村民再次触碰会重新打开——绝不放村民被困；
3 H0 u  C4 r: ]2 K- 仅对**村民**生效，玩家过闸体验与 MTR 原版完全一致。
7 M% t3 K2 J' u" h$ H9 t: l' R7 o
### 💰 村民"无限绿宝石"余额系统

3 Y/ c. A, }8 D/ j- 每个村民加载时自动在计分板创建 `mtr_balance` 目标，余额设为最大值；
' o; i" l* F" j4 i$ r" I0 s- 为未来村民消费、购票等玩法预留接口（当前版本不影响游戏）。

### 🏙 让城市活起来

6 r$ o% e" {' b5 s" P0 M$ w/ |5 ]/ n- 无需任何操作，只要在城市里放好车站和闸机，村民就会自己开始"通勤"；
- 与 MTR 车站、站台、列车完全兼容，适配 MSD、JCM 等 MTR 扩展车站装饰。
: q5 p9 G1 E& H1 }" d
---
7 ]' J$ l: U4 A+ c; d1 c  ?
## 工作原理
( |0 N, j5 o) o7 {4 ?
```
$ Y! k7 n. i9 N$ `+ ~7 f, S4 V+ ?4 u7 NVillagerGoalAdder（村民加载时注册 AI）
        │
2 U' |2 @) J9 P6 X- U: {        ▼
) L& n& [9 q# ^RideTrainGoal（随机触发 + 扫描 24 格内闸机）
& T. }6 c& l% h" C; o0 D1 |  h: W        │  只选择"村民位于其入口侧（zMapped < 0）"的最近闸机
        ▼
村民以 0.5 速度走向闸机
# D) d( ?' y& D$ m: ?2 q* y        │
& A2 y- a( l. R$ v; X5 h! r        ▼
% C+ t( ^! {8 g" D1 Z. L0 FBlockTicketBarrierMixin（触碰闸机）
! h- g0 ^+ `8 g9 H2 H0 q& R& c        │  村民触碰关闭闸机 → 自动开门（40 tick 后自动关）
1 ^+ \9 J9 I, E8 b5 o3 m        │  村民越过闸机中心 → 立即关门
0 k- [8 `, H6 G/ @+ J        ▼
村民完成进出站 ✓
```
$ q, r5 D9 U1 w, S" ^
  _9 A; Z( q# @6 R+ V* _. N' n**关键设计**：

* B) |$ f% l' ~2 X3 n5 l2 A: h" b# L/ n0 X| 模块 | 作用 |
. K( C. |% R9 d  L! Y# v| --- | --- |
| `RideTrainGoal` | 村民过闸 AI：随机触发（约每 2 分钟）、400 tick 冷却、24 格搜索半径、入口侧定向 |
| `BlockTicketBarrierMixin` | 闸机对村民的自动开合，穿过即关，不干扰玩家 |
| `MobEntityGoalAccessor` | 通过 Accessor 安全访问村民的 `goalSelector`，无需修改村民 AI 核心 |
| `MTRVillagerHelper` | 计分板余额初始化，为后续玩法铺路 |

( R' f$ n; D' k0 h4 m4 B---

7 B! F5 L$ c2 z; _: o. L' {6 e## 安装

/ J* [* i+ b/ }6 M1. 下载1.20.1Fabric版本
2. 将 **MTRneedVillager-0.4.1beta.jar** 放入 `mods` 文件夹（同时安装 Fabric API 与 [MTR 4.0.5+（4.1.x以下）](https://www.modrinth.com/mod/minecraft-transit-railway)）；
4 |% b# [% ^4 L3. 启动游戏，进入世界即可生效——**无需任何其它配置**；
# q8 O0 W. j. Y1 M/ B1 D4 }, y. R4. *关注我*我就会给你这个模组。

### 依赖
* d! h6 a, P9 }6 z$ B
/ S1 B; h' t4 `' E  k| 项目 | 版本要求 |
0 s# |$ R$ S7 ]  v+ X6 v| --- | --- |
| Minecraft | 1.20.1 |
| Fabric Loader | >= 0.14.0 |
: s. T" C, c  \* S| Fabric API | 任意 1.20.1 版本 |
| MTR（minecraft-transit-railway） | >= 4.0.5  ; <4.1.0（modid: `mtr`） |
| Java | >= 17 |
# h- D7 |3 S; r, a' @7 C  O# i+ \
# t$ Q4 {7 Q8 s+ P6 l; f( }! s> ⚠️ 注意：MTR 4.x 的 mod id 为 `mtr`，若你的游戏提示依赖不兼容，请确认安装的是 MTR 4.0.5 版本。

---

: r# T8 @  j9 r5 p, B7 h$ P## 如何体验
- I3 y8 @/ O6 H7 U. H' ]
: t3 \% ]# m/ P8 o. G1. 用 MTR 建造一个带**入口闸机**和**出口闸机**的车站（闸机朝向相反摆放）；
& l) A* p0 b% m$ m. C2. 在车站附近放置几只村民；
  |& c/ P5 t: K6 p& N0 |# c, v- ^3. 等待几分钟——村民就会开始"通勤"：从入口进站、穿过站厅、从出口出站。

**效果提示**：夜晚 + 灯光 + 站台列车，观察村民过闸的瞬间最有电影感 🎬

---
' |( r2 a: g2 N' D
## 已知说明
2 @; r. G; g! b/ p& _# S3 G
  I" H6 D9 Y& @- 村民仅在**入口侧**触发过闸，出口侧村民不会反向强穿（遵循 MTR 单向闸机设计）；
- q1 z1 H; H1 c- 村民过闸全程为自然寻路，若闸机与地形复杂，村民可能绕行或偶尔放弃（会重新随机触发）；
- 本模组为 **beta** 版本，可能存在未知问题，请提前备份存档。

  ]. B8 j- L% ?$ T---
. \" b3 e. r+ L+ o
5 R! z) @, U' I7 p) |, e, G+ ^: e## 版本记录

9 b' D5 S% M: _/ q( ~  S: _1 _; T9 w| 版本 | 说明 |
& R+ b" K* V0 @9 L  O" o| --- | --- |
| 0.4.1beta | 村民自主进出站（入口进、出口出）；闸机自动开合；余额系统初始化；重新命名 MTRneedVillager |

---

& G% W* j) t) E) Z. l" h5 q# Z## 特别鸣谢
  R7 q3 M# A4 I( v/ [9 _
1 m" g4 Q3 X$ S- [Minecraft Transit Railway (MTR)](https://github.com/jonafanho/Minecraft-Transit-Railway) —— 轨道交通梦的基石
- O. A  i8 E0 @' f; m; P3 D- ~~有 Deepseek 的亿点点帮助（zhende~~
- **OpenCode** 没有它，这个模组将永远停留在开发阶段
( \9 M+ i& r& W' v+ Z
& Q/ b+ H- Q+ N0 P> 我是 Bilibili UP 主 **@呱瓜多米**，一个很小的 UP，但我想让天河变得更加美好。
. G4 Y* D/ a2 L- g% `+ S> **如果这个模组让你开心，~请给我一个赞和硬币~，谢谢！** ❤️
0 M$ J6 H0 N6 j4 P" T" T' U/ L
## License

请遵守**MIT License** 请在经过原作者允许情况下学习、二次开发与整合。
9 v% o% a1 I0 ?. P& N: I3 U; E  Z8 }
* w; u' Y! [5 {: Y3 z' r$ S/ J/ u下载请前往Q群[color=rgba(255, 255, 255, 0.6)]1102973914
, R4 P: r4 p5 [6 f+ Z2 h# h3 u% ]

% P4 \. y# B4 T) l

虽然但是，你这个宣传页面看着有点太费劲了

太厉害了，实现了无数人多年来的夙愿

能不能教教我你是怎么用DeepSeek做模组的（比如如何在idea中接入DeepSeek API、如何撰写提示词等）

Lamian 发表于 2026-8-21 22:01
9 s. J8 Y( Z7 D) C/ S( a* v1 y- j) p0 t能不能教教我你是怎么用DeepSeek做模组的（比如如何在idea中接入DeepSeek API、如何撰写提示词等） ...

安装CodeX或者Claude Code等，在IDEA开启MCP服务，然后在CodeX、Claude Code客户端上交给ai你的MCP服务地址，让它自己配置就行了

或者用AI插件，我喜欢Github Copilot，它的代码补全很强，但是免费额度有限，你可以在IDEA的插件市场找到它

596wjr 发表于 2026-8-21 19:42
虽然但是，你这个宣传页面看着有点太费劲了

- e& a8 S4 g# `2 kREADME.md
  A9 x) A" m1 k& x, c感觉像是AI写的，应该是直接从Github上面复制的？