In-game operator alerts
How in-game alerts work, which alert types appear in chat, and how to configure them in the plugin.
Updated 7 June 2026
In-game alerts send a chat message to online operators when a problem is detected. If you're in the game when something goes wrong, you'll know immediately rather than having to check email or a webhook notification.
What they look like
The message appears in chat as a formatted notification from [clan.me] with the metric and its current value. A TPS alert shows the 5-minute average and the world with the highest entity count; a memory alert shows the current heap percentage and usage in GB; an entity spike names the top worlds and how far above the 7-day baseline the count is.
Alerts are colour-coded by severity: TPS drops appear in red, memory warnings in gold, and informational alerts such as entity spikes and plugin correlations in yellow. A new player count record appears in green.
Which alerts appear in-game
clan.me evaluates your alert thresholds on the server and sends any triggered alerts back inside the heartbeat response. The plugin reads the response and broadcasts the messages to online operators. Six of the eight alert types can appear in-game:
- TPS drop
- Memory pressure
- Entity spike
- Plugin correlation
- Death spike
- Player count peak
The offline alert and the weekly retention digest are not delivered in-game. The offline alert fires when clan.me stops receiving heartbeats, so the plugin is unreachable by definition; the weekly digest is a summary email and does not map to a single in-game event.
Thresholds and per-type toggles are managed in the clan.me dashboard under Alert Settings, the same place you configure email and webhook delivery. A shared cooldown window prevents the same alert from appearing in chat more than once per window even if the condition persists.
Configuration
In-game alerts require the clan.me plugin to be installed and paired. The only plugin-side setting is a master on/off switch in config.yml:
in_game_alerts: enabled: true
Set enabled: false to stop the plugin from broadcasting in-game messages while keeping your email, webhook, and browser push channels running. Alert thresholds are configured in the dashboard, not here.
