Minecraft-Plugin BKCommonLib

🔌 Über BKCommonLib

BKCommonLib ist eine serverseitige Bibliothek und ein Plugin für Minecraft-Server, das Low-Level-Utilities, Reflection-Helper, Laufzeit-Remapping und kleine Frameworks zentral bündelt, sodass andere Plugins NMS (Minecraft-Server-Interna) nicht direkt verwenden müssen. Es ist als einzige Kompatibilitätsschicht konzipiert: Wenn sich bei Minecraft oder Server-Forks die Interna ändern, wird BKCommonLib aktualisiert, sodass abhängige Plugins oft selbst keine Änderungen benötigen.

🎯 Zweck

Eine stabile, wiederverwendbare Schicht für Kompatibilität und Utilities für Plugin-Entwickler und Serverbetreiber bereitstellen. BKCommonLib reduziert die Menge an versionsspezifischem Code, den Plugin-Autoren ausliefern müssen, und bietet höherstufige APIs für Packet-Handling, Konvertierungen, Command-Frameworks und andere Low-Level-Operationen.

⚙️ Funktionen

• Laufzeit-Generierung und Remapping von Klassen über das Mountiplex Reflection/Template-System.
• Integrierte Utilities für das Command-Framework (Integration mit Cloud Command Framework).
• Basis-Framework für Plugins mit Lifecycle-Helpern, Abhängigkeitsprüfungen und praktischen APIs zum Registrieren von Listenern und Befehlen.
• Typkonvertierungs-Utilities (automatische Konvertierungen zwischen Bukkit-Typen und internen Typen, wo erforderlich).
• Utilities und Kompatibilitäts-Wrapper für viele Server-Forks und Versionen, damit Plugins NMS nicht direkt verwenden müssen.

🧩 Für wen es gedacht ist

• Plugin-Entwickler, die eine Multi-Version-Kompatibilitätsschicht und Reflection-Utilities möchten.
• Serveradministratoren, die Netzwerke mit vielen Drittanbieter-Plugins betreiben, die auf eine gemeinsame Kompatibilitätsbibliothek angewiesen sind.
• Technische Serverbetreiber, die konsistentes Verhalten über Paper/Spigot-Forks hinweg benötigen.

🏗️ Beispielanwendungsfälle

• Ein Plugin verwendet BKCommonLib, um Packet-Unterschiede zwischen Minecraft-Versionen zu handhaben, sodass das Plugin-JAR selbst über Updates hinweg unverändert bleiben kann.
• Ein Entwickler nutzt die enthaltenen Utilities des Command-Frameworks, um annotierte Befehle mit Vorschlagsunterstützung und Berechtigungsbehandlung umzusetzen.
• Ein Server betreibt Plugins, die von BKCommonLib abhängen, um die Häufigkeit unmittelbarer Updates nach einer Minecraft-Veröffentlichung zu reduzieren.

⚙️ Installation

📥 Einrichtung

• Lade das offizielle BKCommonLib-JAR aus der offiziellen Distribution des Plugins herunter (lege das bereitgestellte JAR in den Ordner plugins/ deines Servers).
• Starte den Server neu, damit das Plugin beim Start geladen wird.
• Prüfe die Konsolenausgabe des Servers auf BKCommonLib-Startmeldungen, um zu bestätigen, dass es korrekt initialisiert wurde.

📦 Abhängigkeiten

• BKCommonLib wird als Bibliotheks-Plugin verteilt; für die Kernbibliothek selbst sind keine zusätzlichen Bukkit/Spigot-Plugin-Abhängigkeiten erforderlich.

🧠 Technische Hinweise

• Zu den bestätigten kompatiblen Server-Softwareversionen gehören Spigot und Paper-Forks (das Projekt listet ausdrücklich Spigot, PaperMC, Purpur und andere gängige Forks auf).
• Das Projekt gibt Kompatibilität mit Minecraft-Versionen 1.8 und neuer an, wenn der neueste BKCommonLib-Build verwendet wird.
• BKCommonLib wird unter der MIT-Lizenz veröffentlicht.
• Das Projekt bündelt/verschattet Drittanbieter-Bibliotheken (zum Beispiel Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML und Gson), wie vom Autor angegeben.

🤝 Wann dieses Plugin nützlich ist

Wenn du Plugins pflegst oder einen Server betreibst, auf dem mehrere Plugins konsistenten Zugriff auf Low-Level-Serverfunktionen benötigen, ohne dass jedes Plugin NMS selbst handhabt, bietet BKCommonLib eine gemeinsame Kompatibilitätsschicht und Entwickler-Utilities, die versionsspezifischen Code pro Plugin und den Wartungsaufwand reduzieren.