How basematter/mctpsalert works
MC TPS Alert pairs a NeoForge server mod with an AstrBot plugin. The mod periodically samples TPS, applies configured alert rules, and posts samples or alerts to the plugin; the plugin stores samples and offers a history-chart tool, while alert messages can be broadcast to configured groups. The excerpts show configuration, command dispatch, sampling, webhook handling, persistence, and chart generation. The alert-to-broadcast handoff is not visible in the sampled lines, so that relationship is marked unverified.
Main entry points: MCTpsAlert.java Mod registration · TpsMonitor.java TPS monitor · main.py Webhook endpoint · ModCommands.java Debug commands
Components 12
Minecraft server mod
- Mod registration
mctpsalert/src/main/java/com/basem/mctpsalert/MCTpsAlert.java - Server settings
mctpsalert/src/main/java/com/basem/mctpsalert/Config.java - Debug commands
mctpsalert/src/main/java/com/basem/mctpsalert/ModCommands.java - TPS monitor
mctpsalert/src/main/java/com/basem/mctpsalert/TpsMonitor.java
AstrBot plugin
- Webhook endpoint
astrbot_plugin_mctps_alert/main.py
History and charts
- TPS history
astrbot_plugin_mctps_alert/main.py - History chart tool
astrbot_plugin_mctps_alert/main.py
Message delivery
- Group broadcast
astrbot_plugin_mctps_alert/main.py
Other components
- Server operator
- Spark API
- AstrBot user
- Target groups
Connections 13
- Server operator → Mod registration: configures
- Mod registration → Server settings: registers
mctpsalert/src/main/java/com/basem/mctpsalert/MCTpsAlert.java - Mod registration → TPS monitor: registers events
mctpsalert/src/main/java/com/basem/mctpsalert/MCTpsAlert.java - Mod registration → Debug commands: registers events
mctpsalert/src/main/java/com/basem/mctpsalert/MCTpsAlert.java - Debug commands → TPS monitor: dispatches
mctpsalert/src/main/java/com/basem/mctpsalert/ModCommands.java - TPS monitor → Spark API: samples TPS
mctpsalert/src/main/java/com/basem/mctpsalert/TpsMonitor.java - TPS monitor → Webhook endpoint: posts events
mctpsalert/src/main/java/com/basem/mctpsalert/TpsMonitor.java - Webhook endpoint → TPS history: stores samples
astrbot_plugin_mctps_alert/main.py - AstrBot user → History chart tool: requests chart
- History chart tool → TPS history: queries history
astrbot_plugin_mctps_alert/main.py - History chart tool → Group broadcast: sends message
astrbot_plugin_mctps_alert/main.py - Group broadcast → Target groups: broadcasts to
astrbot_plugin_mctps_alert/main.py - Webhook endpoint → Group broadcast: dispatches alerts
astrbot_plugin_mctps_alert/main.py