ModeratorMode
A customizable moderator mode that saves a player's inventory and state, offering a configurable hotbar with admin tools. It separates a moderator's personal gameplay from their staff duties.
Автор: vineprex5953обновлён 15 нояб. 2025 г.
УправлениеУтилиты
Описание
Supported MC Versions: 1.20.5+ 1.21.x
A powerful and fully customizable moderator mode for PaperMC servers, designed to streamline your staff's workflow without interrupting their gameplay. Now with comprehensive logging and player inspection capabilities!
📖 Overview
ModeratorMode is an essential tool that allows staff members to switch into a dedicated moderation mode with a single command. It safely saves their entire survival state—including location, inventory, health, and effects—and equips them with a configurable set of admin tools. This allows them to perform their duties efficiently and return to their previous state exactly as they left it.
This plugin is built to be robust, lightweight, and fully manageable from in-game, making it a perfect fit for any server.
✨ Features
- Seamless State Saving: Toggling moderator mode (
/mm) instantly saves a player's location, inventory, gamemode, health, food level, experience, and potion effects. - Crash-Proof Persistence: Player data is saved to a local JSON file, ensuring that even if the server crashes, a moderator's inventory and state are never lost.
- Fully Configurable Hotbar: Admins can define a custom set of items that moderators receive upon entering the mode. Add special tools, compasses, or custom items from other plugins directly from in-game!
- Player Inspection System: Right-click any player while in moderator mode to view their inventory, ender chest, statistics, and active potion effects in real-time—all in secure, read-only GUIs.
- Comprehensive Logging: All moderation actions are automatically logged to JSON files with timestamps, including mode entries/exits, player inspections, and hotbar modifications.
- Built-in Moderator Tools:
- Simple Vanish: Automatically hides moderators from regular players using the reliable built-in Bukkit method.
- Permanent Night Vision: Grants infinite night vision to ensure moderators can see everything clearly, day or night.
- Item Drop Protection: Prevents moderators from accidentally dropping their configured tools.
- Easy In-Game Management: All hotbar items can be managed via simple admin commands. No need to manually edit YAML files after the initial setup.
- Lightweight & No Dependencies: Built to be efficient and stable with no external plugin dependencies required for core functionality.
🎮 Commands & Permissions
Player Commands
Requires the permission moderatormode.use.
| Command | Alias | Description |
|---|---|---|
/modmode | /mm | Toggles moderator mode on or off. |
/modmode help | Displays the help message. |
Admin Commands
Requires the permission moderatormode.admin.
| Command | Description |
|---|---|
/modmode list | Shows the current list of configured hotbar items. |
/modmode add | Adds the item you are currently holding to the hotbar list. |
/modmode remove <number> | Removes an item from the list by its number (from /mm list). |
/modmode reload | Reloads the plugin's configuration file from disk. |
Inspection (ModeratorMode Feature)
Requires the permission moderatormode.inspect
| Action | Description |
|---|---|
| Right-click player | Opens inspection GUI while in moderator mode. |
Permission Nodes
| Permission | Description |
|---|---|
moderatormode.use | Allows toggling the moderator mode. |
moderatormode.admin | Allows managing hotbar items and reloading config. |
moderatormode.inspect | Allows inspecting players in moderation mode. |
moderatormode.inspect.ip | Allows copying player IP addresses in inspection. |
moderatormode.seevanished | Allows seeing vanished moderators (bypasses vanish). |
⚙️ Installation
- Download the latest
ModeratorMode-*.jarfrom the [Versions Page]. - Place the JAR file into your server's
/pluginsfolder. - Restart your server. The default configuration file (
config.yml) and logs directory will be generated automatically. - (Optional) Grant the necessary permissions to your staff groups using a permissions plugin like LuckPerms.
- Review the
config.ymlto customize hotbar items and logging settings.
That's it! Your staff can now use /mm to moderate more effectively.
Галерея
Последние версии
Все версии →release
v1.3.0 - Player Inspection & Audit Logging
1.3.015 нояб. 2025 г.422Minecraft: 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper
Что нового
## 🎉 New Features
### Player Inspection System
- **Right-click** any player while in `/mm` mode to open a secure inspection GUI
- View **inventory, ender chest, statistics, and active potion effects** in real-time
- **Fully read-only** - prevents item theft or tampering
- Granular permissions: `moderatormode.inspect` and `moderatormode.inspect.ip`
### Comprehensive Audit Logging
- All moderation actions logged to `plugins/ModeratorMode/logs/`
- **JSON format** for easy parsing and external tool integration
- Logs: mode entries/exits, player inspections, hotbar modifications
- Automatic log rotation after 30 days
### IP Address Copying
- Clickable chat component to copy player IPs
- **GDPR compliant**: Disabled by default, requires explicit config + permission
## 🔧 Improvements
- Enhanced help menu with inspection instructions
- Improved code structure and maintainability
- Added configuration sections for logging and inspection
## 🐛 Bug Fixes
- Fixed compilation errors in GUI handlers
- Resolved scope issues with player skull creation
- Added missing import statements
- Fixed permission naming inconsistencies
release
ModeratorMode 1.2.2
1.2.214 нояб. 2025 г.40Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10paper
release
ModeratorMode 1.2.2
1.2.21 нояб. 2025 г.20Minecraft: 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper
Что нового
This is a recommended maintenance release that resolves a critical bug affecting inventory restoration and improves the overall stability of the mode-switching feature.
### ✅ Bug Fixes
* **Inventory Restoration Failure:** Fixed a major issue where players leaving moderator mode would need to toggle it twice to get their inventory, health, and status back correctly. This was caused by a server timing issue (race condition) that is now resolved. Player states are now restored reliably on the first try.
### ⚙️ Other Changes
* **Version Bump:** Updated the internal plugin version to `1.2.2` in all relevant files (`plugin.yml`, `pom.xml`, and startup logs).
### Technical Details
The inventory fix was implemented by delaying the `restorePlayerState` logic by a single server tick using the Bukkit scheduler. This ensures the GameMode change is fully processed by the server before the player's saved inventory is applied, preventing the race condition.
release
ModeratorMode 1.2.1 - Critical Bugfix Release
1.2.126 окт. 2025 г.23Minecraft: 1.21.8paper
Что нового
This is a critical bugfix release that resolves an issue where players could not re-enter moderator mode after a server crash or restart. It is highly recommended that all users update.
release
ModeratorMode 1.2-MultiVanishSupport
1.2a25 окт. 2025 г.21Minecraft: 1.21.8paper
Что нового
### v1.2-MultiVanishSupport - Changes
#### Added
* **Multi-Vanish Support:** The plugin now automatically detects and hooks into the best available vanish plugin on your server.
* **Supported Plugins (in order of priority):**
1. **SuperVanish** / **PremiumVanish**
2. **EssentialsX**
3. **CMI** (via Reflection, no extra dependency needed)
4. **Bukkit default** (fallback if no other provider is found)
#### Changed
* The `/modmode reload` command now re-scans for vanish providers.
* When entering moderator mode, you are now notified which vanish system is being used.
release
ModeratorMode 1.1-EssentialsXVanish
1.1a17 окт. 2025 г.32Minecraft: 1.21.8paper
Что нового
### ✨ Added
- **Intelligent EssentialsX Vanish Integration:** The plugin now automatically hooks into EssentialsX to provide a true vanish experience (hidden from tab list, join/leave messages suppressed).
- **Automatic Fallback:** If EssentialsX is not found, the plugin gracefully falls back to the standard Bukkit hiding feature, ensuring it works on any server.
- **In-Game Vanish Feedback:** You are now notified in chat which vanish method is being used.
release
v1.0: The Toolkit Update
1.013 окт. 2025 г.37Minecraft: 1.21.8paper