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

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 Video

---

📄 License

Licensed under CC BY-NC-SA 4.0 – see the LICENSE file on GitHub for details.

---