Plan 玩家数据分析(附带网页管理)

Plan | Player Analytics 玩家数据分析

> Minecraft 服务器玩家行为分析与监控的终极工具。内置 Web 面板，一站式查看在线活跃度、玩家构成、会话记录、服务器性能等指标；支持 Bukkit / Spigot / Paper / Folia / Purpur / Sponge / BungeeCord / Velocity / Fabric 等全平台，数据存于自有数据库、不外传第三方。

基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | Plan（Player Analytics，玩家数据分析）|
| 开发者 | AuroraLS3（原 Rsl1122 / RuneSimons，现由 plan-player-analytics 组织社区维护）|
| 最新版本 | 5.8+build.3605（2026-08-09）；Fabric 版 5.8+build.3605+fabric |
| 许可协议 | LGPL-3.0-or-later（自 4.x 起由专有协议切换为 LGPLv3）|
| 兼容版本 | Minecraft Java 1.8.8 – 26.2（含 26.2、26.1.x、1.21.x、1.20.x、1.19.x 等）|
| 运行平台 | Bukkit、Spigot、Paper、Folia、Purpur、Sponge、Waterfall、BungeeCord、Velocity、Fabric（一个 jar 通用于多数服务端，Fabric 为独立构建）|
| 运行环境 | Java 11 或以上 |
| 项目地址 | https://modrinth.com/plugin/plan |
| 官方文档 | https://github.com/plan-player-analytics/Plan/wiki |
简介

Plan 是一款开源、功能完备的 Minecraft 服务器数据分析插件。它在服务端内置一个 Web 服务器，持续采集玩家行为与服务端运行数据，再通过响应式网页面板呈现为数百个彩色指标与图表，帮助服主看懂"玩家在怎么玩、服务器跑得顺不顺"。

核心定位可以概括为三点：一是玩家洞察——每日活跃、新增留存、会话时长、击杀、死亡、地理分布、延迟（ping）、加入途径等；二是服务器监控——TPS、MSPT、CPU、内存、实体与区块负载、性能抖动（Jitter）；三是网络全局视图——代理（BungeeCord/Velocity）下多服数据汇聚，一套面板纵览整个群组。

与多数依赖外部 SaaS 的统计方案不同，Plan 的所有数据保留在你自己的数据库里，无需担心第三方经手玩家信息。它还通过 DataExtension API 与 50+ 常用插件（权限、经济、领地、反作弊、小游戏等）对接，把插件专属数据一并纳入分析。
核心特性
内置 Web 面板
无需额外部署网站。插件自带 Web 服务器（默认端口 8804），服主与管理员打开浏览器即可查看在线活跃度、玩家构成及其随时间的变化趋势，指标按颜色分级便于快速定位。
全平台支持、一个 jar 通用
Spigot、Paper、Sponge、SpongeForge、Folia、Purpur 及其衍生端，加上 BungeeCord、Velocity、Waterfall 代理，以及 Fabric（独立构建）均可运行。群组环境在代理与各后端都装 Plan，数据自动同步。
丰富的玩家洞察
日活、周活、月活、新增玩家与留存、会话记录、在线时段热力、玩家价值（activity index）、击杀/死亡、世界/维度分布等；配合强大的 Query 查询功能，可按时间段、权限组、加入版本、城镇/阵营等维度组合筛选。
服务器与网络性能监控
记录 TPS、MSPT、CPU、内存、实体与区块数量；5.8 新增 MSPT Jitter（平均/最大抖动） 指标——由相邻 tick 速度差计算得出，用于判断卡顿是否剧烈波动，与 MSPT 结合更准确评估高负载对游戏体验的影响。重写后的 Performance 页还纳入玩家对实体与区块负载的影响。
会话页重构（5.8）
Network / Server / Player 三个层级的 Sessions 页全部重写，支持最多约 1 万条会话、按日历/日期选择器筛选区间、CSV 导出，区间内所有进行中的会话都会显示。
地理定位与流量归因
启用后通过 GeoLite2 IP-Country 数据库（需接受 MaxMind EULA）解析玩家地区，结合 ping 与加入地址（join address），判断哪些推广渠道带来的玩家最多，辅助运营决策。
50+ 插件数据集成
通过 DataExtension API（APIv5）接入权限组、经济余额、领地、反作弊、小游戏等插件数据，并在面板与 Query 中展示；旧 PluginData API 以 Legacy 标签并存，逐步迁移。
双数据库与数据自管
默认 SQLite（零部署），中大型服务器或群组建议切换 MySQL；支持数据库备份、还原、迁移、合并、热切换、清理、导入导出，数据完全留在自有服务器，无第三方经手。
开发者 API
提供完整 Javadoc 与 APIv5 文档，支持通过 JitPack 引入依赖，自定义插件可将自己的指标写入 Plan 数据库，避免维护两套数据系统。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Spigot/Paper/Folia/Purpur/Bukkit 等，或 Sponge、Fabric；群组需代理 BungeeCord/Velocity |
| Minecraft 版本 | 1.8.8 – 26.2 |
| Java 版本 | Java 11 或以上（官方 CI 亦提供适配新版 JDK 的构建）|
| 数据库 | SQLite（默认，开箱即用）或 MySQL（群组/高并发推荐）|
| 网络 | Web 面板需要一个未被占用的额外端口（默认 8804），需可从访问端连通 |
| 可选 | GeoLite2 需接受 MaxMind EULA；公网暴露建议反向代理 + HTTPS + 认证 |

