SakBot

一个 SakBot 打通三台服务器与所有 QQ 群

SakBot 是一套面向 Minecraft 服务器的玩家管理系统。白名单、QQ 绑定、登录鉴权、签到与货币、跨服聊天、TAB 列表、自定义命令、管理后台全部收在一个机器人里，三台服务器与多个 QQ 群共用同一份数据。

为什么选择 SakBot

| 特性 | 说明 |

| 三区白名单一次写入 | 白名单统一写入 SakBot，一区 / 二区 / 三区实时读取，不再每个区各维护一份 |

| 两种绑定方式 | 群内 #绑定 游戏ID 一句话完成；或进服生成验证码自动发群，机器人代填 |

| 内置登录系统 | 注册 / 登录 / 鉴权全部自带，不依赖第三方登录插件，未登录禁移动、禁交互、禁聊天、跨群同步登录 |

| 跨服同频 | 一区 / 二区 / 三区 / QQ 群消息互通，跨服 TAB 列表显示 |

| 数据可视 | 管理后台按 IP 归属地聚合世界地图热点，近 30 日新增趋势与地区分布明细 |

| 双机器人分流 | 官方机器人必须 @ 才响应；普通机器人 # / / 前缀即触发，两套互不抢消息 |

| 群内可触发命令 | 触发词映射 /gc、/list、/stop、/give 等指令，支持次数限制、文本与图片回复 |

| 自托管 | 数据存在自己的机器上，不经过第三方服务器 |

快速开始

1. 在服务器 plugins/ 放入 SakBot-Minecraft 插件并重启，确认与 SakBot 连接正常。

2. 部署 SakBot 主程序（单文件可执行，无需额外运行环境）。

3. 在 Web 管理后台填入服务器信息、QQ 群号与机器人配置。

4. 配置白名单来源为 SakBot，重启三个区，确认白名单已同步。

5. 群内发送 #绑定 游戏ID 测试绑定；进服确认验证码能自动发到群里。

各步骤的详细参数、端口与权限说明见文档：https://sakbot.saklit.com/

功能一览

白名单与绑定

• 白名单只在 SakBot 维护一份，三个区实时读取，改一次全区生效。

• 群内一句话绑定：#绑定 游戏ID，机器人直接回执结果。

• 进服绑定：服务器生成 6 位验证码并自动发到群，普通机器人完成绑定，玩家不用手动抄写。

• 改名换绑走同一套流程，新昵称直接覆盖旧记录。

登录与鉴权

• 注册、登录、鉴权全部内置，不依赖外部登录插件。

• 未登录状态下禁止移动、交互与聊天。

• 管理员与玩家账号分离存储，管理后台仅管理员可进入。

签到、货币与称号

• 7 日签到逐格点亮，连续天数有额外奖励。

• 独立货币钱包与流水记录，收支可查。

• 称号支持群名片预览，群内与服内身份一致。

跨服聊天与 TAB

• 一区 / 二区 / 三区 / QQ 群同频，玩家在哪个区都能接上话。

• 跨服 TAB 玩家列表显示所在区。

自定义命令

• 群内触发词映射到服内指令，例如 /gc、/list、/stop、/give。

• 支持调用次数限制、文本回复与图片回复。

• 群内直接看到执行效果，不用来回切后台。

管理后台

• 顶部四项核心指标：白名单、玩家、QQ 用户、在线数。

• 按 IP 归属地聚合的世界地图热点，一眼看清玩家分布。

• 近 30 日新增玩家堆叠柱状图 + 地区分布明细表。

• 深色界面，手机与电脑浏览器直接打开。

双机器人分流

• 官方机器人（QQ 开放平台）：只在被 @ 时响应，适合正式群公告与绑定。

• 普通机器人（OneBot 11）：# / / 前缀即触发，适合日常高频使用。

• 两套机器人按「通道 + 群」双隔离，同一条消息不会被重复响应。

兼容性

• Minecraft Java 版 1.9 – 最新版本

• 支持 Paper / Spigot / Purpur 等 Bukkit 系核心

• 官方机器人：QQ 开放平台；普通机器人：OneBot 11

文档与社区

• 文档：https://sakbot.saklit.com/

• QQ 群：663273014

部署、配置或功能建议都可以进群反馈；文档里有完整的安装步骤与后台说明。