一个运行在 Windows 上的 Minecraft 服务器 AI 聊天机器人:实时监听服务器聊天日志,玩家喊出唤醒词即可与 AI 对话,AI 回复通过 RCON 私聊(或广播)给玩家。
支持 DeepSeek、Kimi、智谱 GLM、通义千问、硅基流动、OpenAI 以及任意 OpenAI 兼容接口。
- 🎮 游戏内 AI 问答:私聊 /tell 回复,可选 /say 全服广播
- 🤖 多模型服务:7 种内置服务商 + 自定义 OpenAI 兼容接口,切换即生效
- ⚡ 快速配置:选择 server.jar(或服务器文件夹)自动读取 RCON 与日志路径,一键应用并自检连接
- 🧠 多玩家独立上下文记忆(可配置轮数),仪表盘按人查看/清空
- 🌗 浅色 / 深色主题一键切换,滚轮防误触
- 🔒 安全加固:每玩家/全局限流、在线玩家校验、玩家名白名单、DPAPI 密钥加密、提示注入防护、RCON 自动重连与探活
在服务端根目录 server.properties 中设置:
enable-rcon=true
rcon.port=25575
rcon.password=你的密码保存后重启服务端,控制台出现 RCON running on 0.0.0.0:25575 即成功。
- 源码运行:安装 Python 3.9+ 与依赖后运行
python main.py - 打包 exe:双击
build.bat(自动探测 Python、安装依赖、构建单文件 exe 到dist\)
打开「设置」→ 点 「快速配置…」 → 选择你的 server.jar → 确认检测结果 → 应用;再填写 API Key 保存。程序会自动测试 RCON 连接并弹窗告知结果。
游戏内聊天输入(默认唤醒词):
迪克,帮我查一下钻石镐的合成配方
AI 会通过私聊回复你。
| 服务商 | 默认模型 | Key 获取 |
|---|---|---|
| DeepSeek | deepseek-v4-pro / deepseek-v4-flash | platform.deepseek.com/api_keys |
| Moonshot Kimi | kimi-k2-turbo-preview | platform.moonshot.cn |
| 智谱 GLM | glm-4.5-air | open.bigmodel.cn |
| 通义千问(百炼) | qwen-plus | bailian.console.aliyun.com |
| 硅基流动 | deepseek-ai/DeepSeek-V3.2 | cloud.siliconflow.cn |
| OpenAI | gpt-4o-mini | platform.openai.com |
| 自定义 | 任意 | 任意 OpenAI 兼容服务(含本地 Ollama/LM Studio) |
minecraft-ai-bot/
├── main.py # 程序入口
├── core/ # 核心逻辑
│ ├── ai_service.py # AI 请求(多服务商、限流、注入防护、重试)
│ ├── rcon_sender.py # RCON 客户端(后台线程、自动重连、探活)
│ ├── log_listener.py # 日志监听(轮转检测、多格式聊天解析)
│ ├── config_manager.py # 配置读写(字段校验、DPAPI 加密)
│ ├── providers.py # 模型服务商注册表
│ ├── server_detector.py # 快速配置检测(只读服务器文件)
│ ├── secret_store.py # DPAPI 密钥加密
│ └── validation.py # 玩家名/消息清理
├── ui/ # 界面(PySide6)
│ ├── main_window.py # 侧边栏 + 页面框架
│ ├── dashboard_page.py # 首页
│ ├── settings_page.py # 设置
│ ├── console_page.py # RCON 控制台
│ └── quick_setup_dialog.py# 快速配置确认框
├── resources/ # 双主题样式
├── docs/screenshots/ # 界面截图
├── build.bat # 一键打包
├── MinecraftAIBot.spec # PyInstaller 配置
├── 使用说明书.md # 完整使用文档
└── 修复说明.md # 版本变更记录
build.bat- 自动探测 Python(支持 C:\Python3xx、用户目录安装、py 启动器等)
- pip 安装失败自动改用清华镜像
- 构建前自动关闭运行中的旧程序,避免文件占用
- 产物:
dist\MinecraftAIBot.exe(单文件,约 49 MB)
依赖见 requirements.txt(PySide6、requests)。
- API Key 与 RCON 密码在 Windows 上使用 DPAPI 加密存储(绑定当前 Windows 账户)
- RCON 是明文协议:程序与服务器请保持本机或内网部署,勿把 25575 端口暴露到公网
- 内置防刷保护(限流/长度限制)、防伪造保护(在线玩家校验)、防注入保护(玩家名白名单 + 提示词安全约束)
- 快速配置只读取 server.properties,绝不自动修改服务器配置文件
AI 生成的内容仅供参考,请勿完全信任;本项目的安全机制仅作基础防护,无法替代服务器层面的权限管理。

