Installation
- Download the DiscordLogger plugin JAR.
- Place the JAR file in your server’s plugins/ folder.
- Start the server once — this will generate the config.yml file inside plugins/DiscordLogger/.
- Open config.yml in a text editor and adjust the settings to your needs.
- Restart the server or run /discordlogger reload to apply changes.
Configuration (config.yml)
The configuration file is split into sections for webhook setup, formatting, embed styling, and event logging.
Webhook Options
webhook:
url: "" # Discord webhook URL goes here, plugin will not function until present
- Set your Discord webhook URL here.
- Without this, the plugin will not send any messages.
Format Options
format:
time: "[HH:mm:ss, dd:MM:yyyy]"
name: ""
- time: Timestamp format for plain text messages (case-sensitive placeholders).
- HH = hours, mm = minutes, ss = seconds, dd = day, MM = month, yyyy = year
- name: Display name used in plain text messages (embeds use the author name instead).
Embed Options
embeds:
enabled: true
author: "Server Logs"
colors:
server: "#43B581"
player_join: "#57F287"
player_quit: "#ED4245"
player_chat: "#5865F2"
player_command: "#FEE75C"
server_command: "#EB459E"
player_death: "#ED4245"
- enabled: Sends messages as Discord embeds (true) or plain text (false).
- author: Text shown in the embed header (useful for multiple servers/proxies).
- colors: Define per-category embed colors using HEX codes. Keys match event types.
Logging Options
log:
player:
join: true
quit: true
chat: true
command: true
death: true
server:
command: true
start: true
stop: true
- player.join: Logs when players join.
- player.quit: Logs when players leave.
- player.chat: Logs chat messages.
- player.command: Logs commands executed by players.
- player.death: Logs player deaths with their death messages.
- server.command: Logs commands executed from the console/terminal.
- server.start: Logs when the plugin/server starts.
- server.stop: Logs when the server stops.
Usage
- Once configured, DiscordLogger automatically sends events to the linked Discord channel.
- Use /discordlogger reload after editing the config to apply changes without restarting.
- Adjust embed colors and formats to fit your server’s branding or readability preferences.