LPDiscordLogger

LPDiscordLogger

LPDiscordLogger is a Paper plugin that logs specific commands executed by players in a chosen LuckPerms group and forwards those logs to a Discord channel via a webhook. It helps server owners monitor important or sensitive administrative actions.

Features

• Command Logging
  Tracks and logs commands executed by players in a specified LuckPerms group.

• Discord Webhook Support
  Sends command logs directly to a Discord channel using a configured webhook URL.

• Highly Configurable
  Customize the target LuckPerms group, the Discord webhook URL, and the list of ignored commands through config.yml.

• Reloadable Configuration
  Apply configuration changes at runtime using the /lpdiscordreload command, without restarting the server.

Prerequisites

• Minecraft Server running Paper or another compatible PaperMC-based API
• LuckPerms installed and configured
• Java 17 or newer on the server

Installation

1. Download the Plugin
   Get the latest release from:

   • GitHub
   • Modrinth

2. Place in Plugins Folder
   Move LPDiscordLogger.jar into your server's plugins directory.

3. Start the Server
   Launch the server. A default config.yml will be generated in plugins/LPDiscordLogger.

4. Configure the Plugin
   Edit plugins/LPDiscordLogger/config.yml as needed:

   • discordWebhookUrl: Your Discord webhook URL
   • targetGroup: The LuckPerms group to monitor (e.g., admin)
   • ignoredCommands: A list of command prefixes to exclude from logging (e.g., /msg, /whisper)

5. Reload the Configuration
   Apply your changes instantly using /lpdiscordreload in-game or through the console.

Configuration

Example config.yml:

discordWebhookUrl: "https://discord.com/api/webhooks/your_webhook_url"
targetGroup: "admin"
ignoredCommands:
  - "/msg"
  - "/whisper"
  - "/tell"