DiscordLogger
PluginMIT

DiscordLogger

Minecraft plugin to log server events to Discord via a webhook

40
Downloads
1
Followers
5 months ago
Updated
📦
1
Versions

📖About DiscordLogger

DiscordLogger

A minimal, reliable Minecraft server logging plugin that posts clean messages to a Discord webhook — in Markdown or rich embeds.
Built for Paper/Spigot 1.21+, tested with Geyser/Floodgate (Bedrock cross-play).


✨ Features

  • Discord webhook logging
    • Plain text + Markdown format: `HH:mm:ss dd:MM:yyyy` - **<Category>**: <message>
    • Embeds (optional) with per-category colors, configurable author, player avatar thumbnails, server icon, and timestamps.
  • Config-toggleable events (all on by default):
    • Server: Start, Stop, Server Command e.t.c.
    • Player: Join, Quit, Chat, Command, Death e.t.c.
    • Moderation: Ban, Unban, Kick, Op, Deop, Whitelist Toggle, Whitelist Add/Remove e.t.c.
  • Live reload command: /discordlogger reload (perm: discordlogger.reload)
  • Geyser-friendly death messages: built from server-side damage context (not client-localized text).
  • Automatic Config Updater: Updates the config.yml file with new features
  • Automatic update prompts: Plugin will prompt you when a new version is available
  • Nickname support: Nicknames are recognized in server logs

📦 Installation

  1. Download the latest release and place the JAR in your server’s plugins/ folder.
  2. Start the server once to generate plugins/DiscordLogger/config.yml.
  3. Edit config.yml and set a valid Discord webhook URL at webhook.url.
  4. (Optional) Adjust the timestamp format and per-event toggles under log.*, and set embeds.enabled: true to use embeds.
  5. Restart the server (or run /discordlogger reload after editing config).

Note: If webhook.url is empty/invalid, the plugin will not function until set.


🔌 Compatibility

  • Server: Paper/Spigot 1.21+ (Tested on 1.21.8 Paper)
  • Java: 21+
  • Cross-play: Compatible with Geyser/Floodgate — death messages are server-generated for consistency across Java/Bedrock names/locales.