MineColonies Unofficial Fabric

MineColonies Fabric — 面向 Minecraft 26.x 的 MineColonies 非官方 Fabric 移植版

MineColonies 终于登陆 Fabric。 在 Fabric 加载器上游玩 MineColonies 殖民地模拟与城镇建设模组：建立殖民地、雇用 NPC 工人，将营地发展成城市——建造工、农民、矿工、守卫、信使和厨师，蓝图式建造、袭击、包含 200 多个节点的研究树，以及任务。它以单个 JAR 文件运行于 Minecraft 26.x 和 Fabric。

这是由社区移植的 LDTTeam 殖民地模拟模组 ，并加入了一系列本项目独有的功能和错误修复——能驾驶小船的居民、三种可精确到方块划定殖民地边界的领地法杖、可正常运作的前哨站、会自行整地的农民，以及对模组中存在多年的多个错误所做的修复。

页面底部列出了运行要求、安装方法和其他技术细节。

⚠️ MineColonies 非官方移植版——请先阅读

这是 MineColonies 的非官方社区 Fabric 移植版。MineColonies 本身由LDTTeam (Let’s Dev Together)开发；本移植版与他们无关，未经他们认可，也不受他们支持。

• 请勿将此版本的问题报告发送给 LDTTeam。请使用本项目的问题追踪器。
• 如果官方 NeoForge 版本也出现同样的问题，则应向上游项目报告。
• 此 JAR 不包含 MineColonies 的纹理、模型或音效。首次启动时，模组会从原作者自己的服务器下载原始资源并进行校验——详见下方“安装方法”。

原版模组：CurseForge · minecolonies.com

🧱 MineColonies 是什么？殖民地模拟与城镇建设模组

MineColonies 是一款 Minecraft殖民地模拟／城镇建设模组。你放置一座市政厅，之后的事情便交由居住在城镇中的 NPC 居民完成：

• 数十种 NPC 职业——建造工、农民、矿工、伐木工、渔民、守卫、弓箭手、信使、厨师、面包师、铁匠、治疗师、教师、养蜂人、花匠等等；每种职业都有可提升等级的技能。
• 蓝图建造——小屋先以预览形式放置，再由建造工逐块建成；你还可以选择多种完整的建筑风格。
• 殖民地经济——包含需求、配送、仓库、最低库存和制作链。
• 研究——由四个分支组成、拥有 200 多个节点的研究树，可解锁小屋、工人能力和全殖民地加成。
• 袭击与防御——野蛮人、海盗、埃及人和诺斯人会来袭击你的城镇；守卫、瞭望塔和城墙则负责守护家园。
• 任务、幸福度、疾病、教育，以及支撑这一切的完整模拟系统。

支持单人或多人游戏。客户端和专用服务器都必须安装此模组。

✨ 此 Fabric 移植版新增功能

以下内容均为相较于上游 MineColonies 新增的功能，仅在此版本中提供。

🛶 居民乘船出行

现在，你的居民可以乘船渡水，不必绕过湖泊——也不会再直接拒绝前往。

• 一个全新的殖民地船只实体，已接入模组的寻路系统：水域现在会被计入居民实际可走的路线，路径也会穿过水面规划。
• 居民会自行从岸边上船、驾驶并在对岸上岸。中断路径、让它改去别处，或在过河途中拿走船只，它都会妥善脱身，不会漂向湖心。
• 需先研究专属科技——Boats，与Rails并列，研究需要消耗船只，并要求有一名三级渔夫；毕竟只有渔夫的建筑才用得上船。守卫在战斗中会放下船只，避免有人乘船冲进战斗。
• 无人乘坐的船会被移除，而且只有船只指定的居民才能上船——海岸线上不会再堆满被遗弃的船。

实测于运行中的服务器：一条 800 格的水上路线可在 7–11 毫秒内生成完整路径；同一路线若步行或游泳，则完全无法生成路径。有了船，海岸和岛屿殖民地的通勤终于能正常运作，不再只是“工人站在那儿”。

