ASPA
(高级服务器性能分析)
ASPA 是一款 Spigot 插件,可将你的服务器转变为性能分析平台。它持续捕获实时健康指标、玩家会话行为以及长期趋势,并提供内置的 Web 仪表板和 REST API 以提供可操作的洞察。
这是一个测试版(快照)版本。请预期会有快速迭代、功能不完整以及潜在的破坏性更改。
贡献
欢迎为开发做出贡献。请随时在 GitHub 上联系我。
主要功能
- 实时服务器健康状态:TPS、MSPT、CPU、内存、GC、延迟、实体数量和加载区块数
- 具有异常检测和关联因素分析的历史指标
- 玩家分析:留存队列、热力图、地理分布和会话统计
- 用于预测玩家活动高峰时段的预测引擎
- 带身份验证和用户/角色权限的嵌入式 Web 仪表板
- 可选的 Pterodactyl 集成(电源操作、控制台命令、备份)
- 灵活的存储支持:SQLite、MySQL 或 MongoDB
- GeoIP 支持(MaxMind)以获取国家和时区洞察
工作原理
ASPA 作为单个插件运行,按可配置的间隔收集指标,将其存储在数据库中,并通过本地 HTTP 服务器暴露这些指标。Web UI 直接由插件提供服务,因此不需要单独的 Web 主机。
命令与权限
- /aspa [reload|status|token]
- 权限:aspa.admin(默认:op)
设置说明
- 安装插件并启动服务器一次以生成默认配置文件。
- 在 config.yml 中配置数据库和 API 令牌。
- (可选)将 GeoLite2-City.mmdb 添加到插件数据文件夹以启用 GeoIP。
- (可选)启用 Pterodactyl 集成并设置凭据。
兼容性
- Spigot/Paper 1.20+
- Java 21+
测试版免责声明
此快照构建仅用于测试和反馈目的。请确保使用备份,因为随着项目的成熟,配置或数据库更改是不可避免的。
请注意,此版本和描述可能并不总是反映当前的开发状态。
ASPA
(Advanced Server Performance Analysis)
ASPA is a Spigot plugin that turns your server into a performance analytics platform. It continuously captures live health metrics, player session behavior, and long-term trends, then serves a built-in web dashboard and REST API for actionable insights.
This is a beta (snapshot) release. Expect rapid iteration, incomplete features, and potential breaking changes.
Contributions
Contributions to development are welcome. Feel free to me out on GitHub.
Key Features
- Live server health: TPS, MSPT, CPU, RAM, GC, ping, entities, and loaded chunks
- Historical metrics with anomaly detection and correlated factor analysis
- Player analytics: retention cohorts, punchcard heatmaps, geographic distribution, and session stats
- Forecasting engine for peak player activity windows
- Embedded web dashboard with authentication and user/role permissions
- Optional Pterodactyl integration (power actions, console commands, backups)
- Flexible storage: SQLite, MySQL, or MongoDB
- GeoIP support (MaxMind) for country/timezone insights
How It Works
ASPA runs as a single plugin that collects metrics at a configurable interval, stores them in a database, and exposes them through a local HTTP server. The web UI is served directly from the plugin, so no separate web host is required.
Commands and Permissions
- /aspa [reload|status|token]
- Permission: aspa.admin (default: op)
Setup Notes
- Install the plugin and start the server once to generate the default config.
- Configure your database and API token in config.yml.
- (Optional) Add GeoLite2-City.mmdb to the plugin data folder for GeoIP.
- (Optional) Enable Pterodactyl integration and set credentials.
Compatibility
- Spigot/Paper 1.20+
- Java 21+
Beta Disclaimer
This snapshot build is intended for testing and feedback purposes. Please ensure you use backups, as configuration or database changes are to be expected as the project matures.
Note that this version and description may not always reflect the current state of development.
评论 0
登录后参与评分
还没有评论,来抢沙发吧