Beacon 使用 Wiki
本目录存放面向服主、运维和业务插件开发者的 v2 使用教程。它说明“怎样使用当前交付的能力”：从最小接入到完整集群搭建、配置与文件交付、拓扑与玩家首连、可观测与排障，以及业务插件接入。
从这里开始
- 快速开始：用单机 SQLite 控制面接入第一台 Paper/Bukkit 服务。
- 从零搭建完整服务器：搭建控制面、BC、两台全局登录服、小区大厅与游戏服，并完成玩家首连验收。
- 全局大厅与 BC 接入操作手册：运营现有的 BC → LobbyCluster → 小区拓扑及故障切换。
功能教程
| 主题 | 阅读文档 | 覆盖能力 |
|---|---|---|
| 配置、文件与交付 | 配置、文件与交付 | 有效配置、受管文件、配置版本、变更单、Agent 拉取与回退。 |
| 回滚与版本追溯 | 回滚与交付版本 | 交付历史查单、整单/子集回滚、回滚重试、紧急终止与回滚动作记录。 |
| 审批、生命周期与自动化 | 审批、生命周期与 MCP | 审批中心、归档/恢复/墓碑、敏感正文直读与仍保留的一次性授权、MCP OAuth 客户端。 |
| Agent 本地可选项 | Bukkit/Paper 全量配置 / BC/Bungee 全量配置 | 最小引导外的本地运行参数、默认值与安全边界。 |
| 拓扑与玩家首连 | 全局大厅与 BC 接入操作手 册 | namespace、BCCluster、Region、Zone、LobbyCluster、多 listener 与首连落点。 |
| 健康、命令与审计 | 可观测与日常运维 | 总览下钻、服务分析、健康状态、告警收口、控制面健康页、BC 查询/目录命令、审计与调度判断。 |
| 业务插件接入 | 业务插件 SDK | Bukkit/Bungee 本地 SDK、配置读取、命令、HTTP 中转消息与 fail-static。 |
| 权限、备份与升级 | 安全与维护 | 身份审批、token、API 密钥创建/重置/吊销、最小权限、SQLite/外置 MySQL 备份、升级和回滚。 |
| 问题定位 | 故障排查 | 注册、身份冲突处置、审批、配置、地址、全局大厅、消息链路、DB 等待超时与控制面挂起取证。 |
适用边界
- 新部署以 v2 的 namespace token、身份审批与控制面拓扑为准；较早的 v1 路由和旧配置仅作兼容性参考，不作为新接入步骤。
- 当前教程覆盖 Bukkit/Paper 后端与 Bungee/BC 代理的 Agent 接入。未在本目录单独给出安装步骤的平台，不应据此推定受支持。
- Redis 跨服消息配置已由 HTTP 单跳中转取代；新集群不要为 Beacon 配置 Redis。
- 业务插件负责选区、排队、小区默认服和后续转服；Beacon 只负责控制面、受管目录与 BC 首次落到全局 LobbyCluster。