BileTools - Test-Plugins schneller

Plugins ohne Neustart des Servers neu laden

BileTools lädt Ihr Plugin auf einem Testserver, sobald ein neuer Build im Plugins-Ordner landet. Plugins, die davon abhängen, werden in der richtigen Reihenfolge neu geladen, und ein fehlgeschlagener Reload stellt die alten Versionen wieder her. Es läuft auch auf Velocity und kann Builds auf andere Entwicklungsserver übertragen.

BileTools lädt, entlädt und löscht Plugins zur Laufzeit; es wird nur für die Entwicklung empfohlen.

Automatisches Hot Reload

Der Watcher

• Eine geänderte JAR wird neu geladen, sobald die Datei nicht mehr geändert wird

• Eine neue JAR wird geladen, mit allen fehlenden Abhängigkeits-JARs

• Eine gelöschte JAR wird nach drei Sekunden entladen

• Wiederaufgebaute JARs werden zusammen neu geladen, Abhängigkeiten zuerst

• Eine neue BileTools-JAR aktualisiert BileTools selbst

Keine falschen Reloads

• Eine SHA-256-Prüfung bestätigt, dass eine JAR sich wirklich geändert hat

• Halbgeschriebene JARs werden übersprungen, bis sie vollständig sind

• Ein fehlgeschlagener automatischer Reload pausiert dieses Plugin, bis Sie es manuell neu laden

• Ignorieren- und Erlauben-Listen beschränken, was sich von selbst neu lädt

Sicherere Reloads und Rollbacks

Überprüfungen vor dem Teardown

• Fehlende Abhängigkeiten, Zyklen und Namenskonflikte stoppen einen Reload, bevor etwas entladen wird

• Aufgaben, Listener und Befehle werden bereinigt

• Spieler erhalten eine frische Befehlsliste

• Fehler, während ein Plugin aktiviert wird, zählen als fehlgeschlagener Reload

• Plugins können ihre Arbeit beenden oder einen Reload ablehnen

Wiederherstellung

• Ein fehlgeschlagener Swap lädt die alten Versionen der gesamten Gruppe zurück

• Jede Version, die Sie ausführen, wird archiviert

• /bile install stellt eine ältere Version wieder her

Proxys und Remote-Deployment

Velocity-Proxys

• Wiederaufgebaute Proxy-Plugins werden mit ihren Abhängigkeiten neu geladen

• Die gleichen Überprüfungen und Wiederherstellungen gelten

Remote-Deployment

• Ihr Hauptserver überträgt eine neu geladene JAR an die Entwicklungsserver, die Sie auflisten

• Jeder Server erstellt seinen eigenen Schlüssel beim ersten Start

• Beide Seiten kommunizieren nur mit Schlüsseln, denen Sie vertrauen

• JARs werden über verschlüsseltes TLS übertragen

• Eine optionale IP-Liste beschränkt, wer sich verbinden kann

Remote-Deployment ist standardmäßig deaktiviert.

Erste Schritte

1. Legen Sie die BileTools-JAR in plugins/ auf Ihrem Entwicklungsserver oder Velocity-Proxy und starten Sie ihn einmal.

2. Richten Sie Ihre Build-Ausgabe auf plugins/ und bauen Sie neu.

3. Überwachen Sie die Konsole für den Reload.

Befehle und Berechtigungen

Befehle

Aliase: /bile, /bi und /b für /biletools

/bile reload <plugin>               Reload a plugin and dependents
/bile load <plugin>                 Load a jar from plugins/
/bile unload <plugin>               Unload a plugin and dependents
/bile inspect <plugin>              Check if it can reload
/bile library plugin=<name>         List archived versions
/bile install <plugin> version=<v>  Restore an archived version
/bile config                        Open the settings editor
/biletools debug dump               Upload a diagnostic report

Berechtigungen

Permission        Default  Allows
bile.use          op       Manage plugins and delete jars
biletools.config  op       Settings editor and server language
biletools.debug   op       Diagnostic reports

Kompatibilität und Grenzen

Läuft auf: Paper, Purpur, Leaf, Folia, Canvas, Spigot, Velocity

Minecraft: 1.20.1 bis 26.3 auf Java 17 oder neuer. 26.x-Server benötigen Java 25

• Plattformen Paper, Purpur und Leaf sind die Hauptziele. Velocity benötigt 3.4 oder neuer. Auf Folia und Canvas müssen Plugins ihre eigenen Regionsarbeiten bereinigen. Spigot benötigt Berechtigungen, um symbolische Links zu erstellen.

• Integrationen Plugins können mit Reloads über VolmLibs ReloadAware-Schnittstelle arbeiten.

• Sprachen Englisch plus 17 Übersetzungen, für jeden Spieler oder den gesamten Server. Der Proxy ist nur auf Englisch.

• Netzwerk Lädt seine Bibliotheken und jede Übersetzung, die Sie auswählen. Überprüft GitHub auf Updates. Debug-Berichte werden hochgeladen zu mclo.gs es sei denn, Sie fügen upload=false. Lauscht nur auf Port 9876, wenn Deployments empfangen werden.

• Grenzen Statischer Zustand, private Threads und Paket-Hooks benötigen die eigene Bereinigung des Plugins. Die Wiederherstellung kann keine Daten- oder Weltänderungen rückgängig machen. Auf Paper benötigt eine neue JAR mit paper-plugin.yml einen Neustart. BileTools kann sich auf Velocity nicht neu laden.

Fragen, Vorschläge und Fehlerberichte sind auf Discord oder GitHub willkommen.

Quellcode • Dokumentation • Discord