CommandLogger

Version: 1.0.0

Author: Nickotato

Minecraft Versions: 1.21.11+ (Paper)

---

Overview

CommandLogger is a lightweight Minecraft plugin designed to help keep server operators accountable to the players. It logs important commands and operator actions to the chat, which helps detect potential abuse. It is designed for competitive servers or servers where operators play as the players.

---

Features

Command Logging

Tracks execution of important commands:

Command	Description
/gamemode / /gm	Logs when a player or operator changes a gamemode.
/give	Logs items given to players.
/effect	Logs potion effects applied to players.
/enchant	Logs item enchantments, including nearby players.
/attribute	Logs changes to player attributes.
/experience / /xp	Logs XP given to players.
/clear	Logs inventory clears.
/kill	Logs kills executed via commands.
/tp / /teleport	Logs teleport usage (ignores spectators).

Operator Item Drop Logging

• Logs when operators drop items.
• Captures item type, quantity, and nearby players within 10 blocks.
• Only tracks operators to reduce unnecessary logs.

Feature Toggling via GUI

• All features can be toggled on/off using a simple in-game setup GUI.
• Changes persist between server restarts.
• Green wool = enabled, red wool = disabled.
• To use type:

/command_logger_setup

---

Example Logs

⚠ Steve gave 64 x DIAMOND to Alex
⚠ Admin dropped 1 x DIAMOND_SWORD (nearby: Steve, Alex)
⚠ Steve switched their gamemode to creative
⚠ Steve enchanted an item with SHARPNESS (near: Alex)

---

Installation

1. Place CommandLogger.jar in your server's /plugins folder.
2. Start or reload your server.

---

Configuration

Default config.yml:

features:
  gamemode: true
  give: true
  effect: true
  enchant: true
  attribute: true
  experience: true
  clear: true
  kill: true
  teleport: true
  item-drop: true

• true = feature enabled
• false = feature disabled

Changes made via the GUI update the config automatically.

---

Commands

Command	Permission	Description
/command_logger_setup	commandlogger.setup	Opens the setup GUI to toggle plugin features.

---

What this doesn't do

• Does not keep a persistant log of all commands executed, it only says the command in chat, then it is gone.

---

Notes

• Nearby player detection uses a 10-block radius.
• Only logs key commands and operator drops to reduce spam.
• Compatible with Paper 1.21.11+.
• f3+f4 does not log currently

---

Planned Features

• Log file.
• Customizing specific conditions, like whether or not tp log should work in spectator.
• Advanced radius and filter options for item drops.
• More commands
• Make f3+f4 log gamemode

---