MTRneedvilager beta0.4.1正式发布！
本帖最后由 京局京段AD钙 于 2026-8-21 19:14 编辑MTRNV（MTR需要乘客）是一款为了让4.0.5MTR的村民能够进入你（费劲巴拉）建造出来的绝美车站并且乘车而开发的模组，能够让你的城市活起来！详情请看Readme.md……
README.md：
# MTRneedVillager
### By [@呱瓜多米](https://space.bilibili.com/1434735329?spm_id_from=333.1007.0.0)
> 一个让村民真正「活」起来的 MTR 扩展模组 —— 村民会自主走进车站、通过闸机、乘坐列车。
>
> 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**
---
## 宗旨
在这个模组出现之前，MTR 的世界里，车站、列车、站台都只为**玩家**服务——__村民永远只是背景板里的木偶，再繁华的都市也没有一丝烟火气。__
**MTRneedVillager 想让轨道交通世界真正「活着」。**
我们追求：
- **自然**：村民的行为完全自主，无人操控、无按钮、无界面，一切像生活本身一样发生。
- **严谨**：完整遵循 MTR 原版闸机机制与方向逻辑，入口进、出口出，不破坏原版平衡。
- **克制**：村民只是「偶尔」行动，不会整村蜂拥挤成一团，都市依然井然有序。
- **零配置**：安装即生效，与 MTR 车站 100% 兼容，无需任何设置。
---
## 功能
### 🚶 村民自主进站、出站
- 村民会**偶尔**（平均约每 2 分钟随机触发一次）自主走向附近的车站闸机；
- 站台外的村民走向**入口闸机** → **进站**；
- 站台内的村民走向**出口闸机** → **出站**；
- 完全符合现实交通逻辑：入口进、出口出。
### 🚇 闸机自动为村民开合
- 村民触碰关闭的闸机时，闸机自动打开；村民通过后立即关闭；
- 若村民在门口停留，闸机会在 2 秒后自动关闭，村民再次触碰会重新打开——绝不放村民被困；
- 仅对**村民**生效，玩家过闸体验与 MTR 原版完全一致。
### 💰 村民"无限绿宝石"余额系统
- 每个村民加载时自动在计分板创建 `mtr_balance` 目标，余额设为最大值；
- 为未来村民消费、购票等玩法预留接口（当前版本不影响游戏）。
### 🏙 让城市活起来
- 无需任何操作，只要在城市里放好车站和闸机，村民就会自己开始"通勤"；
- 与 MTR 车站、站台、列车完全兼容，适配 MSD、JCM 等 MTR 扩展车站装饰。
---
## 工作原理
```
VillagerGoalAdder（村民加载时注册 AI）
│
▼
RideTrainGoal（随机触发 + 扫描 24 格内闸机）
│只选择"村民位于其入口侧（zMapped < 0）"的最近闸机
▼
村民以 0.5 速度走向闸机
│
▼
BlockTicketBarrierMixin（触碰闸机）
│村民触碰关闭闸机 → 自动开门（40 tick 后自动关）
│村民越过闸机中心 → 立即关门
▼
村民完成进出站 ✓
```
**关键设计**：
| 模块 | 作用 |
| --- | --- |
| `RideTrainGoal` | 村民过闸 AI：随机触发（约每 2 分钟）、400 tick 冷却、24 格搜索半径、入口侧定向 |
| `BlockTicketBarrierMixin` | 闸机对村民的自动开合，穿过即关，不干扰玩家 |
| `MobEntityGoalAccessor` | 通过 Accessor 安全访问村民的 `goalSelector`，无需修改村民 AI 核心 |
| `MTRVillagerHelper` | 计分板余额初始化，为后续玩法铺路 |
---
## 安装
1. 下载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)）；
3. 启动游戏，进入世界即可生效——**无需任何其它配置**；
4. *关注我*我就会给你这个模组。
### 依赖
| 项目 | 版本要求 |
| --- | --- |
| Minecraft | 1.20.1 |
| Fabric Loader | >= 0.14.0 |
| Fabric API | 任意 1.20.1 版本 |
| MTR（minecraft-transit-railway） | >= 4.0.5; <4.1.0（modid: `mtr`） |
| Java | >= 17 |
> ⚠️ 注意：MTR 4.x 的 mod id 为 `mtr`，若你的游戏提示依赖不兼容，请确认安装的是 MTR 4.0.5 版本。
---
## 如何体验
1. 用 MTR 建造一个带**入口闸机**和**出口闸机**的车站（闸机朝向相反摆放）；
2. 在车站附近放置几只村民；
3. 等待几分钟——村民就会开始"通勤"：从入口进站、穿过站厅、从出口出站。
**效果提示**：夜晚 + 灯光 + 站台列车，观察村民过闸的瞬间最有电影感 🎬
---
## 已知说明
- 村民仅在**入口侧**触发过闸，出口侧村民不会反向强穿（遵循 MTR 单向闸机设计）；
- 村民过闸全程为自然寻路，若闸机与地形复杂，村民可能绕行或偶尔放弃（会重新随机触发）；
- 本模组为 **beta** 版本，可能存在未知问题，请提前备份存档。
---
## 版本记录
| 版本 | 说明 |
| --- | --- |
| 0.4.1beta | 村民自主进出站（入口进、出口出）；闸机自动开合；余额系统初始化；重新命名 MTRneedVillager |
---
## 特别鸣谢
- [Minecraft Transit Railway (MTR)](https://github.com/jonafanho/Minecraft-Transit-Railway) —— 轨道交通梦的基石
- ~~有 Deepseek 的亿点点帮助（zhende~~
- **OpenCode** 没有它，这个模组将永远停留在开发阶段
> 我是 Bilibili UP 主 **@呱瓜多米**，一个很小的 UP，但我想让天河变得更加美好。
> **如果这个模组让你开心，~请给我一个赞和硬币~，谢谢！** ❤️
## License
请遵守**MIT License** 请在经过原作者允许情况下学习、二次开发与整合。
下载请前往Q群1102973914
虽然但是，你这个宣传页面看着有点太费劲了 太厉害了，实现了无数人多年来的夙愿 能不能教教我你是怎么用DeepSeek做模组的（比如如何在idea中接入DeepSeek API、如何撰写提示词等） Lamian 发表于 2026-8-21 22:01
能不能教教我你是怎么用DeepSeek做模组的（比如如何在idea中接入DeepSeek API、如何撰写提示词等） ...
安装CodeX或者Claude Code等，在IDEA开启MCP服务，然后在CodeX、Claude Code客户端上交给ai你的MCP服务地址，让它自己配置就行了
或者用AI插件，我喜欢Github Copilot，它的代码补全很强，但是免费额度有限，你可以在IDEA的插件市场找到它 596wjr 发表于 2026-8-21 19:42
虽然但是，你这个宣传页面看着有点太费劲了
README.md
感觉像是AI写的，应该是直接从Github上面复制的？ 想不到吧，我在MTRBBS也有账号 596wjr 发表于 2026-8-21 19:42
虽然但是，你这个宣传页面看着有点太费劲了
复制的md，没看直接发了，所以我现在自己都看不清┭┮﹏┭┮ 鹤城uttyut 发表于 2026-8-22 09:25
想不到吧，我在MTRBBS也有账号
哦no被发现了 mrt114514 发表于 2026-8-21 22:09
README.md
感觉像是AI写的，应该是直接从Github上面复制的？
md是我自己和ai写的{:3_41:} Lamian 发表于 2026-8-21 22:00
太厉害了，实现了无数人多年来的夙愿
谢谢夸奖^_^ Lamian 发表于 2026-8-21 22:01
能不能教教我你是怎么用DeepSeek做模组的（比如如何在idea中接入DeepSeek API、如何撰写提示词等） ...
我用的openCode，有免费的deepseek v4，但我也会用自己买的api导入，用起来挺简单的（我是不是在打免费的广告） 京局京段AD钙 发表于 2026-8-22 09:56
我用的openCode，有免费的deepseek v4，但我也会用自己买的api导入，用起来挺简单的（我是不是在打免费的 ...
DS涨价了，这个月贡献了¥95.17
这个宣传页看着确实有点费眼睛 没想到作者真的做出来了！但是我的一些车站站台还没有修怎么办
页:
[1]