ModSuite
Comprehensive moderation plugin for Paper/Spigot servers with multilingual support, Discord webhook alerts, database integration, and customizable permissions.
ModSuite
ModSuite is a complete moderation plugin for Minecraft servers, offering a wide range of tools for administrators and moderators.
It is designed to be modular, multilingual, with a custom permissions system, Discord integration, database support, and the ability to use hexadecimal colors for message customization.
Project status: 🚧 WIP – In development; some features may be incomplete or subject to change.
✨ Main Features
- 🛡️ Comprehensive moderation tools: warn, ban, tempban, mute, freeze, vanish, maintenance mode, etc.
- 🌍 Language system (e.g.
fr-FR) configurable. Other community-made language files are available on the Discord server, and you can also propose your own translations. - 🎨 Message customization with hexadecimal color codes (
#RRGGBB). - 📜 Sanction history and lookup commands.
- 🔐 Custom permissions for granular control.
- 🔔 Discord alert system via Webhook.
- 🧊 Freeze with optional sound.
- 🧠 Alt detection with configurable actions: notify, ban, banip, tempban, kick.
⚙️ config.yml File
lang: "fr-FR"
maintenance_status: false
discord_webhook_url: "https://discord.com/api/webhooks/..."
discord_webhook_enabled: true
enable_freeze_sound: true
# --- ALTS CONFIGURATION ---
punishment_alts_type: "notify"
punishment_alts_time: 3600
🔧 Customizable Options
| Option | Description |
|---|---|
| lang | Language code (e.g. fr-FR, en-US). |
| maintenance_status | Enables/disables maintenance mode (true / false). |
| discord_webhook_url | URL of the Discord webhook where alerts will be sent. |
| discord_webhook_enabled | Enables or disables sending alerts to Discord. |
| enable_freeze_sound | Plays a sound when a player is frozen. |
| punishment_alts_type | Action taken on alternate accounts (ban, banip, tempban, kick, notify). |
| punishment_alts_time | Duration of the sanction for alts (in seconds). |
📜 Commands
| Command | Description |
|---|---|
/warn | Warn a player. |
/ban | Ban a player. |
/unban | Unban a player. |
/tempban | Temporarily ban a player. |
/maintenance | Enable/disable maintenance mode. |
/mute | Mute a player. |
/unmute | Unmute a player. |
/lookup | View a player’s sanction history. |
/staff | Enable/disable staff mode. |
/freeze | Freeze a player. |
/vanish | Enable/disable vanish mode. |
/mreload | Reload the plugin configuration. |
📦 Installation
- Download the latest compiled version of ModSuite.
- Place the
.jarfile in your server’spluginsfolder. - Restart the server.
- Configure the
config.ymlfile to your needs. - (Optional) Set up your Discord webhook to receive alerts.
🛠️ Permissions
(to be documented based on your configuration)
Each command has its own dedicated permission to control who can use it.
🔒 Privacy & Data
This plugin can send moderation alerts to a configured Discord webhook.
The following data may be sent:
- Player username
- Player head (based on UUID / skin)
- Type of sanction applied (warn, ban, mute, etc.)
No other personal data is collected or transmitted by default.
If you enable database support, all storage and management of sanction history is the responsibility of the server owner. The plugin only provides the communication layer; it does not store data externally on its own.
📌 Notes
- The project is in development, and new features will be added soon.
- Remember to back up your configuration files before each update.
If you have any problems join the discord server, I will be glad to help you :)
A mod that adds a GUI for the plugin is in work, stay alert in the Discord :)
sneak peak Video
📄 License
Licensed under CC BY-NC-SA 4.0 – see the LICENSE file on GitHub for details.
