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.

Paper 1.21.xPaper 26.2Paper 26.3 (Beta)License MITv1.0.2-BETA

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

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

Setting up a Discord webhook

  1. 1Open your Discord server.
  2. 2Go to Server Settings → Integrations → Webhooks.
  3. 3Click "New Webhook".
  4. 4Choose a channel and copy the webhook URL.
  5. 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: 9936031

Config options

OptionDescription
webhook.urlYour Discord webhook URL.
webhook.bot-nameName shown for the webhook messages.
webhook.bot-avatarAvatar image URL for the webhook messages.
logging.commandsLog player commands (true/false).
logging.gamemodeLog gamemode changes (true/false).
logging.console-commandsLog console commands (true/false).
logging.ignored-commandsCommands that are never logged (without the slash).
colors.*Embed colors as decimal numbers.

Commands

CommandDescriptionPermission
/dl reloadReload the config filediscordlogger.admin
/dl statusShow plugin statusdiscordlogger.admin
/dl testSend a test message to Discorddiscordlogger.admin

Aliases: /discordlogger, /dl

Permissions

PermissionDefaultDescription
discordlogger.adminOPAccess to all /dl commands

Need help? Visit the Help Center or join our Discord.