TurboBansLite

TurboBansLite

A modern, efficient, and easy-to-use punishment management system developed for your server.

---

✨ Features

- Permission System: Permanent and temporary `ban`, `mute`, `ip-ban`, and `warn` punishments. - Permission System: Easily manage punishments with an interactive menu using the `/turbobans <player>` command. - Permission System: After selecting a punishment from the GUI, easily enter the duration and reason through a chat conversation. - Permission System: All punishments are stored in an SQLite database to ensure no data is lost on server restarts. - Permission System: Automatically kick, mute, or ban players who reach a certain number of warnings. - Permission System: View a player's complete punishment history with the `/turbohistory <player>` command. - Permission System: All messages in the plugin are fully customizable via `messages_tr.yml` and `messages_en.yml` files. - Permission System: Detailed permission management for all commands and features.

---

📦 Installation

1. Drag and drop the `TurboBansLite-1.0-SNAPSHOT.jar` file into your server's `plugins` folder. 2. Start or restart your server. 3. You can edit the necessary settings and language files under the `plugins/TurboBansLite/` directory.

---

⚙️ Configuration (`config.yml`)

The `config.yml` file contains the main settings for the plugin:

- `appeals`: Sets the default language of the plugin (`tr` or `en`). - `appeals`: Configure automatic punishments based on the number of warnings. For example, muting a player for 1 hour after they receive 5 warnings. - `appeals`: Set the appeal website and Discord invitation link that will be displayed on the ban/kick screens.

---

⌨️ Commands and Permissions

By default, all commands can only be used by players with `OP` status.

| Command | Description | Usage | Permission | | ---------------------- | -------------------------------------- | ------------------------------------------- | ------------------- | | `/turbobans <player>` | Opens the punishment GUI for a player. | `/turbobans <player>` | `turbo.gui` | | `/turboban <player>` | Bans a player. | `/<command> <player> [duration] [reason]` | `turbo.ban` | | `/turbounban <player>` | Unbans a player. | `/<command> <player>` | `turbo.unban` | | `/turbomute <player>` | Mutes a player in chat. | `/<command> <player> [duration] [reason]` | `turbo.mute` | | `/turbounmute <player>`| Unmutes a player. | `/<command> <player>` | `turbo.unmute` | | `/turbokick <player>` | Kicks a player from the server. | `/<command> <player> [reason]` | `turbo.kick` | | `/turbowarn <player>` | Warns a player. | `/<command> <player> [reason]` | `turbo.warn` | | `/turbohistory <player>`| Shows a player's punishment history. | `/<command> <player>` | `turbo.history` | | `/turbobanip <ip/player>`| Bans an IP address. | `/<command> <ip/player> [duration] [reason]`| `turbo.banip` | | `/turbounbanip <ip>` | Unbans an IP address. | `/<command> <ip>` | `turbo.unbanip` | | `/turbobans reload` | Reloads the plugin's config files. | `/turbobans reload` | `turbo.reload` |

---

🛡️ Other Permissions

| Permission | Description | | --------------------- | ---------------------------------------------- | | `turbo.*` | Grants all permissions for the plugin. | | `turbo.notify` | Receives notifications about punishments. | | `turbo.bypass.ban` | Bypasses ban punishments. | | `turbo.bypass.mute` | Bypasses mute punishments. | | `turbo.bypass.kick` | Bypasses kick punishments. |