CommandWebhookLogger

⚙️ CommandWebhookLogger
Accurate, Real-Time Command Logging for Discord

ℹ️About

CommandWebhookLogger is a powerful, open source, efficient Minecraft plugin designed to log all types of player commands, successful, permission-denied, and unknown commands directly to Discord via webhooks. Get granular visibility into server activity and command abuse in real-time.

Plugin is tested on paper 1.21.10. It most probably works on all versions. I am not responsible for any damage done to your server or devices.

Why CommandWebhookLogger is Different
This plugin doesn't rely on less accurate Bukkit events. Instead, it utilizes the ProtocolLib API to intercept command packets the moment a player sends them.

This method guarantees:

1. Accuracy: Logs commands even if they are cancelled by other plugins
2. Completeness: Captures the true, full command string exactly as the player typed it.
3. Efficiency: Asynchronous webhook sending prevents server lag.

⚖️Legal & Notice

Distributing this plugin without written permission from the author is not allowed. Source code is provided on Github, you may change it or make additions to it, if you refer people to this plugin too. I am not responsible for any damage done to your server or devices. Full legal notice is on Github. ️

Key Features & Advanced Functionality

1. Core Command Logging

The plugin provides three dedicated log categories, each with its own webhook URL and embed template for optimal organization and filtering:

• Executed Command Logging: Captures commands that successfully passed all checks and were executed on the server. This is essential for tracking administrative actions and standard player usage.
  
  
• Permission Denied Logging: Records every attempt by a player to use a command for which they lack the necessary permissions. This is crucial for monitoring potential permission exploits, mistakes, or unauthorized command attempts.
  
  
• Unknown Command Logging: Logs any text starting with a slash (/) that the Minecraft server does not recognize. This is invaluable for catching typos, server probing attempts, and suspicious activity.

2. Utility Features

• Fully Customizable Embeds: Gain complete control over how logs appear in Discord. You can configure custom titles, colors (using the Discord decimal integer format), footers, and timestamps for all three log categories directly in the config.yml.
  
  
• In-Game Configuration Reload: Easily update your webhook URLs or embed designs without causing server downtime. Simply use the command /commandwebhooklogger reload to apply all configuration changes instantly.

Dependencies & Integrations

CommandWebhookLogger requires one core dependency for its functionality and offers seamless integration with two popular plugins for enhanced features.

⚠️ Essential Dependency: ProtocolLib

To function, CommandWebhookLogger requires the ProtocolLib plugin, as it handles the packet interception magic. Please ensure it is installed on your server before using this plugin.

• Download ProtocolLib here, and install to plugins/ folder on your server.

Optional Addons (Soft Dependencies)

These plugins are entirely optional. If you use them, CommandWebhookLogger will automatically detect them and enable advanced logging placeholders. If they are not present, the plugin will function normally, but the corresponding placeholders will show "Not available."

• Discord Mentions
  • Required Addon: DiscordSRV (Will also require you to enable linking for the placeholder to appear as the discord mention)
    
    
  • Placeholder: %discord_mention%
    
    
  • Description: Displays the player's linkable Discord ID, allowing moderators to quickly mention and contact the player.
• Permission Group
  • Required Addon: LuckPerms
    
    
  • Placeholder: %group%
    
    
  • Description: Shows the player's primary group name (e.g., 'Admin' or 'Member') directly in the log embed, providing immediate context on their rank.

⚙️ Installation & Setup

1. Download: Download the latest CommandWebhookLogger JAR file and put the file in your plugins/ folder.
   
   
2. Install ProtocolLib: Ensure the ProtocolLib JAR is in your server's plugins/ folder.
   
   
3. Discord Webhook: Create a new webhook in your desired Discord channel settings. You will need this URL.
   
   
4. Configuration: Start your server once to generate the config.yml file in the plugins/CommandWebhookLogger/ folder.
   
   
5. Edit config.yml: Info on how to configure the config.yml is present in .yml.
   
   
6. Reload: Use "/commandwebhooklogger reload" or restart your server.

❤️ Support, Questions, & Donations
This plugin is provided completely free of charge. If you have questions, need help, want to give feedback, or just want to chat:

Add me on Discord!
(Click here to contact me on Discord!)

If you find this plugin valuable and wish to support future free projects, donations are always optional but deeply appreciated! Contact me on Discord if you'd like to support. ❤️

Source Code
The complete source code is available on GitHub! Developers are more than welcome to explore the inner workings of the packet interception mechanism and contribute fixes or new features.