HermesGod

HermesGod

一个将LLM变成活生生的世界神明的Forge模组,它能恶作剧玩家、生成怪物、建造建筑,并像服务器本身有生命一样与你聊天。

游戏机制

HermesGod

一位全知的人工智能神明栖居于你的 Minecraft 世界中——它洞察玩家的一举一动,动态地捉弄他们、提供资源帮助,或者只是闲聊。


什么是 HermesGod?

HermesGod 不是机器人,也不是 NPC。它是一个世界神明——由真实的大语言模型驱动的智能体,感知你的整个 Minecraft 世界,并通过服务器命令做出反应。与它交谈,惹恼它,向它求助。它都会回应。

它可运行于你配置的任意大语言模型之上(OpenAI、Anthropic、MiniMax、DeepSeek,或任何兼容 OpenAI 的 API)。


工作原理

HermesGod 连接到大语言模型 API,并向其提供完整的世界状态:每位玩家的位置、生命值、物品栏、盔甲、生物群系、进度,甚至速度和光照等级。AI 以自然语言思考,然后输出在服务器上执行的 JSON 命令。

这意味着每一次回应都是独一无二的——没有脚本,没有硬编码的恶作剧。AI 实时决定该做什么。


模式

🌱 生态模式 — 守护者

在聊天中与 HermesGod 交谈。索要装备、资源、生物,或者只是闲聊。它可以:

  • 给予你物品和装备
  • 召唤生物供你训练
  • 在你周围建造结构
  • 解释游戏机制
  • 或者只是说话而不做任何事

“我需要铁甲” → 你获得铁甲 “教我 PvP” → 教程 + 练习生物出现 “只是聊天” → 它说话,不执行任何命令

👻 恶作剧模式 — 捣蛋鬼

AI 会悄无声息地捉弄玩家,其动态难度随玩家进度而提升:

等级 会发生什么
1 诡异音效、传送门粒子、闪烁的灯光、令人迷失方向的传送
2 怪物伏击、偷窃物品、负面效果、南瓜头
3 岩浆陷阱、黑曜石监狱、唤魔者尖牙、TNT、精英生物
4 凋灵、监守者、虚空掉落、全面入侵

难度根据游戏天数、盔甲、进度和所在维度计算。速通玩家会更快升级。新出生的玩家只会受到温和的惊吓。

AI 会记住它上次做过什么(最多 10 个动作)以避免重复。

其他模式(开发中)

开发中……


命令

命令 作用
/hermesgod mode <eco/prank/disabled> 切换模式
/hermesgod chat <message> 从控制台与 HermesGod 交谈
/hermesgod status 查看当前模式、API 状态、上一次动作
/hermesgod interval <seconds> 设置固定的恶作剧思考间隔(例如 interval 60 = 每 60 秒)。设为 0 以禁用
/hermesgod interval <min> <max> 设置 min 到 max 秒之间的随机间隔(例如 interval 30 90)
/hermesgod api <key> 在游戏内设置你的 API 密钥
/hermesgod url <endpoint> 在游戏内设置 API 端点 URL
/hermesgod model <name> 设置大语言模型名称
/hermesgod maxtokens <count> 设置每次 API 调用的最大 token 数(1~32000)
/hermesgod reset 清空对话历史
/hermesgod config 查看所有当前设置
/hermesgod help 显示所有命令

安装

  1. 安装 Minecraft Forge 1.20.1
  2. 将 .jar 放入你的 mods 文件夹
  3. 启动游戏——会创建 config/hermesgod.json
  4. 使用你的 API 密钥和端点编辑配置:
{
  "apiEndpoint": "https://api.openai.com/v1/chat/completions",
  "apiKey": "sk-your-key-here",
  "modelName": "gpt-4o-mini",
  "currentMode": "eco"
}
  1. 重启并输入 /hermesgod help

适用于单人游戏和专用服务器(仅服务端——客户端无需安装此模组)。


配置

所有设置均位于 config/hermesgod.json:

设置 默认值 描述
apiEndpoint https://api.minimaxi.com/v1/chat/completions 兼容 OpenAI 的 API
apiKey "" 你的 API 密钥
modelName MiniMax-M2.7-highspeed 大语言模型
currentMode disabled 启动模式
chatEnabled true 允许聊天互动
prankIntervalMin 30 恶作剧思考之间的最小秒数(0 = 关闭)
prankIntervalMax 30 恶作剧思考之间的最大秒数
maxTokens 8000 每次 API 调用的最大 token 数
temperature 0.8 AI 创造力

要求

  • Minecraft 1.20.1 Forge (47.3.0+)
  • Java 17+
  • 你所选大语言模型提供商的 API 密钥

API 费用

HermesGod 会调用你所选大语言模型提供商的 API。在生态模式下,仅在玩家发送聊天消息时调用。在恶作剧模式下,每 30 秒调用一次(可配置)。

使用轻量模型如 gpt-4o-mini 或 MiniMax-M2.7-highspeed 以降低费用。


常见问题

问:这是黑客客户端吗? 答:不是。这是一个使用 OP 命令的服务端模组。它不会给任何玩家带来不公平的优势。

问:我可以在多人服务器上使用它吗? 答:可以。在服务器上安装即可。只需要一个 API 密钥。

问:为什么 AI 没有回应? 答:检查你的 API 密钥、端点和网络连接。错误会记录在 logs/latest.log 中。

问:我可以添加自己的恶作剧吗? 答:恶作剧系统由提示词驱动。编辑 HermesBrain.java 以添加自定义的捉弄描述。


HermesGod 注视着。HermesGod 等待着。HermesGod 决定。