admin
98 lines
4.8 KiB
Markdown
98 lines
4.8 KiB
Markdown
# <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).
|