Chat_AI_助手

ChatBot Mod

一个专为 Minecraft 1.21.1 NeoForge 设计的 AI 聊天机器人模组。

它将 NPC 从简单复读模板台词转变为真正智能的助手，能够进行对话并执行服务器命令。

功能特性

• ✅ 多种 AI 服务支持：内置支持智谱 GLM、火山方舟、OpenAI、DeepSeek 和 MiniMax 等 6 种 API，自动识别并适配。
• ✅ 实时对话：玩家在聊天框中 @AI 即可触发对话；AI 异步处理，不会阻塞主线程。
• ✅ AI 命令执行：玩家可让 AI 执行服务器命令（tp、weather、time、give 等）。AI 通过 <cmd> 标签协议输出命令。
• ✅ 分级权限：为 OP 和普通玩家提供独立的权限模型，采用黑名单/白名单双重保护，防止提示注入绕过。
• ✅ 频率限制：可配置每个玩家每分钟的命令执行次数，防止 AI 被滥用。
• ✅ 两轮对话：AI 先输出意图和命令 → 系统执行命令 → AI 再向玩家总结执行结果。
• ✅ 灵活配置：所有功能均可通过 config/chatbot.toml 配置，无需重启代码即可调整。

支持的 AI 服务

API 类型	服务名称	官方网站
ZHIPU	智谱 GLM	https://open.bigmodel.cn/
VOLC	火山方舟（豆包）	https://console.volcengine.com/ark/
OPENAI	OpenAI	https://platform.openai.com/
DEEPSEEK	DeepSeek	https://platform.deepseek.com/
MINIMAX	MiniMax	https://api.minimax.chat/
CUSTOM	自定义 API	自定义端点（兼容 OpenAI 协议）

安装步骤

1. 下载模组文件 chatbot-1.0.0.jar
2. 将文件放入服务器的 mods/ 文件夹中
3. 启动服务器，配置文件将自动生成：config/chatbot.toml
4. 停止服务器，编辑配置文件并填写 API Key 和模型。
5. 重新启动服务器即可使用。

配置文件说明

配置文件路径：config/chatbot.toml

# ===== AI 服务配置 =====
# API 密钥（必填）
api_key = "your-api-key-here"

# 模型名称（必填，根据 API 类型选择）
model = "GLM-4-Flash-250414"

# API 类型：ZHIPU, VOLC, OPENAI, DEEPSEEK, MINIMAX, CUSTOM
api_type = "ZHIPU"

# 自定义 API 地址（仅在 api_type=CUSTOM 时必填）
custom_url = ""

# 启用 AI 回复
ai_enabled = true

# 回复延迟（毫秒）
reply_delay_ms = 0

# AI 显示名称
ai_name = "ChatBot"

# 触发前缀（玩家聊天以该前缀开头时才会触发 AI）
ai_trigger = "@AI"

# ===== AI 命令执行 =====
# 启用 AI 命令执行
cmd_enabled = true

# 全局黑名单（AI 不能执行任何人的这些命令，包括 OP，逗号分隔）
cmd_blacklist = "stop,setblock"

# 普通玩家白名单（非 OP 玩家只能让 AI 执行这些命令，逗号分隔）
cmd_normal_whitelist = "list,seed,spawn,home,help,me,tell,msg,w"

# 每个玩家每分钟最大命令执行次数（0 = 无限制）
cmd_max_per_minute = 10

AI 服务配置示例

智谱 GLM

api_key = "Your Zhipu API Key"
model = "GLM-4-Flash-250414"
api_type = "ZHIPU"

火山方舟（豆包）

api_key = "Your Volcano Ark API Key"
model = "doubao-seed-2-0-lite"
api_type = "VOLC"

OpenAI

api_key = "sk-Your OpenAI Key"
model = "gpt-3.5-turbo"
api_type = "OPENAI"

DeepSeek

api_key = "Your DeepSeek Key"
model = "deepseek-chat"
api_type = "DEEPSEEK"

MiniMax

api_key = "Your MiniMax Key"
model = "abab5.5-chat"
api_type = "MINIMAX"

自定义 API

api_key = "Your API key"
model = "Your model name"
api_type = "CUSTOM"
custom_url = "https://your-api-endpoint.com/v1/chat/completions"

使用方法

基础对话

1. 在游戏中按 T 打开聊天窗口。
2. 输入 @AI 你的问题 并发送。
3. AI 将异步回复你的消息。

AI 命令执行

只要 cmd_enabled = true，玩家就可以让 AI 执行服务器命令。AI 会在回复中嵌入 <cmd>命令参数</cmd> 标签，系统会自动解析并以最高权限（等级 4）执行。

对话示例

<玩家> @AI 你好
[ChatBot] 你好！很高兴认识你！有什么可以帮你的吗？

<玩家> @AI 现在有多少人在线？
[ChatBot] 让我查一下在线玩家...
[ChatBot] 当前服务器有 3 名玩家在线：Steve、Alex 和 PanKa。

<玩家> @AI 把我传送到 Steve 那里。
[ChatBot] 好的，正在将你传送到 Steve 身边。
[ChatBot] 你已被传送到 Steve 身边。

<玩家> @AI 给我一个钻石（普通玩家）
[ChatBot] 抱歉，你没有权限让我执行 `give` 命令。请联系 OP 协助。

<玩家> @AI 给我一个钻石（OP 玩家）
[ChatBot] 已给予你 1 个钻石

常见问题

问：AI 没有响应

答： 检查服务器日志中与 [ChatBot] 相关的信息：

• AI service not enabled：检查配置文件中 ai_enabled 是否为 true
• API request failed：检查 API Key 和模型名称是否正确
• Unable to connect：检查服务器网络是否正常工作

问：配置文件在哪里？

答： 服务器根目录下的 config/chatbot.toml

问：修改配置后需要重启服务器吗？

答： 是的，需要重启服务器才能生效。

问：如何查看详细日志？

答： 在服务器日志中搜索关键字 [ChatBot]。

版本信息

• 模组版本：1.0.0
• Minecraft 版本：1.21.1
• NeoForge 版本：21.1.236

许可证

MIT License