Minecraft plugin SkBee

🔌 O SkBee

SkBee je addon pro Skript, který rozšiřuje jazyk Skript o širokou sadu prvků, jež zpřístupňují interní části serveru a moderní funkce Minecraftu autorům skriptů. Poskytuje syntaxi a nástroje pro práci s NBT, pokročilými textovými komponentami, scoreboardy, recepty, daty bloků, strukturami, tvorbou světů a jednoduchými regiony/hranice — umožňuje správcům serveru implementovat složité mechaniky pomocí Skript místo Javy.

🎯 Účel

Hlavním účelem SkBee je dát uživatelům Skript přímý přístup k funkcím Bukkit/Paper server APIs a interním částem Minecraftu, kterých je jinak se standardním Skriptem těžké nebo nemožné dosáhnout. Je určen pro majitele serverů a scriptery, kteří potřebují přesnější kontrolu nad předměty, entitami, formátováním textu, úpravami světa a prací se strukturami uvnitř skriptů Skript.

⚙️ Funkce

• NBT prvky: získání/nastavení NBT u předmětů, tile entities (bloků) a entit (u starších verzí je uvedena dostupnost až od 1.8.8+, kde je podporováno).
• FastBoards: implementace scoreboardu navržená ke snížení blikání (dostupná na novějších verzích Minecraftu, kde je podporována).
• Recipes: přidávání vlastních receptů a odstraňování vanilla receptů (funkce uvedené jako dostupné od pozdějších verzí, např. 1.13+ pro recipe API).
• BlockData: zjednodušený přístup pro získání/nastavení block data pro moderní block states (dostupné na podporovaných verzích).
• Structures: ukládání a vkládání vanilla struktur Minecraftu pomocí herního systému struktur.
• TextComponents: vytváření a úprava zpráv ve stylu JSON/TextComponent s hover a click událostmi a podporou hoveru na item.
• WorldCreator: vytváření vlastních světů s konfigurovatelnými možnostmi zpřístupněnými v Skript.
• Bounds: vytváření jednoduchých bounds/regionů podobných lehké ochraně regionů pro použití v Skript.
• GameEvents: napojení na systém GameEvent v Minecraftu (používaný skulk sensors a souvisejícími mechanikami).

🧩 Pro koho to je

• Správci serverů, kteří používají Skript a potřebují hlubší přístup k API bez psaní Java pluginů.
• Vývojáři Skript, kteří tvoří pokročilá GUI, vlastní předměty, strukturované zprávy nebo nástroje pro world/structure.
• Survival, SMP a vlastní herní servery, které spoléhají na Skript pro herní mechaniky a chtějí rozšířit funkcionalitu.

🏗️ Příklady použití

• Scripter čte a upravuje NBT předmětu, aby uvnitř Skript implementoval vlastní chování a atributy předmětů.
• Administrátor vytvoří vlastní crafting recepty a odstraní nechtěné vanilla recepty pomocí syntaxe Skript.
• Designéři ukládají a vkládají prefabrikované struktury během generování světa nebo pomocí nástrojů pro stavění ve hře.
• Chatové nebo GUI systémy, které potřebují JSON textové komponenty s hover/click akcemi a náhledy itemů.

⚙️ Instalace

📥 Nastavení

• Získejte plugin SkBee .jar z oficiálního zdroje stažení a vložte jej do adresáře serveru plugins/ vedle Skript.
• Restartujte server, aby se Skript a jeho addony načetly čistě.
• Zkontrolujte logy konzole serveru, abyste potvrdili, že se SkBee úspěšně načetl a detekoval nainstalovanou verzi Skript.

📦 Závislosti

• Skript (SkBee je addon pro Skript; novější buildy SkBee vyžadují novější verze Skript — přesné požadované verze Skript ověřte v poznámkách k vydání pluginu).

🧠 Technické poznámky

• SkBee je udržován jako open-source projekt pod licencí GPL-3.0.
• Různé funkce mohou být vázány na verzi: některé prvky (například zpracování NBT) mají poznámky ke kompatibilitě se staršími verzemi Minecraftu (příklady v upstream dokumentaci uvádějí dostupnost od 1.8.8+ pro některé funkce a 1.13+ pro jiné).
• SkBee poskytuje JavaDocs a wiki pro syntaxe; tyto reference si projděte při psaní Skript souborů, které využívají funkce SkBee.
• SkBee se snaží podporovat nedávné verze Skript i nedávné verze Minecraftu; konkrétní požadované verze Skript nebo Minecraftu se liší podle vydání SkBee — ověřte si poznámky k vydání pro build, který stahujete.

🤝 Kdy je tento plugin užitečný

Pokud spoléháte na Skript jako na svůj serverový scripting systém a potřebujete přístup k NBT, strukturovaným textovým zprávám, vlastním receptům, ukládání/vkládání struktur nebo jednoduchým nástrojům pro tvorbu regionů a světů bez psaní Javy, SkBee poskytuje širokou sadu ověřených syntaxí a utilit, které rozšiřují to, co můžete implementovat čistě v Skript.