
🛡️ ModerationPlugin
ModerationPlugin is a complete and highly configurable moderation system for Minecraft servers running 1.21+. It provides staff members with a wide range of tools for player management, punishments, server control, chat moderation, reports, permissions, grades, and more — all from a single plugin.
The plugin also includes GUI-based management, Discord webhook integration, configurable staff grades and permissions, player history, moderation reports, jail management, chat controls, and various utilities designed specifically for server staff.
✨ Features
- 🔨 Permanent and temporary bans
- 🔇 Permanent and temporary mutes
- ⚠️ Player warnings
- 👢 Player kicking
- ❄️ Player freezing
- 🔒 Player inventory locking
- 📜 Complete punishment history
- 🔎 Detailed player inspection
- 🚨 Player report system
- 👮 Customizable staff grades
- 🔑 Individual permission management
- 🖥️ Moderation GUI
- 💬 Staff chat
- 🚫 Global chat management
- 🐌 Slow chat mode
- 📢 Server broadcasts
- 🔐 Server lock & maintenance mode
- ⛓️ Jail system
- 🎮 Staff gamemode management
- ✈️ Flight management
- 🎁 Item giving
- 🧹 Inventory clearing
- 🧪 Potion effect management
- 🌦️ Weather control
- 🕐 Time control
- ⏱️ Server countdowns
- 📡 Discord webhook logging
- 🔌 PlaceholderAPI support
- ⚙️ Highly configurable messages and settings
📋 Commands
🔨 Punishments
| Command | Description |
|---|---|
/ban <player> [reason] |
Permanently bans a player. |
/tempban <player> <duration> [reason] |
Temporarily bans a player. |
/unban <player> |
Unbans a player. |
/kick <player> [reason] |
Kicks a player from the server. |
/mute <player> [reason] |
Permanently mutes a player. |
/tempmute <player> <duration> [reason] |
Temporarily mutes a player. |
/unmute <player> |
Removes a player's mute. |
/warn <player> [reason] |
Warns a player. |
/freeze <player> [reason] |
Freezes a player and prevents them from moving. |
/unfreeze <player> |
Unfreezes a player. |
/lock <player> [reason] |
Locks a player's inventory. |
/unlock <player> |
Unlocks a player's inventory. |
📜 Player Management
| Command | Description |
|---|---|
/history <player> |
Displays a player's complete punishment history. |
/inspect <player> |
Displays detailed information about a player, including UUID, masked IP, playtime, punishments and connection information. |
/jail <player> [reason] |
Sends a player to jail. |
/unjail <player> |
Releases a player from jail. |
/setjail |
Sets the jail location at your current position. |
🚨 Reports
| Command | Description |
|---|---|
/report <player> <reason> |
Reports a player to the moderation team. |
/reports |
Displays pending player reports. |
/reports clear <id|all> |
Clears a specific report or all reports. |
Reports can also be sent to Discord through the configured webhook.
👮 Staff & Permissions
| Command | Description |
|---|---|
/gui |
Opens the main moderation GUI. |
/perms <player> |
Opens the permission management GUI for a player. |
/grades |
Manages configurable staff grades. |
/grades create ... |
Creates a new grade. |
/grades delete ... |
Deletes a grade. |
/grades reload |
Reloads the grade configuration. |
/setgrade <player> <grade> |
Assigns a grade to a player. |
/staffchat <message> |
Sends a message visible only to staff. |
/modhelp |
Displays the moderation command help. |
/wiki |
Displays the plugin's commands and their purpose in-game and through Discord. |
🎮 Staff Utilities
| Command | Description |
|---|---|
/gm <mode> [player] |
Changes a player's gamemode. |
/modgive <player> <item> [amount] |
Gives an item to a player. |
/modtp [player] <destination> |
Teleports a player. |
/modfly [player] |
Toggles flight for a player. |
/modclear [player] |
Clears a player's inventory. |
/modeffect <player> <effect> <duration> [amplifier] |
Applies a potion effect. |
/modweather <clear|rain|thunder> |
Changes the world's weather. |
/modtime <day|noon|night|midnight|value> |
Changes the world's time. |
/cooldown <duration|cancel> [label] |
Starts or cancels a server countdown. |
💬 Chat Moderation
| Command | Description |
|---|---|
/clearchat |
Clears the chat for all players. |
/slowchat <seconds> |
Adds a delay between player messages. |
/lockchat |
Locks the global chat. |
/chat <on|off> |
Enables or disables the global chat. |
/broadcast <message> |
Sends a server-wide announcement. |
/staffchat <message> |
Sends a staff-only message. |
Staff members can use configurable bypass permissions for chat restrictions.
🔐 Server Management
| Command | Description |
|---|---|
/serverlock |
Toggles server connection locking. |
/maintenance |
Enables or disables maintenance mode. |
Maintenance and server-lock systems include configurable bypass permissions for authorized staff.
🔑 Permission System
The plugin includes a fully configurable permission system.
The main permission:
moderation.*
grants access to all moderation features.
Individual permissions are also available, for example:
moderation.ban
moderation.tempban
moderation.mute
moderation.tempmute
moderation.kick
moderation.warn
moderation.freeze
moderation.lock
moderation.history
moderation.inspect
moderation.report
moderation.reports
moderation.grades
moderation.setgrade
moderation.give
moderation.teleport
moderation.fly
moderation.clear
moderation.effect
moderation.weather
moderation.time
moderation.staffchat
moderation.maintenance
moderation.serverlock
Additional bypass permissions are available for specific restrictions such as chat locks, slow chat, maintenance mode and server locks.
🔗 Integrations
Discord Webhooks
Moderation events and reports can be sent to Discord through a configurable webhook, allowing server owners to keep track of important moderation activity outside the game.
PlaceholderAPI
ModerationPlugin supports PlaceholderAPI, allowing moderation-related information to be used in compatible plugins and server interfaces.
⚙️ Configuration
The plugin is designed to be highly configurable through its configuration files.
You can customize things such as:
- Messages
- Punishment messages
- Staff grades
- Permissions
- Discord webhook settings
- Chat moderation
- Server protection settings
- Jail settings
- GUI behavior
- Other moderation options
🎯 Designed for Staff Teams
ModerationPlugin is designed to work for servers of all sizes, from small communities to large Minecraft networks.
Whether you need a simple /warn, a complete punishment history, a report system, customizable staff permissions, or advanced server-management tools, ModerationPlugin brings everything together in one centralized moderation solution.
Minecraft 1.21+ • Configurable • GUI Support • Discord Integration • PlaceholderAPI Support
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ModerationPlugin is a free Minecraft Java mod. Compatible with Minecraft 1.21, 1.21.1, 1.21.2, 1.21.3 and newer. Downloaded 5 times (via Modrinth). Download it and open it directly in the game.