admin
4.8 KiB
🔮 VexlioHub 🔮
Kompletní, optimalizované a prémiové řešení pro správu vašeho Lobby/Hub serveru.
Moderní Minecraft plugin postavený na Paper API s plnou podporou MiniMessage přechodů a lokalizací.
🎨 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:
<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: Hlavní nastavení modulů (Launchpad, Double Jump, Actionbar, Join Title, ochrany světa a připojovací předměty).
- commands.yml: Povolení/zakázání jednotlivých příkazů a nastavení vlastních (custom) příkazů.
- messages.yml: Kompletní překlady a barevné úpravy veškerých textů.
- 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:
./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.