Halt - Ultimate Cooldown Management

# Halt

**Halt** is a lightweight yet powerful cooldown plugin for Minecraft servers. It allows server administrators to define custom cooldowns for various actions, ensuring balanced gameplay and preventing spam.

## Features

- **Custom Cooldowns**: Define cooldowns for items, blocks, entity interactions, and more.
- **Action Bar Notifications**: optional display of remaining cooldown time in the action bar.
- **Bypass Permissions**: Grant specific players or groups immunity to certain cooldowns.
- **World Disabling**: Disable cooldowns in specific worlds (e.g., spawn).
- **Persistent Tracking**: Option to save usage amounts across server restarts.
- **In-Game GUI**: Full in-game configuration editor (`/halt gui`).
- **Configurable Messages**: Fully customizable messages with placeholder support.

## Specific Features Support
- **Interact Item**: Cooldowns for right-clicking items (e.g., Ender Pearls).
- **Interact Block**: Cooldowns for interacting with specific blocks.
- **Consume Item**: Cooldowns for eating/drinking items (e.g., Golden Apples).
- **Potion Throw**: Cooldowns for throwing potions.
- **Potion Effect**: Cooldowns triggered by receiving specific potion effects.
- **Entity Interact**: Cooldowns for clicking on entities.
- **Undying**: Cooldowns for Totem of Undying activation.
- **Place Entity**: Cooldowns for placing entities (e.g., End Crystals).

## Commands

| Command | Description | Permission | Usage |
| :--- | :--- | :--- | :--- |
| `/halt help` | Shows the help menu.| `halt.admin` | `/halt help` |
| `/halt gui` | Opens the configuration GUI. | `halt.admin` | `/halt gui` |
| `/halt reload` | Reloads the configuration. | `halt.admin` | `/halt reload` |

## Permissions

| Permission | Description | Default |
| :--- | :--- | :--- |
| `halt.admin` | Grants full administrative access to Halt commands. | `op` |

## Getting Started

1. **Installation**: Drop the `Halt.jar` plugin file into your server's `plugins` folder.
2. **Restart**: Restart your server to generate the configuration files.
3. **Configuration**: Edit `plugins/Halt/config.yml` and `plugins/Halt/cooldowns.yml` to set up your cooldowns.
4. **Reload**: Run `/halt reload` to apply changes without restarting.

For a detailed guide on configuration option and testing, please refer to [GUIDE.md](GUIDE.md).