🗺️ 三种领地权杖，殖民地边界终于能随心绘制

• 领地权杖——右键占领一个区块及其周围八个区块。没有距离限制，领地可以随心扩展，也可以分成任意多个区域。
• 领地释放权杖——补上模组一直缺少的功能：归还土地。每次点击释放一个区块，潜行时释放九个，正好撤销一次占领操作。
• 边界权杖——在区块内部逐格绘制边界。点击添加一列方块，潜行点击移除一列，按住即可连续绘制。可以沿河流、墙壁或悬崖勾勒边界，不必受区块网格限制。

绘制的边界确实生效，而非装饰：领地保护、居民认定某处是否为家、袭击生成点，以及建造工具的预览都会遵循你绘制的线条。手持任意一种权杖时，三种权杖都会绘制殖民地边界，并随着编辑实时更新；占领或释放土地不再需要靠猜。

🏘️ 真正实用的前哨站与飞地

上游版本总是不让殖民地离市政厅太远——建造占地、区块加载和床位分配全都按与中心的距离判定。现在这三者都会先确认这片土地归谁所有：

• 建在你领地上的小屋，无论距离多远，都会占领自身占地（新增maxoutlyingchunks配置项）。
• 前哨站会自行保持区块加载（新增maxforcedchunks配置项）。
• 居民会被分配到工作地点附近的床位，而不是市政厅附近的床位——此外还加入/mc colony rehouse，可将已经住错地方的居民迁走。

采矿前哨站、海岸码头和卫星农场，现在都成了可行的玩法，不再是需要提交的问题报告。

🌾 能自行整理土地的农夫

• 农夫会改造地形。若田地格子因地上的东西——石头、沙砾、沙子、小路或别人的地板——而无法耕种，农夫不再默默跳过。它会在同一轮工作中清理障碍、铺上泥土并翻耕。水是唯一无法处理的例外。
• 它会在聊天栏告诉你清理了什么，并显示总数和各类方块的明细；这样，在基地一角画出一块田地，你会先看到提示，而不是之后才发现。
• 田地标记棒——点击稻草人，再用两次点击拖出矩形，并当场将它绑定到指定农场。无需打开小屋界面，也不用猜哪个农场认领了哪块田。
• 自由模式下可绘制任意形状的田地：限制依据总面积（默认 4096 格，可由服务器配置），不再采用上游版本“半径总和 ≤ 20”的规则——那会把所有田地限制在 11×11 格以内。现在也能沿河绘制 4×1000 格的长条田地。

🐴 马厩，以及真正骑马作战的骑兵守卫

上游自带一个任何风格都无法建造、任何玩家都无法解锁的稳定马厩和骑乘守卫。两者在这里都能正常工作。

• 马厩存在于全部 23 种建筑风格中，每种风格都源自其自身的谷仓，因此它属于该风格，而不是被硬塞进去的灰色方块。它有合成配方，并且归在军事分类下，因为马厩本就该紧邻兵营。
• 骑兵守卫会骑马前往巡逻，而不是干坐在一匹四处乱走的马上。由市民骑乘的马从未接入原版的玩家骑乘代码——它按生物公式移动，其中速度随属性平方缩放，因此骑乘守卫的速度只有 1.4–2.8 格/秒，而步行守卫为 3.96。骑兵现在的骑乘速度为 4.8–6.6，采用与原版玩家骑马相同的线性规则，并设有上限以免超出自身寻路能力。一段 70 格的路程从 32–48 秒缩短到了 12–16 秒。
• 骑手会看向前进方向，并且会在梯子前下马——这两者此前都在读取马自身的导航数据，而该数据在每次骑乘的每一刻都是空的。

