
小鲸鱼AI
Little Whale AI (小鲸鱼AI) - Your own AIBot in Minecraft
查看大图一个轻量级、完全异步的 Fabric 模组,为你的 Minecraft 服务器带来一位友好的 AI 玩家 小鲸鱼。它由任何兼容 OpenAI 的 API 驱动,可以与玩家私聊或公开聊天,理解上下文,并使用玩家的语言交流。
✨ 特性
- 3 种聊天模式 – 在私聊、公开或混合模式之间切换:
- 私聊(模式 1):玩家使用
@ai <消息>与 AI 对话。只有发送者能看到回复。 - 公开(模式 2):每条公开聊天消息都会被当作与 AI 的对话。AI 会公开回复所有人。上下文全局共享。
- 混合(模式 3):
@ai触发私聊,而普通聊天触发公开的 AI 回复。私聊和公开上下文相互独立。
- 私聊(模式 1):玩家使用
- 感知玩家的 AI – 在公开/混合模式下,AI 通过
[PlayerName]: message格式看到谁说了什么。它可以自然地用名字称呼玩家。 - 多语言 – AI 会自动使用玩家所用的语言回复(中文、英文等)。
- 仅纯文本 – 指示 AI 绝不使用 Markdown、代码块或特殊格式,保持输出对游戏内聊天干净整洁。
- 安全且非阻塞 – 所有 HTTP 请求都在后台线程运行;服务器主线程永不被阻塞。
- 上下文管理 – 在可配置的间隔后自动清除对话历史,或通过命令手动清除。
- 完全可配置 – 通过
config/aichat.json更改 API 端点、模型、温度、系统提示词、前缀等。 - 管理员命令 – 强大的
/aichat命令可清除上下文、重载配置并查看状态。
📦 安装
- 为 Minecraft 1.21.8 安装 Fabric。
- 下载模组
.jar文件并放入mods/文件夹。 - 启动服务器或客户端。将在
config/aichat.json生成默认配置文件。 - 编辑
config/aichat.json并填写你的apiKey和(可选的)apiUrl。保存文件。 - 运行
/aichat reload(需要 OP)或重启服务器。
⚙️ 配置(config/aichat.json)
| 键 | 类型 | 默认值 | 描述 |
|---|---|---|---|
apiUrl |
String | https://open.bigmodel.cn/api/paas/v4/chat/completions |
API 端点(兼容 OpenAI) |
apiKey |
String | "" |
你的 API 密钥 |
systemPrompt |
String | (多语言、防前缀、纯文本提示词) | 定义 AI 行为的系统提示词 |
modelName |
String | "general" |
发送给 API 的模型名称 |
temperature |
Double | 0.7 |
回复的创造性(0.0–2.0) |
autoClearContext |
Boolean | true |
启用自动上下文清除 |
contextExpireSeconds |
Integer | 300 |
自动清除之间的秒数 |
prefix |
String | "<LittleWhale> " |
添加到每条 AI 回复的前缀(支持颜色代码) |
mode |
Integer | 2 |
聊天模式:1 = 私聊,2 = 公开,3 = 混合 |
🎮 用法
聊天触发
- 私聊 / 混合:以
@ai开头发送消息。示例:@ai 如何合成熔炉? - 清除私聊上下文:
@ai clear(在私聊/混合模式下有效) - 公开模式:直接在聊天中说话 – 每条消息都会触发公开的 AI 回复。
管理员命令(需要 OP,权限等级 2)
| 命令 | 描述 |
|---|---|
/aichat clear |
清除你自己的私聊上下文(模式 1/3) |
/aichat clear <player> |
清除特定玩家的私聊上下文 |
/aichat clearglobal |
清除全局公开对话上下文 |
/aichat clearall |
清除所有上下文(私聊 + 全局) |
/aichat reload |
无需重启即可重载配置 |
/aichat info |
显示当前设置(API、模型、模式等) |
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。