Plan Leaves IP Intelligence

基于 Player Analytics (Plan) 的社区自定义构建，增加玩家 IP 历史、关联账号与中国省市分布分析。本仓库及其 JAR 不是 Plan 官方发布版本。

本次发布基于上游 bc9412c2d（Plan 5.9 开发分支），自定义版本为 5.9 build 3664。请从本仓库的 Releases 下载 JAR。

• 「玩家地理与分析」页面提供省份热力图、省市排行、地区玩家列表、游戏名搜索及历史 IP / 同 IP 关联账号。
• 使用本地 ip2region .xdb 解析地区；记录保存在 Plan 数据库的 plan_ip_information 表中。
• IP 收集默认关闭；页面和 /v1/ipIntelligence 接口需要 Plan Web 的 PAGE_IP_INTELLIGENCE 权限。
• 新增登录后按精确 IP 整组封禁、保留原有处罚的撤销、人工核查观察提示，见 处置与登录说明。此功能不自动封禁，不自动向已有用户组授予管理权限。
• 2026-10-13 最终定版：自定义 5.9 build 3666，处置面板采用三页签、分层卡片及手机/夜间布局，保留显式开启的 HTTP 登录兼容模式。发布包校验和及验证边界见 本次发布记录。

安装时先停止服务器、备份 plugins/Plan/，再用 Release JAR 替换 plugins/Plan.jar。保留原有数据库、ServerInfoFile.yml 和配置。启用 IP 功能、配置离线 IP 库、迁移数据库及隐私注意事项见 部署文档。不要将正式服数据或密钥上传到本仓库。

English: This is an unofficial Plan fork based on upstream commit bc9412c2d, adding an opt-in, permission-protected IP history and China region dashboard. The release JAR contains no player data or ip2region .xdb files. See the deployment guide for configuration and privacy notes.

本仓库保留原始 Git 历史及 LGPL-3.0-or-later 许可。修改不代表上游认可或维护。前端包含 Highcharts，使用时还需遵守其许可条款。

上游项目说明 / Upstream README

以下徽章、文档与发布链接指向 Plan 官方项目，不表示本仓库的构建或测试状态。

   

Documentation & Tutorials | Releases | DEV builds | Issues & Suggestions

Player Analytics is a fully-fledged solution for the analytics needs of your Minecraft server. A built-in webserver displays insights into different aspects of the server such as Online activity, Playerbase, and how these change over time.

Plan supports multiple different platforms and versions; Spigot, Paper, Fabric, Sponge, SpongeForge, Bungeecord, Velocity, Folia & all derivatives - One jar for all platforms.

• Version 5 Release trailer on Youtube

API

• Javadocs
• API documentation

<repository>
    <id>jitpack</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.plan-player-analytics</groupId>
    <artifactId>Plan</artifactId>
    <version>{jitpack version}</version>
    <scope>provided</scope>
</dependency>

Building

You can build the project by running the following in the repository root:

cd Plan
./gradlew build

• More information about setting up the project

Used Libraries

• SBAdmin 2 Template | MIT License
• Bootstrap | MIT License
• HighCharts | Free for non-commercial
• FullCalendar | MIT License
• Font Awesome Icons | SIL Open Font License
• MaxMind GeoIP2 Country | MaxMind End User License Agreement (EULA)
• Dagger | Apache-2.0 License
• DependencyDownload | MIT License

License

Player Analytics is licensed under LGPL-3 (GNU Lesser General Public License)

• License