docs: aktualizace a vylepseni README.md
This commit is contained in:
admin
@@ -1,17 +1,97 @@
|
||||
# <div align="center">🔮 VexlioHub 🔮</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="https://i.imgur.com/TmuOX8L.png" alt="Header">
|
||||
<p align="center">
|
||||
DeluxeHub is the all-in-one hub server solution compacting a large amount of hub essentials into one plugin.
|
||||
<strong>Kompletní, optimalizované a prémiové řešení pro správu vašeho Lobby/Hub serveru.</strong>
|
||||
<br />
|
||||
<br />
|
||||
<a href="https://strafbefehl.github.io/DeluxeHubReloadedDocs/welcome">Wiki</a>
|
||||
·
|
||||
<a href="https://www.spigotmc.org/resources/deluxehubreloaded-3-professional-hub-management.118904/">SpigotMC</a>
|
||||
·
|
||||
<a href="https://discord.gg/uQkg8ZeHzK">Discord</a>
|
||||
Moderní Minecraft plugin postavený na Paper API s plnou podporou MiniMessage přechodů a lokalizací.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
## License
|
||||
---
|
||||
|
||||
This project is licensed under the GNU General Public License v3.0 License - see the [LICENSE](LICENSE) file for details.
|
||||
## 🎨 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).
|
||||
|
||||
Reference in New Issue
Block a user