玩法说明：马厩会接收一名马厩管理员，负责放牧和繁殖马匹，以及骑兵守卫，他们和普通守卫一样——你在马厩中指派他们，他们从马厩领取坐骑，从马厩出发巡逻，追击劫掠者并返回自己的马位。他们的巡逻半径是守卫塔的一点五倍，因此一座马厩能覆盖任何塔都无法覆盖的范围。自由模式会直接发放现成的坐骑，已训练并披甲，因此你无需先培育马群就能体验整套内容。

马厩自身的设置标签页包含巡逻间隔——即两次出击之间相隔多少分钟。默认值为六，这对于一个活动范围如此之大的单位来说是刻意为之，但这也是骑兵大部分时间都待在马厩附近的原因；如果你希望他们持续外出，就把它设为 1。

顺带修复了两个慢动作式崩溃：骑兵的马在世界保存时不再丢失其马厩，骑兵也不再每次受击都向日志写入堆栈跟踪。

🎣 会驾船前往水域的渔夫

• 他会乘船前往钓鱼点，而不是拒绝自己走不到的水域。
• 每座渔屋最多五名渔夫，取决于渔屋等级。
• 他们分散坐在同一片池塘边——按座位而非按池塘分散，因此一个小水池也能容纳全部五人，而不是让其中三人永远闲置。

⛏️ 会承认自己卡住的矿井，以及尊重岩浆的矿工

• 竖井上的看门狗：当矿井无法取得进展时，矿工会直接在聊天中说明，而不是让竖井无声无息地永远无法完工。
• 矿工绝不会对着岩浆挥镐，并且挖掘时站在梯子上，这正是过去导致矿井和其中矿工丧命的原因。

🧱 架子像方块一样被破坏

上游给架子设置了无限爆炸抗性——与基岩相同——因此一只苦力怕会在你的仓库地板上炸出坑，却让所有架子悬在空中。这里的抗性为 6，与石头相同，并且其中的物品会掉落。

🔧 此处修复了 MineColonies 长期存在的 Bug

这些是上游的 Bug——它们在官方 NeoForge 构建上可以复现，并且在将其判定为上游问题而非本移植版所致之前，每一条都在上游自己的 1.21.1 源码中逐行核对过。它们已在此修复：

• “建造者拒绝建造。”“这个订单是否在殖民地内”的检查在遍历建筑占地范围时，对于一个 17×17 的小屋，恰好只检查了一个区块——而且是错误的那个，然后报告了小屋的坐标，这倒没问题。现在建筑下方的每个区块都会被检查，并且消息会指出实际未被认领的区块。
• 1000 格外的农场抢走了旁边农场的田地。田地自动认领以前完全不看距离。现在会看了——而且市民不再会一直走向一块已经换了主人的田地。
• 工人永远站着不动。导航器的卡住处理器只会救援正在行走但原地打转的工人；对于目的地根本没有路径的工人它无能为力——什么都不动，什么都不记录，没有未完成的请求，通常的解决办法是拆掉小屋。stuckrescueseconds改为监视目的地而不是路径，并把工人直接放到那里。

另外，这不是上游的问题：农夫从不锄地，这是新版 Minecraft 造成的——原版拆分了 #minecraft:dirt 标签，把草方块、灰化土和泥移了出去，导致可锄地表检测不再覆盖每块真实田地所铺设的地面，农夫走完整个螺旋却什么都没做。在相同的草地场景中测量：修复前 121 格中 0 格被锄，修复后三分钟内 80 格被锄。

这不是一个编译后就上传的构建。上述每个功能都已在实时客户端和专用服务器上实际游玩验证——殖民地建立并发展，小屋放置并建造，小屋界面手动操作，工人被跟随观察，权限从边界错误一侧测试，袭击被召唤。许多修复之所以存在，是因为玩家遇到了 bug 并报告了它，而全文引用的测量数据都是在运行中的服务器上取得的，而非估算。

🖥️ 面向服主、建筑者和测试者的工具

