DiscordRcon

DiscordRcon is a V Rising dedicated server mod that bridges Discord to your game server via ScarletRCON. It provides /rcon and /help slash commands with role-based access control, so you can manage your server from Discord without giving everyone admin access.

Features

• /rcon Command - Execute any RCON command directly from Discord. Supports base commands and plugin commands with dotted names (e.g., examplemod.player.mute).
• /help Command - Browse all available RCON commands or get details for a specific command. Uses a cached command index with smart search: exact match, prefix matching (e.g., /help command: examplemod.player lists all player subcommands), and substring fallback.
• "Did You Mean?" Suggestions - If an unknown command is entered via /rcon, the bot searches the command index and suggests similar commands.
• Role-Based Access Control - Configure which Discord roles can use which commands via a simple JSON config. Admin roles grant access to everything; per-command roles add granular control.
• ANSI to Markdown Conversion - Terminal color codes are converted to Discord markdown (bold for headers, plain text for descriptions).
• Connect-Per-Command RCON - Each command opens a fresh RCON connection and closes it immediately after. Doesn't hog the connection slot, so you can still use your own RCON client alongside the bot.
• Automatic Command Indexing - On startup, the bot queries the server for available commands and builds a searchable index. No manual configuration needed.
• Long Response Handling - Responses over 2000 characters are split into multiple Discord messages using webhook followups.
• Custom Slash Commands - Define your own slash commands in a JSON config that map to any RCON command. Great for shortcuts to frequently used commands.

Requirements

• BepInEx for V Rising IL2CPP
• ScarletRCON (hard dependency - DiscordRcon will not load without it)
• A Discord bot with the Server Members Intent privileged intent enabled

How ScarletRCON Is Used

V Rising servers include a built-in RCON server, but it has limited functionality. ScarletRCON enhances it by allowing server mods to register custom RCON commands and providing a better help system. DiscordRcon depends on ScarletRCON for these features:

• Command Execution - All commands sent via /rcon and custom slash commands are forwarded through ScarletRCON's enhanced RCON server, which routes them to the appropriate mod handlers.
• Command Discovery - On startup, DiscordRcon runs ScarletRCON's help command to discover all registered commands (including those from other mods) and build a searchable index for /help and "Did you mean?" suggestions.
• Response Formatting - ScarletRCON returns command output with ANSI terminal color codes, which DiscordRcon converts to Discord markdown.
• Connection Model - ScarletRCON only allows one RCON connection at a time, so DiscordRcon opens a fresh connection per command and closes it immediately after, leaving the slot free for other RCON clients. Commands from multiple Discord users are automatically queued and processed one at a time.

Commands

Command — Description — Example

/rcon command: — Execute any RCON command — /rcon command: kick fryke

/help — Show all available RCON commands — /help

/help command: — Show help for a specific command — /help command: examplemod.player.mute

Custom Commands

Custom slash commands are configured in BepInEx/config/DiscordRcon/discordrcon_commands.json. This file is created automatically on first run with some common defaults:

[
  {
    "name": "kick",
    "description": "Kick a player from the server",
    "rconCommand": "kick"
  },
  {
    "name": "ban",
    "description": "Ban a player from the server",
    "rconCommand": "ban"
  },
  {
    "name": "listplayers",
    "description": "List all online players",
    "rconCommand": "listplayers"
  }
]

You can add your own shortcuts for plugin commands too:

[
  {
    "name": "mute",
    "description": "Mute a player",
    "rconCommand": "examplemod.player.mute"
  }
]

• name - The slash command name (e.g., /kick). Must be lowercase, 1-32 characters, and can only contain letters, numbers, hyphens, and underscores. Cannot be rcon or help.
• description - Shown in Discord's command picker.
• rconCommand - The RCON command to execute. Permission checks use this value, not the slash command name.

Each custom command gets an arguments option in Discord. For example, /kick arguments: fryke would run kick fryke via RCON.

Custom commands share the same permission system as /rcon - access is controlled by the rconCommand value in discordrcon_roles.json.

Role Configuration

Role access is configured in BepInEx/config/DiscordRcon/discordrcon_roles.json. This file is created automatically on first run.

{
  "adminRoles": [
    "1505734816149274734"
  ],
  "commandRoles": {
    "kick": ["1505734816149274734", "1234567890123456789"],
    "ban": ["1234567890123456789"],
    "examplemod.player.mute": ["1234567890123456789"]
  }
}

• adminRoles - Discord role IDs that can use every command. Users with one of these roles bypass per-command restrictions.
• commandRoles - Per-command role grants. Use the full RCON command path (e.g., `examplemod.player.