# ModSuite<\/p>\n
**ModSuite** is a complete moderation plugin for Minecraft servers, offering a wide range of tools for administrators and moderators.
\nIt 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.<\/p>\n
> **Project status**: \ud83d\udea7 **WIP** \u2013 In development; some features may be incomplete or subject to change.<\/p>\n
—<\/p>\n
## \u2728 Main Features<\/p>\n
– \ud83d\udee1\ufe0f **Comprehensive moderation tools**: warn, ban, tempban, mute, freeze, vanish, maintenance mode, etc.
\n– \ud83c\udf0d **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.
\n– \ud83c\udfa8 **Message customization** with **hexadecimal** color codes (`#RRGGBB`).
\n– \ud83d\udcdc **Sanction history** and lookup commands.
\n– \ud83d\udd10 **Custom permissions** for granular control.
\n– \ud83d\udd14 **Discord alert system** via Webhook.
\n– \ud83e\uddca **Freeze with optional sound**.
\n– \ud83e\udde0 **Alt detection** with configurable actions: notify, ban, banip, tempban, kick.<\/p>\n
—<\/p>\n
## \u2699\ufe0f `config.yml` File<\/p>\n
“`yaml
\nlang: “fr-FR”
\nmaintenance_status: false
\ndiscord_webhook_url: “https:\/\/discord.com\/api\/webhooks\/…”
\ndiscord_webhook_enabled: true
\nenable_freeze_sound: true<\/p>\n
# — ALTS CONFIGURATION —
\npunishment_alts_type: “notify”
\npunishment_alts_time: 3600
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd27 Customizable Options<\/p>\n
| Option | Description |
\n|—————————-|————-|
\n| **lang** | Language code (e.g. `fr-FR`, `en-US`). |
\n| **maintenance_status** | Enables\/disables maintenance mode (`true` \/ `false`). |
\n| **discord_webhook_url** | URL of the Discord webhook where alerts will be sent. |
\n| **discord_webhook_enabled**| Enables or disables sending alerts to Discord. |
\n| **enable_freeze_sound** | Plays a sound when a player is frozen. |
\n| **punishment_alts_type** | Action taken on alternate accounts (`ban`, `banip`, `tempban`, `kick`, `notify`). |
\n| **punishment_alts_time** | Duration of the sanction for alts (in seconds). |<\/p>\n
—<\/p>\n
## \ud83d\udcdc Commands<\/p>\n
| Command | Description |
\n|—————-|————-|
\n| `\/warn` | Warn a player. |
\n| `\/ban` | Ban a player. |
\n| `\/unban` | Unban a player. |
\n| `\/tempban` | Temporarily ban a player. |
\n| `\/maintenance` | Enable\/disable maintenance mode. |
\n| `\/mute` | Mute a player. |
\n| `\/unmute` | Unmute a player. |
\n| `\/lookup` | View a player\u2019s sanction history. |
\n| `\/staff` | Enable\/disable staff mode. |
\n| `\/freeze` | Freeze a player. |
\n| `\/vanish` | Enable\/disable vanish mode. |
\n| `\/mreload` | Reload the plugin configuration. |<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest compiled version of **ModSuite**.
\n2. Place the `.jar` file in your server\u2019s `plugins` folder.
\n3. Restart the server.
\n4. Configure the `config.yml` file to your needs.
\n5. (Optional) Set up your Discord webhook to receive alerts.<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Permissions<\/p>\n
*(to be documented based on your configuration)*
\nEach command has its own dedicated permission to control who can use it.<\/p>\n
—<\/p>\n
## \ud83d\udd12 Privacy & Data<\/p>\n
This plugin can send moderation alerts to a configured **Discord webhook**.
\nThe following data may be sent:
\n– Player username
\n– Player head (based on UUID \/ skin)
\n– Type of sanction applied (warn, ban, mute, etc.)<\/p>\n
No other personal data is collected or transmitted by default.
\nIf 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.<\/p>\n
—<\/p>\n
## \ud83d\udccc Notes<\/p>\n
– The project is **in development**, and new features will be added soon.
\n– Remember to back up your configuration files before each update.<\/p>\n
—
\n> If you have any problems join the discord server, I will be glad to help you \ud83d\ude42
\n> A mod that adds a GUI for the plugin is in work, stay alert in the Discord \ud83d\ude42<\/p>\n
_sneak peak Video_<\/p>\n
—<\/p>\n
## \ud83d\udcc4 License
\nLicensed under CC BY-NC-SA 4.0 \u2013 see the LICENSE file on GitHub for details.<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
Comprehensive moderation plugin for Paper\/Spigot servers with multilingual support, Discord webhook alerts, database integration, and customizable permissions.<\/p>\n","protected":false},"featured_media":104673,"template":"","meta":{"_minecraft_slug":"modsuite","_minecraft_project_id":"MBvunhE6","_minecraft_author":"TwitmundDev","_minecraft_license":"LicenseRef-Creative-Commons-Attribution-Non-Commercial-Share-Alike-4.0-International","_minecraft_downloads":30,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"modsuite.zip","_minecraft_size_bytes":1732146,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:08:55.531525Z","_minecraft_date_created":"2025-09-07T23:04:36.044930Z","_minecraft_date_modified":"2025-09-03T17:25:48.791395Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/modsuite","_minecraft_icon_attachment_id":104673,"_minecraft_imported_at":"2026-06-06T00:48:49+00:00","_minecraft_import_hash":"4b20852f91229bcc07c6ecc68593ddc6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,92],"mod_loader":[130,132],"minecraft_version":[38],"class_list":["post-104672","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21-4"],"yoast_head":"\n