Discord Command Bridge

Streamline your workflow and manage your server efficiently from anywhere. This plugin seamlessly integrates your Minecraft server with Discord, empowering your staff to execute vital in-game commands directly from a secure Discord channel.

Perfect for Remote Administration: Handle moderation, player management, and emergency server fixes on the go without needing to launch Minecraft or log into a clunky panel.

---

🛠️ Key Features At A Glance

Feature	What It Does	Why It Matters
Remote Console Power	Run core commands (/ban, /kick, /tp) directly from Discord.	Zero lag, instant execution as if typed directly into the server console.
Granular Role Mapping	Pair specific Discord roles to exact list of allowed Minecraft commands.	Total security. Keep junior staff restricted while giving senior admins full access.
Channel Locking	Restrict the bot's listening capability to a single, hidden channel.	Prevents regular players from seeing staff activity or trying to spam commands.
Instant Feedback	Returns real-time execution success, format errors, or permission denials.	Staff always know if their command went through or if it failed.

---

🧭 How It Works: The Lifecycle of a Command

The process moves from Discord to Minecraft and back in milliseconds. Here is exactly how the plugin handles a remote request:

1. Command Received: Discord Side.
   An authorized staff member types a command in the designated channel using your custom prefix.
   Example: .kick Notch "Griefing"

2. Security Check: Internal Guard.
   The plugin intercepts the message and crosses-checks the user's highest Discord role against your config.yml permissions layout.

3. Console Execution: Minecraft Side.
   If authorized, the plugin pushes the command to the Minecraft server pool, executing it instantly with Console-level privileges.

4. Status Report: Discord Side.
   The bot replies to the channel. It provides a green success message (e.g., Command executed: kick Notch...) or a red denial alert if permissions were lacking.

---

🔐 Permission Hierarchy Example

You can customize permissions precisely in the config.yml. The plugin evaluates roles strictly, and even supports a wildcard (*) for ultimate control. Here is a common setup model:

• Discord Role: @Admin

• Allowed Commands: * (Full console access)

• Discord Role: @Moderator

• Allowed Commands: kick, ban, mute, tempban

• Discord Role: @Helper

• Allowed Commands: tp, warn, history

---

⚙️ Quick Configuration Preview

Setting up your bridge takes less than two minutes. Your config.yml handles everything seamlessly:

# Discord Command Bridge Configuration
bot-token: "YOUR_DISCORD_BOT_TOKEN_HERE"
command-prefix: "." # Change to !, /, or whatever fits your style
channel-id: "123456789012345678" # Restrict bot execution to this channel only

# Map your Discord Role IDs to allowed Minecraft commands (exclude the slash)
role-mappings:
  "987654321098765432": # Admin Role ID
    - "*"
  "876543210987654321": # Mod Role ID
    - "kick"
    - "ban"
    - "warn"