Minecraft plugin SkBee

🔌 Over SkBee

SkBee is een addon voor Skript die de Skript-taal uitbreidt met een brede set elementen die serverinternals en moderne Minecraft-functies beschikbaar maken voor scriptauteurs. Het biedt syntaxis en hulpmiddelen voor het werken met NBT, geavanceerde tekstcomponenten, scoreboards, recepten, blockdata, structuren, wereldcreatie en eenvoudige region/bounds — zodat serverbeheerders complexe mechanieken kunnen implementeren met Skript in plaats van Java.

🎯 Doel

Het belangrijkste doel van SkBee is om Skript-gebruikers directe toegang te geven tot functies van de Bukkit/Paper server-API's en Minecraft-internals die anders moeilijk of onmogelijk te bereiken zijn met vanilla Skript. Het is bedoeld voor servereigenaars en scripters die nauwkeurigere controle nodig hebben over items, entities, tekstopmaak, wereldmanipulatie en structuuropeningen binnen Skript-scripts.

⚙️ Functies

• NBT-elementen: NBT van items, tile entities (blokken) en entities ophalen/instellen (genoemd als beschikbaar voor oudere versies tot 1.8.8+ waar ondersteund).
• FastBoards: een scoreboard-implementatie die is ontworpen om flicker te verminderen (beschikbaar op nieuwere Minecraft-versies waar ondersteund).
• Recipes: aangepaste recepten toevoegen en vanilla recepten verwijderen (functies vermeld als beschikbaar vanaf latere versies, bijvoorbeeld 1.13+ voor recipe API's).
• BlockData: vereenvoudigde toegang om block data op te halen/in te stellen voor moderne block states (beschikbaar op ondersteunde versies).
• Structures: vanilla Minecraft-structuren opslaan en plakken met behulp van het structuursysteem van het spel.
• TextComponents: JSON/TextComponent-achtige berichten bouwen en bewerken met hover- en click-events en ondersteuning voor item-hover.
• WorldCreator: aangepaste werelden maken met configureerbare opties die aan Skript worden aangeboden.
• Bounds: eenvoudige bounds/regions maken die lijken op lichte region-beveiliging voor gebruik in Skript.
• GameEvents: koppelen aan het GameEvent-systeem van Minecraft (gebruikt door skulk sensors en gerelateerde mechanieken).

🧩 Voor wie is het

• Serverbeheerders die Skript gebruiken en diepere API-toegang nodig hebben zonder Java-plugins te schrijven.
• Skript-ontwikkelaars die geavanceerde GUI's, aangepaste items, gestructureerde berichten of tools voor worlds/structuren bouwen.
• Survival-, SMP- en aangepaste game-servers die op Skript vertrouwen voor gameplay-mechanieken en hun functionaliteit willen uitbreiden.

🏗️ Voorbeelden van gebruik

• Een scripter leest en wijzigt item-NBT om aangepast itemgedrag en attributen binnen Skript te implementeren.
• Een beheerder maakt aangepaste crafting-recepten en verwijdert ongewenste vanilla-recepten met Skript-syntaxis.
• Ontwerpers slaan vooraf gebouwde structuren op en plakken ze tijdens world-generation of met in-game bouwtools.
• Chat- of GUI-systemen die JSON-tekstcomponenten nodig hebben met hover/click-acties en itemvoorbeelden.

⚙️ Installatie

📥 Setup

• Verkrijg de SkBee .jar-plugin van een officiële downloadbron en plaats deze in de plugins/-map van de server naast Skript.
• Start de server opnieuw op zodat Skript en de addons netjes laden.
• Controleer de consolelogs van de server om te bevestigen dat SkBee succesvol is geladen en de geïnstalleerde Skript-versie heeft gedetecteerd.

📦 Afhankelijkheden

• Skript (SkBee is een addon voor Skript; recente SkBee-builds vereisen recente Skript-releases — controleer de release-opmerkingen van de plugin voor de exacte vereiste Skript-versies).

🧠 Technische opmerkingen

• SkBee wordt onderhouden als een open-sourceproject onder de GPL-3.0-licentie.
• Verschillende functies kunnen versiegebonden zijn: sommige elementen (bijvoorbeeld NBT-afhandeling) hebben compatibiliteitsnotities voor oudere Minecraft-releases (voorbeelden in upstream-documentatie verwijzen naar beschikbaarheid vanaf 1.8.8+ voor sommige functies en 1.13+ voor andere).
• SkBee biedt JavaDocs en een wiki voor syntaxis; raadpleeg die bronnen wanneer je Skript-bestanden schrijft die SkBee-functies gebruiken.
• SkBee streeft ernaar recente Skript-releases en recente Minecraft-releases te ondersteunen; specifieke vereiste Skript- of Minecraft-versies verschillen per SkBee-release — controleer de release-opmerkingen voor de build die je downloadt.

🤝 Wanneer deze plugin nuttig is

Als je Skript gebruikt als je server-scripting systeem en toegang nodig hebt tot NBT, gestructureerde tekstberichten, aangepaste recepten, het opslaan/plakken van structuren, of eenvoudige tools voor region- en wereldcreatie zonder Java te schrijven, biedt SkBee een brede set bevestigde syntaxis en hulpmiddelen om uit te breiden wat je puur in Skript kunt implementeren.