DiscordLogger

DiscordLogger

Log every command and gamemode change from your Minecraft server directly to Discord — in real time.

23 downloads

📋 DiscordLogger

Log every command and gamemode change from your Minecraft server directly to Discord — in real time.

Paper Paper Version License


✨ Features

  • 📨 Command Logging — Every player command is sent to Discord with the player name, world, and full command
  • 🖥️ Console Logging — Server console commands are also logged
  • 🎮 Gamemode Logging — Gamemode changes are logged with old/new mode, player, world, and what triggered the change
  • 🎨 Color-coded Embeds — Each gamemode has its own color (Creative = Green, Survival = Red, etc.)
  • 🔒 Password Protection — Sensitive commands like /login and /register are ignored by default
  • Async HTTP — Webhook calls run on a separate thread so your server TPS is never affected
  • 🛠️ Live Reload — Change config without restarting the server

📸 Preview

Command Log Gamemode Change
Blue embed with player, world, command Colored embed with old → new gamemode

🚀 Installation

  1. Download DiscordLogger-1.0.0.jar
  2. Drop it into your server's /plugins/ folder
  3. Start (or restart) the server — a config file will be created automatically
  4. Open plugins/DiscordLogger/config.yml
  5. Paste your Discord Webhook URL into the url field
  6. Run /dl reload in-game or restart the server

🔗 Setting Up a Discord Webhook

  1. Open your Discord server
  2. Go to Server Settings → Integrations → Webhooks
  3. Click New Webhook
  4. Choose a channel and copy the Webhook URL
  5. Paste the URL into config.yml

⚙️ Configuration

webhook:
  url: "YOUR_WEBHOOK_URL_HERE"
  bot-name: "Minecraft Logger"
  bot-avatar: "https://i.imgur.com/wSTFkRM.png"

logging:
  commands: true
  gamemode: true
  console-commands: true
  ignored-commands:
    - "login"
    - "register"
    - "l"
    - "reg"

colors:
  command: 3447003
  gamemode-creative: 5763719
  gamemode-survival: 15548997
  gamemode-adventure: 16776960
  gamemode-spectator: 9936031

🛠️ Commands

Command Description Permission
/dl reload Reload the config file discordlogger.admin
/dl status Show plugin status discordlogger.admin
/dl test Send a test message to Discord discordlogger.admin

Aliases: /discordlogger, /dl


🔐 Permissions

Permission Default Description
discordlogger.admin OP Access to all /dl commands

📋 Requirements

  • Paper 1.21.x (also works with Spigot 1.21.x)
  • Java 21+
  • A Discord Webhook URL

🐛 Issues & Support

Found a bug or have a feature request? Open an issue on the Discord server.


Made with ❤️ by Matschi