小鲸鱼AI

小鲸鱼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 回复。私聊和公开上下文相互独立。
  • 感知玩家的 AI – 在公开/混合模式下,AI 通过 [PlayerName]: message 格式看到谁说了什么。它可以自然地用名字称呼玩家。
  • 多语言 – AI 会自动使用玩家所用的语言回复(中文、英文等)。
  • 仅纯文本 – 指示 AI 绝不使用 Markdown、代码块或特殊格式,保持输出对游戏内聊天干净整洁。
  • 安全且非阻塞 – 所有 HTTP 请求都在后台线程运行;服务器主线程永不被阻塞。
  • 上下文管理 – 在可配置的间隔后自动清除对话历史,或通过命令手动清除。
  • 完全可配置 – 通过 config/aichat.json 更改 API 端点、模型、温度、系统提示词、前缀等。
  • 管理员命令 – 强大的 /aichat 命令可清除上下文、重载配置并查看状态。

📦 安装

  1. 为 Minecraft 1.21.8 安装 Fabric。
  2. 下载模组 .jar 文件并放入 mods/ 文件夹。
  3. 启动服务器或客户端。将在 config/aichat.json 生成默认配置文件。
  4. 编辑 config/aichat.json 并填写你的 apiKey 和(可选的)apiUrl。保存文件。
  5. 运行 /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、模型、模式等)