🗝️ 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 <time> <key>	/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 [Your Language] 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 <name> <amount>).

---

📄 Default Configuration (config.yml)

# 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'