What is DiscordLink?
DiscordLink is a Discord bot designed for Rust gaming communities. It securely links Discord users to their Steam accounts, automates in-game reward distribution, and manages special perks for linked players and server boosters. The bot integrates with Rust servers via RCON and supports multiple servers.
Key Features
- Steam Account Linking: Users can link their Discord and Steam accounts for in-game rewards.
- Booster Perks: Automatically grants and removes special in-game perks for Discord server boosters.
- Role Management: Assigns a custom Discord role to users who link their Steam account.
- Multi-Server Support: Works with multiple Rust servers at once.
- Automated Reminders: Notifies boosters who haven't linked their Steam account.
- Admin Tools: Commands for checking, resetting, and auditing links and perks.
- Secure & Auditable: All actions are logged for transparency and troubleshooting.
How It Works
1. User Links Account:
- Users type /link <steam_id> in the designated Discord channel.
- The bot validates the Steam ID and links it to the user's Discord account.
- The user receives in-game rewards on all connected Rust servers.
2. Booster Perks:
- If a user is a Discord server booster, the bot automatically grants them special in-game perks (e.g., Nitro group) on all servers.
- If a booster stops boosting, perks are removed automatically.
3. Reminders:
- Boosters who haven't linked their Steam account receive periodic reminders (can be disabled).
4. Admin Controls:
- Admins can check, reset, or audit user links and booster perks with slash commands.
Main Commands
- /link <steam_id> – Link your Discord and Steam accounts for rewards.
- /checklink – See your current link and booster status.
- /reminders <on|off> – Enable or disable booster reminders.
- /status – (Admin) Show server and user stats.
- /reset <user> – (Admin) Reset a user's links, perks and cooldowns for changing the SteamID associated with the discord user.
- /checklinks <user> – (Admin) Check a user's linked Steam IDs and booster status.
Configuration
For Server Admins
- Set up the bot using the .env file and follow the install guide.
- Make sure the bot has the right permissions and intents in your Discord server.
- Use admin commands to manage and audit user links and perks.
Environment Variables
The bot uses a .env file for configuration. This file contains sensitive information like API keys and server credentials, so it should never be committed to version control.
Why .env files?
- Security: Keeps sensitive data separate from code
- Flexibility: Easy to configure different settings for development and production
- Standard Practice: Widely used in Python applications and deployment platforms
Configuration Options:
- RCON Timeouts: Configure WebSocket timeouts via `RCON_CONNECTION_TIMEOUT`, `RCON_OPERATION_TIMEOUT`, and `RCON_USERGROUP_TIMEOUT`
- Server Settings: Add multiple Rust servers with `SERVER1_NAME`, `SERVER1_HOST`, etc.
- Discord Settings: Configure roles, channels, and permissions
- Steam Integration: Steam API key for SteamID validation
For Users
- Use /link <steam_id> in the correct channel to get in-game rewards.
- If you boost the server, your perks are managed automatically.
- Use /checklink to see your status or /reminders off to stop reminders.
Support
- For help, check `bot.log` or contact me.
