About Discord Players & Wipes Alerts
Discord Players & Wipes Alerts is a real-time monitoring bot for Rust servers written in Python that displays live player counts on Discord and automatically detects map wipes by tracking the server seed.
The bot connects directly to the Rust WebRCON and keeps your Discord server continuously updated with accurate server information. When a wipe happens and the server restarts, the bot detects the new map seed and sends a notification to a designated Discord channel.
All configuration is handled through a .env file, making the bot easy to customize and deploy on any server.
Features:
- Displays the current number of players online in the Discord bot presence
- Automatically reconnects to WebRCON when the Rust server restarts
- Detects map wipes by monitoring changes in the server.seed value
- Sends wipe notifications to a specific Discord channel
- Stores the last known seed to avoid duplicate wipe alerts
- Handles long server startup times on large or heavily modded maps
- Fully configurable through environment variables
How it works?
The bot maintains a persistent connection to the Rust WebRCON.
When the server restarts, the WebRCON connection drops and reconnects automatically. This reconnect is used as a trigger to verify whether a new map seed is active.
After reconnecting, the bot waits until the Rust server is fully operational. It then runs the server.seed command and compares the result with the previously stored seed. If the seed has changed, a wipe is detected and a notification is sent to Discord.
This approach guarantees reliable wipe detection even on servers that take a long time to load their maps.
Required configuration
The following environment variables must be set in the .env file for the bot to function correctly:
- DISCORD_TOKEN=The Discord bot token. This allows the bot to connect to Discord and update its presence and send messages.
- RUST_RCON_HOST=The IP address or hostname of the Rust server WebRCON.
- RUST_RCON_PORT=The WebRCON port of the Rust server.
- RUST_RCON_PASSWORD=The WebRCON password used to authenticate with the Rust server.
- SEED_CHANNEL_ID=The Discord channel ID where wipe alerts will be sent.
- SEED_CHANGE_MESSAGE=The message sent when a wipe is detected. You can use {old_seed} and {new_seed} as placeholders in the message.
Example:
- SEED_CHANGE_MESSAGE=Map wipe detected. Old seed: {old_seed} -> New seed: {new_seed}
