大篷车队

商队 (Caravans)

商队为你的地图添加了移动的、有防御的袭击目标。每隔一段时间，一辆马拉的商人货车会在一队武装护卫的伴随下出发穿越世界。它沿着真实路线行进，会进行反击，如果你成功将其击倒，它会掉落一箱货物，其价值在打开之前你无法知晓。

专为 Minecraft 1.20.1 (Forge) 构建，面向中世纪和角色扮演服务器，商队袭击为玩家提供了离开基地的理由，以及在路上为争夺货物而相互战斗的理由。

---

袭击过程如何进行

1. 服务器会随机生成一个间隔时间——默认设置下大约为一小时——然后一支商队出发。
2. 每位玩家都会收到聊天公告，如果服务器允许，还会包含出发坐标。
3. 货车以满载马车的速度沿着路线行进，两匹挽马套在车辕上，两到四名士兵在旁行进。
4. 你发动攻击。所有护卫会立即转向你——攻击货车、护卫，甚至攻击其中一匹马都足以触发。
5. 击溃护卫并摧毁货车。一个箱子会掉落在原地，其货物分为 劣质、普通 或 完美 三个等级。
6. 如果不去管它，商队将到达目的地并消失。货物也随之消失。

---

货车

• 一个自定义的有篷马车模型，大约 2.4 格宽，3 格高，前方有车辕，并且 有四个在行进时会转动的轮子。
• 使用地面寻路功能沿着真实的路径点路线行进，带有卡住检测功能，因此被地形卡住的马车可以自行调整方向，而不是永远静止不动。
• 坚固但并非无敌：生命值、护甲和速度均可配置（默认为 150 点生命值）。
• 两匹挽马被固定在车轭上。它们本身不会受到伤害——攻击马匹等同于攻击马车，因此你无法通过干掉动物来使商队瘫痪。

护卫

护卫并非装饰。他们通过实体 ID 进行配置，因此你可以使用你的整合包中已有的任何士兵实体来护送商队。

• 他们会共同反击。 对货车、护卫或马匹造成伤害，攻击者会立即被标记给商队中的每一位护卫。
• 他们紧跟货物。 护卫只会在货车周围的半径范围内（默认 24 格）战斗。如果你跑得足够远，他们会放弃追击并返回——你不能引开护卫后再折返来免费夺取货车。
• 无友军伤害。 同一商队的成员无法互相伤害，因此近战中的流矢永远不会使护卫自相残杀。
• 定期召回。 每三分钟，任何偏离过远的护卫都会被传送回货车身边，因此地形永远不会困住一支护卫队。
• 全副武装。 护卫会穿着全套钻石盔甲并携带口粮生成。默认情况下盔甲不会掉落——每支商队掉落几套钻石装备会比货物本身更有价值——但这只需修改一行配置即可改变。
• 默认情况下，他们 不会 对玩家主动敌对。他们是护卫，不是强盗。如果你想让他们敌对，有一个配置开关可以设置。

士兵 (Recruits) 支持（可选）

商队模组开箱即用地支持 Recruits 模组，并且默认的护卫列表使用 Recruits 士兵：recruit、recruit_shieldman、bowman 和 crossbowman。

没有硬性依赖。护卫实体在运行时从注册表 ID 中查找，因此商队模组可以独立安装和运行——如果 ID 不存在，它只会回退到配置的原始实体。想用其他完全不同的东西护送商队？将其 ID 放入配置中即可。不确定 ID 是什么？在游戏内运行 /caravan probe <modid>，模组会打印出该模组注册的每个实体。

---

货物

当货车被摧毁时，一个装有未确定战利品表的箱子会放置在残骸处——内容物会在玩家打开箱子的那一刻生成，因此战斗结束前没人能偷看。