也是相对于上游 MineColonies 新增的，且仅存在于本构建中。

🧰 自由模式——无需肝材料即可建造和测试

/mc colony freemode <colony> on让殖民地在完全没有物品的情况下运作。一个开关，随殖民地保存，默认关闭。它用覆盖了那些复选框从未触及的一切的东西，取代了四个分散的小屋复选框：建筑材料、工具、武器、种子、繁殖物品、治疗物品、食物——以及请求系统，因此合成配方输入、熔炉燃料、冶炼矿石、学校纸张和守卫装备也会被凭空生成。守卫会获得真正的武器，而不仅仅是被告知停止请求武器。已经在等待请求的工人无需重新登录即可恢复。

非常适合创造模式建筑、截图、服务器展示，以及在正式投入前测试布局。

⚔️ 按需袭击

袭击命令，为测试和服务器活动而变得可用：

• /mc raid <colony> now立即开始，而不是等待长达三分钟的慢 tick 和营火计时器。
• size和 strength——一行命令要求 40 名袭击者，生命值、伤害和护甲为 2.5 倍，无需先指定袭击类型。
• where告诉你袭击者实际在哪里，以及当前作为实体存在多少个——这就是“袭击进度条满了但城镇空无一人”的答案。
• tp把你传送到他们旁边，stop取消所有袭击并清理掉存活超过事件时间的袭击者。
• 你按名称要求的袭击不再仅仅因为周围区域加载范围不够而失败并显示 NO_SPAWN_POINT。自然袭击不受影响。

📦 了解你的仓库实际在做什么

/mc colony warehousestock <colony>按物品类型报告距上次取走已过多久以及被取走的频率。两个数字都要，这是有意为之：单看闲置时长会把一个很少但规律使用的消耗品误判为垃圾。“闲置 20 天，取走 0 次”才是你该清理的；“闲置 1 天，本周取走 400 次”则是你绝不能卖掉的。

• 聊天栏会收到摘要；完整列表会写入世界存档中的 CSV 文件，路径会在聊天栏中打印出来——你可以在电子表格中按任意列排序。
• 占用率以两个从不取平均值的数字报告：首先是槽位占用，因为这才是真正阻止信使存放物品的因素，其次是物品容量。一个槽位放着三个圆石，就是槽位已满而容量几乎为空。
• 在一个有 51 个货架和 589 种物品类型的仓库中，每 25 秒采样一次，每次采样中位耗时 875 微秒。

🛡️ 殖民地保护，以及一个关闭它的开关

Fabric 移植版丢失的权限重新生效了：放置方块、放置小屋、装满桶、拉弓，并且OPEN_CONTAINER现在能识别模组物品栏。敌对生物不再生成在已建成的建筑内部，而turnoffexplosionsincolonies的伤害部分能让你的市民和牲畜免受游戏中每一次爆炸的伤害。

/mc colony protection <colony> off可防止某个殖民地在你在其中工作时拒绝你的一切请求——它是服务器全局配置和逐项编辑权限等级表之间的中间设置。它只在一个地方读取，即所有权限检查都会经过的那个方法，因此“关闭”不会漏掉任何一道门。有两项保持开启，因为它们保护殖民地而非拒绝你：建筑内生物生成，以及爆炸伤害过滤器。

🩺 诊断与管理命令

• /mc colony diagnose——什么卡住了以及为什么：每个工人的工作、AI 状态和被卡住多久，没有 AI 的市民，无人接取的请求，没有建造者的工作订单，不一致的建筑。
• /mc citizens fill——填充殖民地，并雇佣所有人到空缺的工作岗位。
• /mc citizens maxstats / heal——将所有技能拉满，或一次性治愈并治疗所有人。
• /mc colony research completeall——完成研究树，先完成前置，无成本，无需大学。
• /mc colony teachRecipes——教会每个工匠其被允许学习的一切。
• /mc colony growChildren——一次性让一个殖民地中的所有孩子长大，适用于旧存档中孩子卡住的世界。
• /mc colony protection / /mc colony warehousestock——见上文。

