Minecraft-Plugin SkBee

🔌 Über SkBee

SkBee ist ein Skript-Addon, das die Skript-Sprache um eine große Menge an Elementen erweitert, die Server-Interna und moderne Minecraft-Funktionen für Skript-Autoren zugänglich machen. Es bietet Syntaxen und Hilfsfunktionen für die Arbeit mit NBT, erweiterten Textkomponenten, Scoreboards, Rezepten, Blockdaten, Strukturen, Welterstellung und einfachen Regionen/Grenzen — sodass Server-Administratoren komplexe Mechaniken mit Skript statt mit Java umsetzen können.

🎯 Zweck

Der Hauptzweck von SkBee ist es, Skript-Nutzern direkten Zugriff auf Funktionen der Bukkit/Paper-Server-APIs und auf Minecraft-Interna zu geben, die mit normalem Skript sonst schwer oder gar nicht erreichbar wären. Es richtet sich an Serverbesitzer und Skripter, die innerhalb von Skript-Skripten eine präzisere Kontrolle über Items, Entitäten, Textformatierung, Weltmanipulation und den Umgang mit Strukturen benötigen.

⚙️ Funktionen

• NBT-Elemente: NBT von Items, Tile Entities (Blöcken) und Entitäten lesen/setzen (als für ältere Versionen bis 1.8.8+ verfügbar vermerkt, sofern unterstützt).
• FastBoards: eine Scoreboard-Implementierung, die Flackern reduzieren soll (auf neueren Minecraft-Versionen verfügbar, sofern unterstützt).
• Rezepte: eigene Rezepte hinzufügen und Vanilla-Rezepte entfernen (Funktionen laut Hinweis ab neueren Versionen verfügbar, z. B. 1.13+ für Recipe-APIs).
• BlockData: vereinfachter Zugriff zum Lesen/Setzen von Blockdaten für moderne Blockzustände (auf unterstützten Versionen verfügbar).
• Strukturen: Vanilla-Minecraft-Strukturen mit dem Struktur-System des Spiels speichern und einfügen.
• TextComponents: JSON/TextComponent-Nachrichten mit Hover- und Klick-Events sowie Item-Hover-Unterstützung erstellen und bearbeiten.
• WorldCreator: benutzerdefinierte Welten mit konfigurierbaren Optionen erstellen, die Skript zur Verfügung stehen.
• Bounds: einfache Bounds/Regionen erstellen, ähnlich einer leichten Regionssicherung, für die Verwendung in Skript.
• GameEvents: in das GameEvent-System von Minecraft einhaken (verwendet von Skulk-Sensoren und ähnlichen Mechaniken).

🧩 Für wen es ist

• Serveradministratoren, die Skript verwenden und tieferen API-Zugriff ohne Java-Plugins brauchen.
• Skript-Entwickler, die fortgeschrittene GUIs, benutzerdefinierte Items, strukturierte Nachrichten oder Welt-/Struktur-Tools bauen.
• Survival-, SMP- und Custom-Game-Server, die für Gameplay-Mechaniken auf Skript setzen und ihre Funktionen erweitern möchten.

🏗️ Beispiel-Anwendungsfälle

• Ein Skripter liest und verändert Item-NBT, um benutzerdefiniertes Item-Verhalten und Attribute in Skript umzusetzen.
• Ein Admin erstellt benutzerdefinierte Crafting-Rezepte und entfernt unerwünschte Vanilla-Rezepte mit Skript-Syntax.
• Designer speichern vorgefertigte Strukturen und fügen sie während der Welterzeugung oder mit Bauwerkzeugen im Spiel ein.
• Chat- oder GUI-Systeme, die JSON-Textkomponenten mit Hover-/Klick-Aktionen und Item-Vorschauen benötigen.

⚙️ Installation

📥 Einrichtung

• Besorge dir das SkBee-Plugin .jar von einer offiziellen Download-Quelle und lege es zusammen mit Skript im Verzeichnis plugins/ des Servers ab.
• Starte den Server neu, damit Skript und seine Addons sauber geladen werden.
• Prüfe die Konsolenlogs des Servers, um zu bestätigen, dass SkBee erfolgreich geladen wurde und die installierte Skript-Version erkannt hat.

📦 Abhängigkeiten

• Skript (SkBee ist ein Addon für Skript; neuere SkBee-Builds benötigen aktuelle Skript-Versionen — prüfe die Release-Notes des Plugins für die genau benötigten Skript-Versionen).

🧠 Technische Hinweise

• SkBee wird als Open-Source-Projekt unter der GPL-3.0-Lizenz gepflegt.
• Verschiedene Funktionen können versionsabhängig sein: Einige Elemente (zum Beispiel NBT-Verarbeitung) haben Kompatibilitätshinweise für ältere Minecraft-Versionen (die Originaldokumentation verweist für einige Funktionen auf Verfügbarkeit ab 1.8.8+ und für andere ab 1.13+).
• SkBee bietet JavaDocs und ein Wiki für die Syntaxen; nutze diese Referenzen beim Schreiben von Skript-Dateien, die SkBee-Funktionen verwenden.
• SkBee zielt darauf ab, aktuelle Skript- und Minecraft-Versionen zu unterstützen; die jeweils erforderlichen Skript- oder Minecraft-Versionen variieren je nach SkBee-Version — prüfe die Release-Notes des Builds, den du herunterlädst.

🤝 Wann dieses Plugin nützlich ist

Wenn du Skript als Skript-System deines Servers verwendest und Zugriff auf NBT, strukturierte Textnachrichten, benutzerdefinierte Rezepte, Speichern/Einfügen von Strukturen oder einfache Tools zur Regions- und Welterstellung brauchst, ohne Java zu schreiben, bietet SkBee eine breite Auswahl an bestätigten Syntaxen und Hilfsfunktionen, um das, was du rein mit Skript umsetzen kannst, zu erweitern.