Plugin Minecraft SkBee

🔌 Despre SkBee

SkBee este un addon pentru Skript care extinde limbajul Skript cu un set larg de elemente ce expun internals-ul serverului și funcțiile moderne Minecraft autorilor de scripturi. Oferă sintaxe și utilitare pentru lucrul cu NBT, componente text avansate, scoreboard-uri, rețete, date de block, structuri, crearea de world-uri și region/bounds simple — permițând administratorilor de servere să implementeze mecanici complexe folosind Skript în loc de Java.

🎯 Scopul

Scopul principal al SkBee este să ofere utilizatorilor Skript acces direct la funcțiile Bukkit/Paper server APIs și la internals-ul Minecraft care altfel sunt greu sau imposibil de obținut cu Skript vanilla. Este destinat proprietarilor de servere și scripterilor care au nevoie de un control mai precis asupra item-urilor, entity-urilor, formatării textului, manipulării world-ului și gestionării structurilor în interiorul scripturilor Skript.

⚙️ Funcții

• Elemente NBT: get/set NBT pentru item-uri, tile entities (block-uri) și entity-uri (menționat ca disponibil pentru versiunile mai vechi până la 1.8.8+ acolo unde este suportat).
• FastBoards: o implementare de scoreboard concepută pentru a reduce flicker-ul (disponibilă pe versiunile mai noi de Minecraft unde este suportată).
• Recipes: adăugare de rețete personalizate și eliminare de rețete vanilla (funcții notate ca disponibile din versiunile mai târzii, de exemplu 1.13+ pentru recipe APIs).
• BlockData: acces simplificat pentru get/set block data pentru block states moderne (disponibil pe versiunile suportate).
• Structures: salvarea și lipirea structurilor vanilla Minecraft folosind sistemul de structuri al jocului.
• TextComponents: construirea și manipularea mesajelor în stil JSON/TextComponent cu evenimente hover și click și suport pentru hover pe item.
• WorldCreator: crearea de world-uri personalizate cu opțiuni configurabile expuse către Skript.
• Bounds: crearea de bounds/region-uri simple, asemănătoare unei protecții ușoare de region, pentru folosire în Skript.
• GameEvents: conectare la sistemul GameEvent din Minecraft (folosit de skulk sensors și mecanici conexe).

🧩 Pentru cine este

• Administratori de server care folosesc Skript și au nevoie de acces mai profund la API fără a scrie pluginuri Java.
• Dezvoltatori Skript care construiesc GUI-uri avansate, item-uri personalizate, mesaje structurate sau instrumente pentru world/structure.
• Servere Survival, SMP și servere de joc personalizate care se bazează pe Skript pentru mecanici de gameplay și vor să extindă funcționalitatea.

🏗️ Exemple de utilizare

• Un scripter citește și modifică NBT-ul unui item pentru a implementa comportament și atribute personalizate ale item-ului în Skript.
• Un admin creează rețete de crafting personalizate și elimină rețetele vanilla nedorite folosind sintaxa Skript.
• Designerii salvează și lipesc structuri prefabricate în timpul generării world-ului sau cu instrumente de construire în joc.
• Sisteme de chat sau GUI care au nevoie de componente text JSON cu acțiuni hover/click și previzualizări de item-uri.

⚙️ Instalare

📥 Configurare

• Obține pluginul SkBee .jar dintr-o sursă oficială de descărcare și pune-l în directorul serverului plugins/ împreună cu Skript.
• Repornește serverul pentru ca Skript și addon-urile lui să se încarce corect.
• Verifică logurile din consola serverului pentru a confirma că SkBee s-a încărcat cu succes și a detectat versiunea de Skript instalată.

📦 Dependențe

• Skript (SkBee este un addon pentru Skript; build-urile recente SkBee necesită versiuni recente de Skript — verifică notele de release ale pluginului pentru versiunile exacte necesare de Skript).

🧠 Note tehnice

• SkBee este întreținut ca proiect open-source sub licența GPL-3.0.
• Funcțiile diferite pot fi dependente de versiune: unele elemente (de exemplu gestionarea NBT) au note de compatibilitate pentru versiuni mai vechi de Minecraft (exemplele din documentația upstream indică disponibilitate de la 1.8.8+ pentru unele funcții și 1.13+ pentru altele).
• SkBee oferă JavaDocs și un wiki pentru sintaxe; consultă aceste referințe când scrii fișiere Skript care folosesc funcțiile SkBee.
• SkBee își propune să suporte versiuni recente de Skript și versiuni recente de Minecraft; versiunile exacte necesare de Skript sau Minecraft diferă în funcție de release-ul SkBee — verifică notele de release pentru build-ul pe care îl descarci.

🤝 Când este util acest plugin

Dacă te bazezi pe Skript ca sistem de scripting al serverului și ai nevoie de acces la NBT, mesaje text structurate, rețete personalizate, salvarea/lipirea structurilor sau instrumente simple pentru crearea de region-uri și world-uri fără a scrie Java, SkBee oferă un set amplu de sintaxe și utilitare confirmate pentru a extinde ceea ce poți implementa exclusiv în Skript.