MineColonies 的活殖民者

MineColonies 的活殖民者

MineColonies 的殖民者在聊天中像玩家一样交流:他们会回复、记忆、闲聊、主动给你写信,并通过殖民地自身的系统接受命令。

语音对话示例

Living Colonists 是一个适用于 MineColonies 的 NeoForge 附加模组。殖民者会像其他玩家一样在文字聊天中说话。他们的话语来自任何兼容 OpenAI 的 API(DeepSeek、OpenRouter、Gemini、本地模型……),而他们所知道的内容则来自游戏本身。

Beta 版,早期开发阶段。 下面介绍的一切都可以正常工作,并且正在一个实际运行的服务器上游玩,但模组的内部仍在重构。新版本发布频繁,版本之间设置、提示词文件和整个功能都可能发生很大变化。更新前请阅读更新日志,并备份你的世界。非常欢迎提交错误报告。

你需要一个语言模型。 模组本身不包含语言模型。只有当服务器能够使用你自己的密钥访问兼容 OpenAI 的 API(DeepSeek、OpenRouter、Gemini 等,按使用量付费),或者访问运行在你自己机器上的模型(例如 Ollama 中的模型)时,殖民者才会说话。没有这些,玩家给殖民者发消息时只会收到一条提示:未设置 API 密钥。

示例

你走进殖民地,两个殖民者已经在聊天中争论起来了:

<John Brown> 面粉只够再撑两天了。到底有没有人在田里干活?
<Clodagh Bennett> John,看看你自己吧,烤炉都已经冷了三天了

看向面包师并按下 U(或你选择的任意按键),你输入的内容就会发送给他。问他烤炉需要什么,他会根据自己的储物和关于你的记忆来回答。当你让一名信使把煤炭送到面包房时,他会请你确认,然后走到仓库并把煤炭运过来。之后面包师会主动给你发消息:“你答应过给我柴火的。柴火呢?”

功能

  • 用 Y 与整个殖民地对话(紧挨着普通聊天键的按键,可重新绑定),或用 U 与单个殖民者私下对话(同样可重新绑定)。名字和职业可以以任何语言和语法格理解。关于食物的问题会交给厨师,关于建筑的问题会交给建筑师。
  • 殖民者通过 MineColonies 了解自己的处境:工作、住所、饥饿、生命、幸福度及其原因、他们的工作场所正在等待什么、袭击、天气、他们的家人和同事。他们能看到你手持和穿戴的物品,以及你是否看起来受了伤。建筑师像资源卷轴显示的那样了解自己的施工。
  • 查询和命令通过殖民地自身的系统执行。查询:库存、需求、建筑状态、研究、谁不开心;当一个殖民者询问另一个殖民者时,答案也会被查询出来,整个殖民地都会知道。命令:建造和升级、设定优先级、接受工作、下单制作、武装守卫、种植田地、整理仓库;信使取货和送货,卫兵护送和巡逻,殖民者前来、跟随你或集合。邮件和提醒:“告诉 Alex 面包做好了”、“十分钟后提醒我查看农场”。只有所有者和官员可以下命令,只能用自己的话,而且每一条都等待你说 是。
  • 记忆。 最近的谈话和长期事实(“Alex 答应给我建一座房子”)会与世界一起保存,每游戏周模型会把每个殖民者的生活总结成几句话。承诺有截止日期,殖民者会记得你是否遵守了它们。如果配置了可选的 embeddings 密钥,他们还会按语义回忆事实。
  • 每个殖民者都有自己的情绪、独特的说话风格以及与其他人的关系,这些关系会自行变化:同事变成朋友,两个脾气暴躁的室友闹翻,而且双方都记得原因。他们会八卦、谈论自己这一天过得如何、偶尔提到个人目标,并在目标实现时感到高兴。
  • 他们会主动开口: 谈论真实的问题(如果问题持续未解决,语气会更尖锐)、你告诉过他们的事、新闻或闲聊,时间不固定,且只在你身处殖民地时发生。
  • 他们会注意到事情:你回来了(你不在期间发生的新闻、外面的死亡、去下界或末地的旅行、像击杀末影龙这样的大事迹;如果你下线而其他人还在,可能会有人提到),你放进他们背包的礼物、新建筑的位置、与掠夺者的战斗、邻居生病或换了新工作。
  • 殖民者所有主动说出的话每个殖民地、每个玩家共享一个配额,因此繁忙的服务器也能保持安静:死亡或袭击总是会传达,闲聊会最先让位。
  • 殖民者头顶有气泡,带有正在输入的圆点。它们也兼容光影包。每个玩家可以在自己的聊天中关闭殖民地消息,只保留气泡。
  • 当殖民者不知道某个机制如何运作时,他们会查阅内置的 MineColonies 手册。代码决定消息发给谁、用哪种语言回复以及殖民地中实际有什么;模型只负责措辞。
  • 有一个包含所有选项和使用统计的设置界面;为管理员提供 /lcdebug 命令。管理员可以为服务器关闭该模组,殖民地所有者可以为自己的殖民地关闭(/lc colony off)。
  • 包含英语和俄语。殖民者会用你书写的语言回答。

