CooldownManager ⏲️

A powerful and user-friendly plugin for Nukkit that adds configurable cooldowns to commands on your Minecraft server! 🚀 Manage cooldowns easily through an intuitive form-based interface or command arguments, with support for subcommands and a customizable configuration file. Perfect for server admins looking to control command usage with style! ✨

---

Features 🌟

• Command Cooldowns: Set cooldowns for any command or subcommand to prevent spam. ⏳
• Form-Based Interface: Manage cooldowns via a user-friendly GUI with options to create, list, and edit cooldowns. 🖱️
• Subcommand Support: Configure cooldowns for specific subcommands (e.g., /warp vip). 🔧
• Configurable Messages: Customize the cooldown message in config.yml. 📜
• Autocompletion: Command arguments support tab-completion for ease of use. ✅
• Comment-Preserving Config: Keep comments in config.yml for better readability. 📝

---

Installation 🛠️

1. Download: Grab the latest CooldownManager.jar from the Releases page. 📥
2. Install: Place the .jar file in the plugins folder of your Nukkit server.
3. Restart: Start or restart your server to load the plugin. 🔄
4. Configure: Edit plugins/CooldownManager/config.yml to set up your cooldowns and messages. ✍️

---

Commands 🕹️

Use the /cooldown command to manage cooldowns. Only players with the cooldown.command permission (default: op) can use it.

Command	Description
/cooldown	Opens the main form interface to manage cooldowns.
/cooldown reload	Reloads the configuration from config.yml.
/cooldown edit [command]	Edits an existing cooldown or opens the creation form if the command doesn't exist.
/cooldown edit	Opens a form to select a command to edit.
/cooldown create	Opens a form to create a new cooldown.

Note: The command supports tab-completion for reload, edit, and create arguments.

---

Configuration 📋

The plugin generates a config.yml file in plugins/CooldownManager/ with comments preserved from the default configuration. Below is an example:

cooldown-message: "§7> §cWait§e {time} §cseconds before using this command"
commands:
  warp:
    cooldown: 10 # seconds
    subcommands:
      vip: 30 # full command - /warp vip
  rtp:
    cooldown: 30
    subcommands:
      near: 60
      long: 10

• cooldown-message: The message shown to players when a command is on cooldown. Use {time} for remaining seconds.
• commands: Define commands and their cooldowns (in seconds). Subcommands are optional.

---

Form Interface 🎮

The /cooldown command opens a form with the following options:

• New Cooldown 🆕: Create a new cooldown with a command name, cooldown time, and optional subcommands.
• Cooldown List 📋: View all configured cooldowns and their subcommands.
• Edit Cooldowns ✏️: Select a command to edit its cooldown.

When creating a cooldown, you can specify a number of subcommands to add additional input fields for subcommand names and cooldowns.

---

Screenshots 📷

Command Form

Create the cooldown form

Cooldown List Form

Edit Cooldowns Form

2nd Edit Cooldown Form

---

Permissions 🔒

Permission	Description	Default
cooldown.command	Allows access to the /cooldown command and form interface.	op

---

Build 🔨

Want to contribute or customize the plugin? Here's how to set up the development environment:

1. Clone the Repository:

   git clone https://github.com/CrieXD1337/CooldownManager.git

2. Build: Use Maven to build the plugin:

   mvn clean package

3. Test: Place the compiled .jar in your server's plugins folder and test away! 🧪

---

Issues & Contributions 🐛

Found a bug or have a feature request? Open an issue on the GitHub Issues page. Pull requests are welcome! 🙌

---

License 📜

This project is licensed under the MIT License. See the LICENSE file for details.

---

🌟 Customize your server with CooldownManager! 🌟