等级	默认概率	大致内容
劣质	55%	面包、小麦、煤炭、皮革、铁粒、少量绿宝石
普通	35%	铁和金、绿宝石堆、盔甲部件、鞍、贸易品、有机会获得附魔书
完美	10%	钻石、绿宝石块和金块、附魔钻石装备、马铠、下界合金、宝藏附魔

所有三个等级都是普通的数据包战利品表（caravans:chests/wagon_poor、wagon_average、wagon_perfect）。将具有相同路径的文件放入你的世界的数据包文件夹中，你就重写了整个货物经济，而无需改动模组本身。概率本身是配置文件中的权重。

---

亲自规划道路

如果不做任何干预，模组会在你的玩家附近的开放地形中生成一条弯曲的路线。但是，如果你已经修建了道路，你可能希望商队使用它们。

商队魔杖 让你可以沿着你的道路行走并手动铺设路线：

操作	结果
右键点击一个方块	添加下一个路径点
潜行 + 右键点击一个方块	移除最后一个路径点
右键点击空气	列出当前草稿
潜行 + 右键点击空气	清除草稿

然后使用 /caravan route save <name>。已保存的路线存放在世界存档中，并在重启后依然存在。你可以随意设置路径点之间的距离——模组会重新采样线路并将其贴合到地面，然后马车才会使用它，这可以防止原版寻路在遇到四百格外的路径点时放弃。

/caravan route show <name> 会以粒子的形式绘制出完整的路径，这样你就可以亲自走一遍并检查你的成果。

---

命令

所有命令都需要权限等级 2（管理员）。

命令	作用
/caravan wand	给你一根商队魔杖
/caravan route save <name>	将魔杖的草稿保存为命名路线
/caravan route list	列出已保存的路线
/caravan route info <name>	打印某条路线的所有路径点
/caravan route show <name>	以粒子效果绘制路线
/caravan route delete <name>	删除一条路线
/caravan spawn [route]	立即派出一支商队
/caravan list	显示当前在路上的商队
/caravan stop	移除所有活跃的商队
/caravan next	距离下次出发的剩余时间
/caravan next now	立即触发下一次出发
/caravan probe <modid>	列出某个模组注册的每个实体 ID

---

配置

所有内容都位于 config/caravans-common.toml 中，并进行了分组和注释。你可以更改的部分内容：

• 生成 —— 间隔范围、同时在路上的商队数量、它们出现在距离玩家多远的地方、使用哪些维度。
• 路线 —— 优先使用已保存的路线还是始终生成、生成路线的长度、路径点间距、到达容差。
• 马车 —— 生命值、护甲、速度、存活时间、是否生成挽畜以及使用哪种实体。
• 护卫 —— 实体 ID 池和回退实体、生成数量、跟随和牵绳距离、召回间隔、友军伤害、主动敌对、清理延迟。
• 护卫装备 —— 每个盔甲槽位的物品 ID、盔甲掉落几率、口粮物品和堆叠数量。
• 战利品 —— 每个货物等级的权重。
• 通知 —— 出发、到达和摧毁消息，以及是否显示出发坐标。

---

需求

• Minecraft 1.20.1
• Forge 47+
• 服务器和客户端都需要安装——该模组添加了自定义实体及其渲染器。
• Recruits 是可选的。安装它以获得士兵护卫；没有它，护卫将回退到配置的原始实体。

语言支持

包含英语和土耳其语。每一条消息、物品和实体名称都通过语言文件进行翻译，因此添加其他语言的翻译只需要一个资源包。

---

备注

• 货车是一个宽体型实体，需要两格宽、三格高的通道才能通过。茂密的森林和陡峭的地形会减慢商队的速度；开阔地带和已修建的道路视觉效果最佳。
• 永远无法到达目的地的商队会被自动清理，货车被摧毁后护卫也会在不久后移除，因此物品不会在长期运行的服务器上积累。
• 当默认设置更改时，Forge 不会重写现有的配置文件。更新后，要么删除 caravans-common.toml 以重新生成，要么手动检查更改的键——新添加的键会自动追加。