🛡️ 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