# <div align="center">🔮 VexlioHub 🔮</div>

<div align="center">
  <p align="center">
    <strong>Kompletní, optimalizované a prémiové řešení pro správu vašeho Lobby/Hub serveru.</strong>
    <br />
    Moderní Minecraft plugin postavený na Paper API s plnou podporou MiniMessage přechodů a lokalizací.
  </p>
</div>

---

## 🎨 Design & Barevné schéma

VexlioHub je od základu navržen tak, aby na hráče udělal skvělý první dojem. Podporuje pokročilé RGB gradienty v chatu, nadpisech (Title) i actionbaru.

* **Hlavní fialová (Primary):** `#9333EA` (nebo neonová `#A855F7`)
* **Sekundární azurová (Secondary):** `#06B6D4` (nebo zářivá `#00FFD1`)

V konfiguracích můžete vytvářet nádherné plynulé přechody pomocí následující syntaxe:
```xml
<gradient:#9333EA:#06B6D4><bold>NÁZEV SERVERU</bold></gradient>
```

---

## 🚀 Klíčové Funkce

### 1. Odrazové plošiny (Launchpads)
* Umožňuje odhazování hráčů při šlápnutí na určenou kombinaci bloků (např. kamenná nášlapná deska na redstone bloku).
* **Efekty:** Konfigurovatelné částice (Particles), zvukové efekty (Sound) s nastavením hlasitosti a tóniny, a částicová stopa (Trail) kopírující trajektorii letu hráče.

### 2. Dvojitý skok (Double Jump)
* Umožňuje hráčům provést druhý skok ve vzduchu pro snadný pohyb po lobby.
* Nastavitelný cooldown, síla odhozu (vertikální i horizontální) a vizuální i zvukové efekty při aktivaci.

### 3. Oznamování v Actionbaru (ActionBar Announcements)
* Periodicky odesílá nakonfigurované zprávy přímo nad hotbar všech online hráčů.
* Podporuje animované zprávy, gradienty a má zanedbatelný vliv na výkon serveru.

### 4. Uvítací animace (Join Title Animation)
* Zobrazí velký, stylový nadpis (Title) a podnadpis (Subtitle) s nastavitelným časováním (fadeIn, stay, fadeOut) ihněd po připojení hráče na server.

### 5. Ochrana světa & Pravidla lobby (World protection)
* **Hráč:** Vypnutí ztráty hladu, poškození pádem, poškození ohněm, utonutí a smrti ve voidu.
* **Interakce:** Automatické zablokování ničení a pokládání bloků, vyhazování a sbírání předmětů a interakce s truhlami/pecemi pro běžné hráče (povoleno pouze v stavebním režimu).
* **Boj:** Vypnutí PvP v celém lobby světě.

### 6. Připojovací předměty (Custom Join Items)
* Automatické přidělení předmětů do hotbaru při připojení (např. **Výběr serverů**).
* Obsahuje vestavěný přepínač viditelnosti hráčů (**Player Hider**) s vlastním cooldownem a materiály.

---

## 🛠️ Příkazy a Oprávnění

Všechny příkazy využívají dynamickou registraci přes Bukkit `CommandMap` a podporují inteligentní doplňování (Tab Completion).

| Příkaz | Aliasy | Oprávnění | Popis |
| :--- | :--- | :--- | :--- |
| `/vexliohub` | `/vhub` | `vexliolobby.admin` | Hlavní příkaz pro správu a znovunačtení konfigurací pluginu. |
| `/buildmode` | `/build` | `vexliolobby.buildmode` | Přepne hráče do stavebního režimu (povolí stavění/ničení). |
| `/fly` | – | `vexliolobby.fly` | Povolí nebo zakáže létání na lobby. |
| `/clearchat` | – | `vexliolobby.clearchat` | Kompletně promaže globální chat na serveru. |
| `/setlobby` | – | `vexliolobby.setlobby` | Nastaví spawn point na aktuální pozici hráče. |
| `/lobby` | – | `vexliolobby.lobby` | Teleportuje hráče na nastavený spawn point. |
| `/gamemode <mód>` | `/gm` | `vexliolobby.gamemode` | Změní herní mód hráče. |
| `/gms` / `/gmc` / `/gma` / `/gmsp` | – | `vexliolobby.gamemode` | Zkratky pro přepínání herních módů. |

---

## 📂 Struktura konfigurace

Plugin ukládá nastavení do přehledných `.yml` souborů ve své složce:

* **[config.yml](file:///c:/Users/babym/Documents/Dev/Lobby/uprava/config.yml):** Hlavní nastavení modulů (Launchpad, Double Jump, Actionbar, Join Title, ochrany světa a připojovací předměty).
* **[commands.yml](file:///c:/Users/babym/Documents/Dev/Lobby/uprava/commands.yml):** Povolení/zakázání jednotlivých příkazů a nastavení vlastních (custom) příkazů.
* **[messages.yml](file:///c:/Users/babym/Documents/Dev/Lobby/uprava/messages.yml):** Kompletní překlady a barevné úpravy veškerých textů.
* **[data.yml](file:///c:/Users/babym/Documents/Dev/Lobby/uprava/data.yml):** Ukládání systémových dat (např. souřadnice spawn pointu).

---

## ⚙️ Vývoj a Sestavení

Plugin vyžaduje k sestavení **Java SDK 25**.

Pro čisté zkompilování a vygenerování `.jar` souboru spusťte v kořenovém adresáři:
```bash
./gradlew clean shadowJar
```
Výsledný soubor naleznete v adresáři `build/libs/`.

---

## 📄 Licence

Tento projekt je licencován pod licencí GNU General Public License v3.0 - podrobnosti naleznete v souboru [LICENSE](LICENSE).