Skip to content

About

Minecraft ?? AI ????? - ?? DeepSeek + PySide6

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Minecraft AI Bot

一个运行在 Windows 上的 Minecraft 服务器 AI 聊天机器人:实时监听服务器聊天日志,玩家喊出唤醒词即可与 AI 对话,AI 回复通过 RCON 私聊(或广播)给玩家。

支持 DeepSeek、Kimi、智谱 GLM、通义千问、硅基流动、OpenAI 以及任意 OpenAI 兼容接口。

✨ 功能特性

  • 🎮 游戏内 AI 问答:私聊 /tell 回复,可选 /say 全服广播
  • 🤖 多模型服务:7 种内置服务商 + 自定义 OpenAI 兼容接口,切换即生效
  • ⚡ 快速配置:选择 server.jar(或服务器文件夹)自动读取 RCON 与日志路径,一键应用并自检连接
  • 🧠 多玩家独立上下文记忆(可配置轮数),仪表盘按人查看/清空
  • 🌗 浅色 / 深色主题一键切换,滚轮防误触
  • 🔒 安全加固:每玩家/全局限流、在线玩家校验、玩家名白名单、DPAPI 密钥加密、提示注入防护、RCON 自动重连与探活

🚀 快速开始

1. 服务端开启 RCON

在服务端根目录 server.properties 中设置:

enable-rcon=true
rcon.port=25575
rcon.password=你的密码

保存后重启服务端,控制台出现 RCON running on 0.0.0.0:25575 即成功。

2. 获取程序

  • 源码运行:安装 Python 3.9+ 与依赖后运行 python main.py
  • 打包 exe:双击 build.bat(自动探测 Python、安装依赖、构建单文件 exe 到 dist\)

3. 首次配置

打开「设置」→ 点 「快速配置…」 → 选择你的 server.jar → 确认检测结果 → 应用;再填写 API Key 保存。程序会自动测试 RCON 连接并弹窗告知结果。

4. 开始使用

游戏内聊天输入(默认唤醒词):

迪克,帮我查一下钻石镐的合成配方

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 生成的内容仅供参考,请勿完全信任;本项目的安全机制仅作基础防护,无法替代服务器层面的权限管理。

About

Minecraft ?? AI ????? - ?? DeepSeek + PySide6

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages