CommandAuditor

Tested on 26.1.2

What is CommandAuditor?

CommandAuditor is your all-in-one solution for monitoring player activities on your Minecraft server. It makes tracking issued commands effortless, prevents spam, and helps maintain clear oversight over server activities. With permissions for viewing, exemptions, and easy blacklist management, admins can control exactly what is seen and logged, making server management streamlined and simple.

Why use CommandAuditor?

• No Spam, No Clutter: When players spam commands, CommandAuditor keeps your staff team's chat clean by only showing the first command until a configured threshold is met.
  
• Easily set the spam threshold to suit your needs in the config file.
• Custom Permissions: Assign permissions for viewing commands (commandauditor.see), give full admin access (commandauditor.admin), or exempt specific players (commandauditor.exempt) from being logged altogether.
• Blacklist Commands On-the-Fly: Add or remove commands from the blacklist directly in-game, ensuring that sensitive commands remain private and are not logged.
• Fully Customizable: Customize everything from colors to messages, including full hex color support.

Commands - /ca or /commandauditor

• enable: Enables CommandAuditor for you.
• disable: Disables CommandAuditor for you.
• add : Adds a command to the blacklist.
• remove : Removes a command from the blacklist.
• reload: Reloads the CommandAuditor's configuration.
• /ca: Displays the help menu.

Permissions:

• commandauditor.see: Allows users to enable or disable command viewing for themselves.
• commandauditor.admin: Grants full access to all commands and features.
• commandauditor.exempt: Excludes specific players or groups from having their commands logged.

Example of config.yml:

# Configuration for CommandAuditor plugin

# Enable or disable debugging (set to true to show debug logs in the console)
enable-debugging: false

# The threshold for how many times a command must be repeated before a summary message is shown
spam-threshold: 5

# List of commands that should be ignored by the plugin. These commands will not be logged.
blacklisted-commands:
  - examplecommand1
  - examplecommand2

# Colors for messages in the chat (can be customized with valid color codes)
colors:
  prefix: "👁#FB8208[#E0B204C#C4E100A#FB8208]"  # Prefix for messages sent to players
  player-name: "&6"  # Color for player names
  command: "&a"  # Color for the command shown
  count-suffix: "&7[%count%x]"  # Color and format for the repeat count suffix, e.g., "[5x]"

# Message settings (optional customization)
messages:
  enabled: "Command viewing enabled."
  disabled: "Command viewing disabled."
  issued-command: "#dbff33issued command: "
  reload-success: "CommandAuditor configuration reloaded."
  add-success: "Command '%command%' added to the blacklist."
  remove-success: "Command '%command%' removed from the blacklist."
  already-blacklisted: "The command '%command%' is already on the blacklist."
  not-found: "The command '%command%' was not found on the blacklist."
  permission-denied: "You do not have permission to use this command."
  usage-add: "Usage: /<command> add <command>"
  usage-remove: "Usage: /<command> remove <command>"
  usage-general: "Use /<command> enable, disable, add <command>, remove <command>, or reload."

For help, feedback or tips join my discord: https://discord.gg/GXvTjq78mP