ModSuite

# 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 ```yaml 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 1. Download the latest compiled version of **ModSuite**. 2. Place the `.jar` file in your server’s `plugins` folder. 3. Restart the server. 4. Configure the `config.yml` file to your needs. 5. (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 (https://www.youtube.com/watch?v=zByA-qDHpzM)_ --- ## 📄 License Licensed under (https://creativecommons.org/licenses/by-nc-sa/4.0/) – see the (https://github.com/TwitmundDev/ModSuite-Public/blob/master/LICENSE) for details. ---