Documentation
Everything you need to install, configure and use DiscordLogger.
On this page
Overview
DiscordLogger logs every command and gamemode change from your Minecraft server directly to Discord, in real time.
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 and new mode, player, world and what triggered the change.
Color-coded Embeds
Each gamemode has its own color (Creative = green, Survival = red, Adventure = yellow, Spectator = gray).
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 the config without restarting the server.
Requirements
- Paper 1.21.x or newer (also works with Spigot)
- Java 21 or newer
- A Discord webhook URL
Installation
- 1Download the latest DiscordLogger .jar file.
- 2Drop it into your server's /plugins/ folder.
- 3Start (or restart) the server. A config file is created automatically.
- 4Open plugins/DiscordLogger/config.yml.
- 5Paste your Discord webhook URL into the url field.
- 6Run /dl reload in-game or restart the server.
Setting up a Discord webhook
- 1Open your Discord server.
- 2Go to Server Settings → Integrations → Webhooks.
- 3Click "New Webhook".
- 4Choose a channel and copy the webhook URL.
- 5Paste the URL into config.yml.
Never share your webhook URL publicly. Anyone who has it can post messages in your channel. If it leaks, delete the webhook in Discord and create a new one.
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: 9936031Config options
| Option | Description |
|---|---|
| webhook.url | Your Discord webhook URL. |
| webhook.bot-name | Name shown for the webhook messages. |
| webhook.bot-avatar | Avatar image URL for the webhook messages. |
| logging.commands | Log player commands (true/false). |
| logging.gamemode | Log gamemode changes (true/false). |
| logging.console-commands | Log console commands (true/false). |
| logging.ignored-commands | Commands that are never logged (without the slash). |
| colors.* | Embed colors as decimal numbers. |
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 |
Need help? Visit the Help Center or join our Discord.