Minecraft-plugin SkBee

🔌 Om SkBee

SkBee er et addon til Skript, der udvider Skript-sproget med en bred samling elementer, som gør serverens interne dele og moderne Minecraft-funktioner tilgængelige for scriptforfattere. Det giver syntaks og værktøjer til at arbejde med NBT, avancerede tekstkomponenter, scoreboards, recipes, blockdata, structures, world creation og simple regioner/grænser — så serveradministratorer kan implementere komplekse mekanikker med Skript i stedet for Java.

🎯 Formål

SkBees primære formål er at give Skript-brugere direkte adgang til funktioner i Bukkit/Paper server-API'erne og Minecrafts interne dele, som ellers er svære eller umulige at opnå med vanilla Skript. Det er beregnet til serverejere og scripters, der har brug for mere præcis kontrol over items, entities, tekstformatering, world-manipulation og håndtering af structures inde i Skript-scripts.

⚙️ Funktioner

• NBT-elementer: hent/sæt NBT for items, tile entities (blocks) og entities (angivet som tilgængeligt for ældre versioner ned til 1.8.8+ hvor det understøttes).
• FastBoards: en scoreboard-implementering designet til at reducere flicker (tilgængelig på nyere Minecraft-versioner hvor det understøttes).
• Recipes: tilføj brugerdefinerede recipes og fjern vanilla recipes (funktioner angivet som tilgængelige fra senere versioner, f.eks. 1.13+ for recipe APIs).
• BlockData: forenklet adgang til at hente/sætte block data for moderne block states (tilgængelig på understøttede versioner).
• Structures: gem og indsæt vanilla Minecraft structures ved hjælp af spillets structure-system.
• TextComponents: byg og manipulér JSON/TextComponent-lignende beskeder med hover- og click-events samt støtte til item-hover.
• WorldCreator: opret brugerdefinerede worlds med konfigurerbare muligheder eksponeret til Skript.
• Bounds: opret simple bounds/regions, der minder om let region-beskyttelse til brug i Skript.
• GameEvents: kobling til Minecrafts GameEvent-system (bruges af skulk sensors og relaterede mekanikker).

🧩 Hvem er det til

• Serveradministratorer, der bruger Skript og har brug for dybere API-adgang uden at skrive Java-plugins.
• Skript-udviklere, der bygger avancerede GUI'er, brugerdefinerede items, strukturerede beskeder eller værktøjer til worlds/structures.
• Survival-, SMP- og brugerdefinerede spilservere, der er afhængige af Skript til gameplay-mekanikker og vil udvide funktionaliteten.

🏗️ Eksempler på brug

• En scripter læser og ændrer item-NBT for at implementere brugerdefineret item-adfærd og attributter inde i Skript.
• En admin opretter brugerdefinerede crafting recipes og fjerner uønskede vanilla recipes med Skript-syntaks.
• Designere gemmer og indsætter færdigbyggede structures under world generation eller med byggeværktøjer i spillet.
• Chat- eller GUI-systemer, der har brug for JSON text components med hover/click-handlinger og item-forhåndsvisninger.

⚙️ Installation

📥 Opsætning

• Hent SkBee-pluginnet .jar fra en officiel downloadkilde og placer det i serverens plugins/-mappe sammen med Skript.
• Genstart serveren, så Skript og dens addons indlæses korrekt.
• Tjek serverens konsollogs for at bekræfte, at SkBee blev indlæst succesfuldt, og at den opdagede den installerede Skript-version.

📦 Afhængigheder

• Skript (SkBee er et addon til Skript; nyere SkBee-builds kræver nyere Skript-udgivelser — tjek pluginets release notes for de præcise påkrævede Skript-versioner).

🧠 Tekniske noter

• SkBee vedligeholdes som et open-source-projekt under GPL-3.0-licensen.
• Forskellige funktioner kan være versionslåste: nogle elementer (for eksempel NBT-håndtering) har kompatibilitetsnoter til ældre Minecraft-udgivelser (eksempler i upstream-dokumentationen henviser til tilgængelighed fra 1.8.8+ for nogle funktioner og 1.13+ for andre).
• SkBee leverer JavaDocs og en wiki til syntakser; brug disse referencer, når du skriver Skript-filer, der bruger SkBee-funktioner.
• SkBee sigter mod at understøtte nyere Skript-udgivelser og nyere Minecraft-udgivelser; specifikke påkrævede Skript- eller Minecraft-versioner varierer efter SkBee-udgivelse — verificér release notes for den build, du downloader.

🤝 Hvornår dette plugin er nyttigt

Hvis du bruger Skript som dit server scripting-system og har brug for adgang til NBT, strukturerede tekstbeskeder, brugerdefinerede recipes, gemning/indsættelse af structures eller enkle værktøjer til region- og world-oprettelse uden at skrive Java, tilbyder SkBee en bred samling bekræftede syntakser og værktøjer til at udvide det, du kan implementere udelukkende i Skript.