Minecraft-plugin SkBee

🔌 Om SkBee

SkBee är ett addon för Skript som utökar Skript-språket med en bred uppsättning element som exponerar serverns interna delar och moderna Minecraft-funktioner för skribenter av skript. Det erbjuder syntax och verktyg för att arbeta med NBT, avancerade textkomponenter, scoreboards, recipes, blockdata, structures, world creation och enkla regioner/gränser — vilket låter serveradministratörer implementera komplexa mekaniker med Skript istället för Java.

🎯 Syfte

SkBee:s huvudsyfte är att ge Skript-användare direkt åtkomst till funktioner i Bukkit/Paper server-API:erna och Minecrafts interna delar som annars är svåra eller omöjliga att uppnå med vanilla Skript. Det är tänkt för serverägare och scripters som behöver mer exakt kontroll över items, entities, textformatering, world-manipulation och hantering av structures i Skript-skript.

⚙️ Funktioner

• NBT-element: hämta/ställa in NBT för items, tile entities (blocks) och entities (noterat som tillgängligt för äldre versioner ner till 1.8.8+ där det stöds).
• FastBoards: en scoreboard-implementation utformad för att minska flicker (tillgänglig på nyare Minecraft-versioner där det stöds).
• Recipes: lägg till egna recipes och ta bort vanilla recipes (funktioner noterade som tillgängliga från senare versioner, t.ex. 1.13+ för recipe APIs).
• BlockData: förenklad åtkomst för att hämta/ställa in block data för moderna block states (tillgängligt på versioner som stöds).
• Structures: spara och klistra in vanilla Minecraft structures med hjälp av spelets structuresystem.
• TextComponents: bygg och manipulera meddelanden i JSON/TextComponent-stil med hover- och click-händelser samt stöd för item-hover.
• WorldCreator: skapa egna worlds med konfigurerbara alternativ som exponeras för Skript.
• Bounds: skapa enkla bounds/regions som liknar lätt region-skydd för användning i Skript.
• GameEvents: koppla in i Minecrafts GameEvent-system (används av skulk sensors och relaterade mekaniker).

🧩 Vem är det för

• Serveradministratörer som använder Skript och behöver djupare API-åtkomst utan att skriva Java-plugins.
• Skript-utvecklare som bygger avancerade GUI:er, egna items, strukturerade meddelanden eller verktyg för world/structure.
• Survival-, SMP- och anpassade spelservrar som förlitar sig på Skript för spelmekanik och vill utöka funktionaliteten.

🏗️ Exempel på användning

• En scripter läser och ändrar item-NBT för att implementera eget itembeteende och attribut i Skript.
• En admin skapar egna crafting recipes och tar bort oönskade vanilla recipes med Skript-syntax.
• Designers sparar och klistrar in prefabricerade structures under world-generation eller med byggverktyg i spelet.
• Chatt- eller GUI-system som behöver JSON text components med hover/click-åtgärder och item-förhandsvisningar.

⚙️ Installation

📥 Setup

• Hämta SkBee-pluggen .jar från en officiell nedladdningskälla och placera den i serverns plugins/-katalog tillsammans med Skript.
• Starta om servern så att Skript och dess addons laddas rent.
• Kontrollera serverns konsollogg för att bekräfta att SkBee laddades framgångsrikt och att den upptäckte den installerade Skript-versionen.

📦 Beroenden

• Skript (SkBee är ett addon för Skript; nyare SkBee-byggnader kräver nyare Skript-utgåvor — kontrollera pluginets release notes för exakta erforderliga Skript-versioner).

🧠 Tekniska noteringar

• SkBee underhålls som ett open-source-projekt under GPL-3.0-licensen.
• Olika funktioner kan vara versionslåsta: vissa element (till exempel NBT-hantering) har kompatibilitetsnoteringar för äldre Minecraft-utgåvor (exempel i upstream-dokumentationen hänvisar till tillgänglighet från 1.8.8+ för vissa funktioner och 1.13+ för andra).
• SkBee tillhandahåller JavaDocs och en wiki för syntaks; använd dessa referenser när du skriver Skript-filer som använder SkBee-funktioner.
• SkBee strävar efter att stödja nyare Skript-utgåvor och nyare Minecraft-utgåvor; specifika krav på Skript- eller Minecraft-versioner varierar beroende på SkBee-utgåva — kontrollera release notes för byggnaden du laddar ner.

🤝 När detta plugin är användbart

Om du förlitar dig på Skript som ditt server-scriptsystem och behöver åtkomst till NBT, strukturerade textmeddelanden, egna recipes, lagring/klistring av structures eller enkla verktyg för region- och world-skapande utan att skriva Java, erbjuder SkBee ett brett antal bekräftade syntaxer och verktyg för att utöka vad du kan implementera enbart i Skript.