> 建议：小服 SQLite 即可；玩家量大或写并发高的服务器应尽早切 MySQL，否则写入锁可能引发延迟毛刺。数据会持续增长，繁忙服一年可达数 GB，可在配置中设置保留期定期清理。
安装方法
单服务端
从 Modrinth / Hangar / SpigotMC 下载 Plan 的 jar 文件
放入服务端 plugins/（Sponge/Fabric 对应 mods/）目录
重启服务器，生成 plugins/Plan/config.yml
按需修改服务器名、Web 端口、数据库类型等，执行 /plan reload 热重载
浏览器访问 http://服务器IP:端口 打开面板
代理群组（BungeeCord / Velocity）
在代理与各后端服务器都安装 Plan，共用同一个 MySQL 数据库
代理端保留 Web 面板，后端实例可关闭各自 Web 服务器（指向同一库即可）
配置 Server.IP 为本机可达地址，按官方 Wiki 完成设置

> 升级提醒：从 5.7 升级到 5.8 通常无需手动操作；5.8 移除了 plan_settings 表与 Networks 的 serverConfiguration 目录，旧版本在计划任务中报相关错误可安全忽略。若使用旧版，建议先备份数据库再升级。

近期更新
5.8+build.3605（2026-08-09）：修复多级跳转反向代理下 X-Forwarded-For 头读取错误、清理插件数据时的 SQL 语法错误、服务器性能图中 Ping 图不显示问题；修正前端"今天/昨天"显示；更新 CN 与 ZH_TW 本地化；修复 CurseForge 发布流水线
5.8+build.3579（2026-07-20）：修复数据库清理任务在无插件可清理时报错的 hotfix
5.8+build.3577（2026-07-19）：新增 MSPT Jitter 指标；重写 Performance 页与新性能指标；重构三级 Sessions 页（支持约 1 万会话、日期选择器、CSV 导出）；新增 /v1/datapoint 端点并弃用多个旧概览端点；Fabric 支持 26.2+；移除 plan_settings 表（破坏性变更）；修复 IPv6 登录、堆叠在线人数图、缓存导致的 Alternative_IP 未生效等问题
5.7（更早）：引入 DataExtension API（APIv5）逐步替代 PluginData API；新增 CoreProtect、MinigamesLib 等插件支持

> 迁移参考官方 Wiki《Migration guide from Version 5.7 to 5.8》。
安全与隐私提示
面板默认无认证，切勿未经保护直接暴露公网；建议置于 nginx 等反向代理后，启用 Basic Auth / HTTPS，或使用 VPN / 仅局域网访问。插件本身不内置 HTTPS。
玩家 IP、地理位置、行为数据属敏感信息，请按所在地法规做好访问控制与告知。
历史数据量大时首屏加载偏慢属正常渲染开销，可通过缩短数据保留期、定期清理缓解。
相关链接
官方站点：https://www.playeranalytics.net/
Modrinth：https://modrinth.com/plugin/plan
Hangar（Paper 端）：https://hangar.papermc.io/AuroraLS3/Plan-Player-Analytics
SpigotMC 资源页：https://www.spigotmc.org/resources/plan-player-analytics.32536/
GitHub 仓库：https://github.com/plan-player-analytics/Plan
官方 Wiki（配置/命令权限/API/迁移）：https://github.com/plan-player-analytics/Plan/wiki