RX-KeyAll

!(https://github.com/apapusmaksimus/RX-KeyAll/blob/master/media/minecraft_title%20(3).png?raw=true) # 🗝️ RX-KeyAll

RX-KeyAll is a lightweight, modern, and highly optimized Minecraft server plugin (built for Paper/Purpur 1. 21. 1). It allows server administrators to host global KeyAll events (rewarding every online player with crate keys) featuring a dynamic countdown displayed on an elegant BossBar.

Powered by Okaeri Config and LiteCommands 3.x, this plugin guarantees zero unnecessary CPU overhead and ultimate configuration flexibility.

## ✨ Features

♾️ Unlimited Keys: Define as many crate types or keys as you want in the configuration file (e.g., rare, astrobox, magic). 🎨 Full RGB / HEX Support: Use modern `<#hex>` color formats in key display names and messages to perfectly match your server's aesthetic. 🛠️ Robust & Ghost-Free: Completely fixes the common bug of "ghost" or duplicating BossBars. When the server restarts, stops, or reloads (`/reload`), all active countdowns are safely and instantly cleared from players' screens. 🌍 100% Translatable: Every single message and text can be customized.

## 💻 Commands & Permissions

The plugin features an intuitive command layout with helpful aliases for seamless management.

| Command | Aliases | Description | Required Permission | | :--- | :--- | :--- | :--- | | `/keyall ` | `/dajwszystkimklucze` | Starts the countdown and distributes keys | `rxkeyall.cmd.keyall` | | `/keyallreload` | None | Reloads the configuration file | `rxkeyall.cmd.reload` |

> 💡 Usage Examples: > `/keyall 30s rare` – Gives out the "rare" key in 30 seconds. > `/keyall 5m astrobox` – Gives out the "astrobox" key in 5 minutes. > Supported time units: s (seconds), m (minutes), h (hours).

## 🤖 Localization & AI Translation

Since every text, message, and broadcast is located in the `config.yml` file, the plugin is fully localization-ready.

> 💡 Pro-Tip: If you want to translate the plugin into your native language (e.g., Spanish, German, French, or Polish), you can simply copy the default configuration below, paste it into ChatGPT, and ask it: "Translate the message values in this config into while keeping the %key% and %time% placeholders intact."*

## ⚙️ Requirements

To ensure top-tier performance, the plugin relies on modern technical standards: 1. Java 21 (or newer). 2. Paper or Purpur server engine version 1. 21. 1. 3. Any crate/box plugin of your choice that supports giving keys to all players via a console command (e.g., `case giveall `).

## 📄 Default Configuration (`config.yml`)

```yaml # Keys Configuration (You can add infinitely many custom keys!) keys: rzadka: displayName: '&7&lRzadka' command: 'case giveall rzadka 1' astrobox: displayName: '&b&lAstroBox' command: 'case giveall astrobox 1'

# BossBar Appearance Settings # Available colors: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE # Available styles: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, SEGMENTED_20 bossBarColor: GREEN bossBarStyle: SEGMENTED_20

# System Messages messages: invalid_key: '&cUnknown key: &4%key%' invalid_time: '&cPlease provide a valid time format, e.g., ''30s'', ''2m'', ''1h''' key_given: '&aYou received a key: %key%' bossbar_title: '&aIn &2%time% &aevery online player will receive a %key% &ccrate key' bossbar_end: '&aEveryone received a %key% &acrate key 0 sec ago'