要求

  • Minecraft 1.21.1,NeoForge 21.1.264 或更新版本。
  • MineColonies 1.1.1405 或更新的 1.1.x 版本(在 1.1.1405 和 1.1.1406 上测试过)。
  • 客户端和服务端都需要安装。
  • 一个兼容 OpenAI 的语言模型提供商的 API 密钥。

设置

  1. 将 jar 放入服务器和每个客户端的 mods 文件夹。
  2. 作为管理员,打开模组的设置界面(从菜单或未映射的设置键),按下一个预设(DeepSeek、OpenRouter 或 Ollama)并输入你的 API 密钥。服务器所有者也可以通过环境变量 LIVINGCOLONISTS_API_KEY 传入密钥(embeddings 使用 LIVINGCOLONISTS_EMBEDDINGS_API_KEY)。密钥保留在服务器上,绝不会显示或发送给玩家。
  3. 可选:用于按语义回忆的 embeddings 密钥(OpenRouter,默认 baai/bge-m3),以及主 API 失败时的备用 API。

在游戏中,/lc help 汇总了按键以及你可以向殖民者询问什么。logLevel 设置模组向服务器日志写入多少内容。

针对 deepseek-flash 和 bge-m3 开发和测试——它们以低廉的价格展现出最佳效果。你可以用其他模型(免费或本地)进行测试并向我们提交 issue——我会添加一个预设。

费用

模组是免费的;你需要为殖民者所说的话向模型提供商付费。在我们的服务器上,两名玩家、四名殖民者,使用最健谈的配置,在大约 3.5 小时的游戏中使用 DeepSeek 的 flash 模型,大约消耗了 100 万输入 token 和 24 万输出 token。三分之一的输入被缓存。总费用为 7 到 17 美分,embeddings 增加了不到百分之一美分。生活故事每游戏周为每个殖民者增加一次请求。更安静的配置(light、minimal、default)费用低得多,配置的 [limits] 部分会限制每个玩家的消息数和每天的 token 数。

隐私

玩家写给殖民者的内容,以及殖民者所知道的关于殖民地的信息,会发送到你配置的模型提供商,就像任何 AI 聊天服务一样。请选择你接受其条款的提供商,或使用本地模型。不会向其他任何地方发送任何内容。

兼容性说明

  • 为 1.21.1 上的 MineColonies 1.1.x 构建。如果更新的 MineColonies 更改了模组读取的某些内容,模组会跳过该部分而不是崩溃。如果发生这种情况,请报告。
  • 在大型模组包中也能工作:它是在一个约 320 个模组的整合包上开发的。
  • 整合包可以在 config/livingcolonists/content/ 中添加自己的聊天话题、殖民者会听说的进度以及手册文章。

致谢

  • MineColonies,由 LDT Team 制作,本模组是其附加的殖民地模拟器。
  • Colonist Errands,由 Lovkar 制作(GPL-3.0-or-later),是差事、感知、承诺和关系方面的主要代码来源。
  • Talking Colonists,由 sshcrack 制作:仅提供想法(主动发言、谣言、逐步升级的抱怨)。
  • ColonyChat:想法和经验教训。

由 JerTheFox 设计、测试和维护。我本人基本不写代码(我是系统管理员,不是 Java 开发者):Claude 按照我的设计编写代码,需要时我手动修复,每个版本在发布前都会在我们的家用服务器上游玩。附注:描述的初稿也是由 AI 撰写的,但我把它去掉了尴尬之处并亲自编辑过。

链接