Command Logger Plus

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 nearby players, nearby players, 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`:

```yaml 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

---