⚙️ 配置

• maxcitizenpercolony现在最高可接受 1000（默认值仍为 250），研究阶梯的顶层也相应提高——否则配置为 1000 会被直接钳制回 500。
• stuckrescueseconds（新增，默认 60）当工人花费该时长仍未靠近其工作目的地时，将其传送到该目的地。关于其重要性，请参见上方的错误修复。

📋 需求

基础版本：上游的 1.21.1 分支（NeoForge 21.1，Java 21），同时迁移到了 Fabric 加载器和 Minecraft 26.x。

📥 如何在 Fabric 上安装 MineColonies

1. 为你的 Minecraft 26.x 版本安装 Fabric Loader。Minecraft 本身要求 Java 25。
2. 在 mods/ 中恰好放入两个文件：Fabric API（与你的 Minecraft 版本对应的构建）以及此模组的 jar 文件。
3. 启动游戏。标题界面会询问是否允许下载 MineColonies 资源文件（约 78 MB）。点击一次“下载”即可；文件会保存在你的电脑上，之后不会再出现提示。专用服务器会完全跳过此步骤。

这个 jar 通过 Fabric 的 Jar-in-Jar 机制将三个必需的 LDTTeam 前置库 内置其中：blockui、structurize 和 domum_ornamentum，它们也都已移植到 Fabric，并支持 Minecraft 26.x。

⚠️ 请勿单独安装 Structurize、BlockUI 或 Domum Ornamentum

无论版本如何，mods/ 中的 jar 都会静默覆盖嵌套其中的同名文件。由此产生的崩溃会指向已加载代码中并不存在的源代码行，而且日志中不会显示发生了替换。

在模组列表中，blockui、domum_ornamentum 和 structurize 必须显示为缩进在 minecolonies 下方的条目。如果其中任何一个显示在顶层，说明 mods/ 中还有多余的 jar 文件——请将其删除。

⚡ 性能——在拥有 1000 名居民的殖民地上进行性能分析

本移植版本在专用服务器上的真实 1000 名居民殖民地中进行了性能分析，并对寻路线程池进行了实时监测。测试后推出了一轮针对热点路径的修复：服务器 tick 不再遍历所有殖民地来处理空回调；居民列表的防御性副本不再在 tick 路径中创建；GUI 列表不再重复刷新两次；A* 不再为每个节点读取世界时钟；快递员查询改用哈希；请求系统的日志记录在禁用时不再构建字符串。

完整的测量结果——包括哪些部分仍然开销较大以及原因——已发布在代码仓库中，而不是被浓缩成一个营销数字。

⚠️ 相较于官方 NeoForge 版本的已知限制

一些仅适用于 NeoForge 的钩子，在 Fabric 或原版 Minecraft 26.x 中没有对应功能。相关内容没有被删除——而是注释掉并记录在日志中。

殖民地保护： TOSS_ITEM 和 PICKUP_ITEM 不会生效——陌生人进入你的领地后，仍然可以丢弃物品并捡起物品。其他所有权限均正常工作，包括 PLACE_BLOCKS / PLACE_HUTS、FILL_BUCKET、SHOOT_ARROW、BREAK_BLOCKS、ACCESS_HUTS 和 ATTACK_CITIZEN。

爆炸： 殖民地建筑不会受到原版爆炸的保护——苦力怕、TNT 或下界中的床都会破坏蓝图。要通用地实现这项保护，就必须修改游戏自身的爆炸代码；本移植版本不会这么做。以下功能仍然有效：来自飞行器模组的爆炸会受到保护，而 turnoffexplosionsincolonies 的伤害部分可以让你的居民和牲畜免受游戏中所有爆炸的伤害。

