// documentation

Docs / LiveConsole

Discord webhooks, bot integration & full configuration.

simple_setup

Use a single webhook for all notifications.

discord:
  webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

discord-bot:
  enabled: false   # Optional - enable later if needed

advanced_setup

Separate webhooks per message type for better organization.

discord:
  webhooks:
    console-logs:        "https://discord.com/api/webhooks/.../TOKEN1"
    player-events:       "https://discord.com/api/webhooks/.../TOKEN2"
    suspicious-activity: "https://discord.com/api/webhooks/.../TOKEN3"
    server-control:      "https://discord.com/api/webhooks/.../TOKEN4"
    suspect-users:       "https://discord.com/api/webhooks/.../TOKEN5"  # NEW in 2.0.1

  # Custom mentions per webhook type (NEW in 2.0.1)
  webhook-mentions:
    console-logs: []
    player-events: []
    suspicious-activity: ["123456789012345678"]   # Admin Discord IDs
    server-control: []
    suspect-users: ["123456789012345678"]         # Mentions for suspect alerts

  # Console error highlighting (NEW in 2.0.1)
  console-errors-in-red: true

  # Server control message options
  server-control-show-players: true
  server-control-show-timestamp: true
  server-icon-url: ""                            # Optional: image URL for start/stop

server_icon

Add a custom image to server startup & shutdown notifications.

discord:
  server-icon-url: "https://i.imgur.com/yourimage.png"

discord_bot_setup

The Discord bot enables remote server control directly from Discord — execute commands, stop / restart, list players, view status.

Step 1 — Create the bot application

  1. Visit Discord Developer Portal
  2. Click New Application
  3. Set a name (e.g. "LiveConsole Bot")
  4. Navigate to Bot → click Add Bot
  5. Under Privileged Gateway Intents, enable: MESSAGE CONTENT INTENT (required), SERVER MEMBERS INTENT, PRESENCE INTENT
  6. Click Reset Token → copy the token

Step 2 — Invite the bot

  1. Go to OAuth2 → URL Generator
  2. Select bot scope
  3. Bot permissions: Send Messages, Read Messages, Embed Links
  4. Copy the generated URL and open it
  5. Invite the bot to your Discord server

Step 3 — Configure config.yml

discord-bot:
  enabled: true
  token: "YOUR_BOT_TOKEN_HERE"
  command-channel-id: "123456789012345678"   # Channel ID
  command-prefix: "!"

  # Authorized Discord user IDs
  authorized-users:
    - "987654321098765432"   # Your Discord ID

How to get Discord IDs

  1. In Discord, go to Settings → Advanced
  2. Enable Developer Mode
  3. Right-click a channel → Copy ID (for command-channel-id)
  4. Right-click your username → Copy ID (for authorized-users)

Step 4 — Last step

Add the LiveConsole role inside your channel (only one channel).

bot_commands

  • !execute <cmd>Execute a server command (aliases: !exec, !exe)
  • !stopStop the server
  • !restartRestart the server
  • !playersShow online players (alias: !list)
  • !statusShow server status (TPS, memory, etc.)
  • !helpDisplay help message

Only authorized users (configured in authorized-users) can use these commands.

compatibility

  • Minecraft1.18.2 → 26.1.2
  • ServerPaper, Spigot, Purpur (and compatible forks)
  • Java17+ (21 recommended for optimal performance)