火焰与生物破坏方块：两者都无法仅针对殖民地进行限制。目前的 Minecraft 会通过影响整个世界的游戏规则处理这两项功能，没有针对特定区域的钩子，因此 fire_spread_radius_around_player 和 mob_griefing 是仅有的控制选项，但它们会影响整个世界。这并非移植时丢失的功能——原版也没有对此设置钩子。值得注意的是：在原版默认设置下，只要附近没有玩家，殖民地就完全不会着火。

渲染：长矛会以扁平物品的形式渲染；备用居民模型会显示玩家叠加层（模组自带的职业模型不受影响）；其他模组中的物品无法设置居民的手臂姿势。

其他： 一个 TravellingManager 字段在移植前创建的世界中会读回为 BlockPos.ZERO；餐厅菜单只会解析 MineColonies 自带配方中的食材；殖民地创建时的粒子效果有所不同。

核心玩法——建造、工作、工人 AI、寻路、袭击、研究、任务和请求系统——均可正常运行。完整列表以及每项差异在游戏中的表现和修复方法，已发布在仓库的 PORT-STATUS.md 中。

❓ 常见问题 — Fabric 版 MineColonies

MineColonies 支持 Fabric 吗？ 官方版本不支持——上游仅发布 NeoForge 版本。这是社区制作的 MineColonies Fabric 移植版，适用于 Minecraft 26.x。

有适用于最新 Minecraft（26.x）的 MineColonies 版本吗？就是这个版本。它基于上游的 1.21.1 分支构建，并移植到了 Minecraft 26.x。

我需要安装 Structurize、BlockUI 和 Domum Ornamentum 吗？ 不需要——这三个模组的 Fabric 移植版都已打包在 jar 文件中。单独安装它们会 导致游戏崩溃；请参阅上方的警告。

Fabric 版 MineColonies 能在专用服务器上运行吗？ 可以，而且客户端和服务器端都必须安装此模组。它已在安装了 Fabric API 的真实 Fabric 服务器上成功启动并运行。

我可以将 26.2 世界迁移到 26.3 吗？ 可以——先备份，再用 26.3 版本打开。殖民地会完整保留：建筑、居民及其工作、工作订单、研究、货架内容、田地、权限，甚至进行中的袭击。反向迁移——在 26.2 中打开 26.3 世界——不受支持。

我可以使用以前的 MineColonies 世界吗？ NeoForge 1.21.1 版本创建的世界无法直接移植——Minecraft 26.x 本身更改了存档格式。请创建新世界。

它与其他 Fabric 模组兼容吗？此模组不会修改游戏逻辑。它只有一个客户端 mixin，用于将下载的资源注册为资源包；服务器端没有 mixin。不过它仍是一个大型模组，始终有可能发生冲突——请在此处报告，并附上你的模组列表。

在哪里报告 Bug？请前往本项目在 GitHub 上的问题追踪页面。请附上 Minecraft / Fabric Loader / Fabric API 版本、完整的 logs/latest.log 或崩溃报告、其他已安装的模组，以及复现步骤。如果同一问题在官方 NeoForge 版本中也会出现，请改为向上游报告。

🙏 致谢

MineColonies 由 LDTTeam（Let’s Dev Together） 及众多贡献者共同打造，历经十余年。每位工人、每座小屋、每条研究分支、每份蓝图，以及殖民地逻辑中的每一行代码，都源自他们。面向 NeoForge 的官方模组可在 CurseForge 获取——如果你使用 NeoForge，请安装该版本并支持作者。

📄 许可证

本项目采用 GPL-3.0-only 许可证，与上述所有上游项目采用相同许可证，并按其条款分发。每个已发布 jar 的完整对应源码都位于同一个公开仓库：github.com/unknown-wq/minecolonies。其中包括模组自身的源码、jar 中打包的三个前置库源码 libs/（blockui、domum-ornamentum、structurize），以及已发布的 jar 文件 dist/。每个版本的 jar 及其构建所用源码均位于仓库的同一提交中。