BileTools - Test Plugins Sneller

Herlaad plugins zonder de server opnieuw op te starten

BileTools herlaadt je plugin op een testserver zodra er een nieuwe build in de plugins-map komt. Plugins die ervan afhankelijk zijn, worden in de juiste volgorde herladen, en een mislukte herlaad zet de oude versies terug. Het werkt ook op Velocity en kan builds naar andere ontwikkelservers pushen.

BileTools laadt, ontlaadt en verwijdert plugins tijdens runtime; het wordt alleen aanbevolen voor ontwikkelingsgebruik.

Automatische hot reload

De watcher

• Een gewijzigde jar herlaadt zodra het bestand stopt met veranderen

• Een nieuwe jar laadt, met eventuele ontbrekende afhankelijkheidsjars

• Een verwijderde jar ontlaadt na drie seconden

• Hernieuwde jars herladen samen, afhankelijkheden eerst

• Een nieuwe BileTools jar werkt BileTools zelf bij

Geen valse herlaads

• Een SHA-256 controle bevestigt dat een jar echt is veranderd

• Halfgeschreven jars worden overgeslagen totdat ze compleet zijn

• Een mislukte automatische herlaad pauzeert die plugin totdat je het handmatig herlaadt

• Negeer- en toestemmingslijsten beperken wat automatisch herlaadt

Veiligere herlaads en rollback

Controles voor teardown

• Ontbrekende afhankelijkheden, cycli en naamconflicten stoppen een herlaad voordat iets ontlaadt

• Taken, luisteraars en commando's worden opgeruimd

• Spelers krijgen een nieuwe commando-lijst

• Fouten tijdens het inschakelen van een plugin tellen als een mislukte herlaad

• Plugins kunnen hun werk afmaken of een herlaad weigeren

Herstel

• Een mislukte swap laadt de oude versies van de hele groep terug

• Elke versie die je draait wordt gearchiveerd

• /bile install zet een oudere versie terug

Proxies en remote deploy

Velocity proxies

• Hernieuwde proxy-plugins herladen met hun afhankelijkheden

• Dezelfde controles en herstel zijn van toepassing

Remote deploy

• Je hoofdserver duwt een herladen jar naar de ontwikkelservers die je opgeeft

• Elke server maakt zijn eigen sleutel bij de eerste start

• Beide zijden praten alleen met sleutels die je vertrouwt

• Jars reizen over versleutelde TLS

• Een optionele IP-lijst beperkt wie kan verbinden

Remote deploy is standaard uit.

Aan de slag

1. Plaats de BileTools jar in plugins/ op je ontwikkelserver of Velocity proxy en start het een keer.

2. Wijs je build-output aan plugins/ en bouw opnieuw.

3. Houd de console in de gaten voor de herlaad.

Commando's en permissies

Commando's

Aliassen: /bile, /bi en /b voor /biletools

/bile reload <plugin>              Herlaad een plugin en afhankelijkheden
/bile load <plugin>                Laad een jar van plugins/
/bile unload <plugin>              Ontlaad een plugin en afhankelijkheden
/bile inspect <plugin>              Controleer of het kan herladen
/bile library plugin=<name>        Lijst gearchiveerde versies
/bile install <plugin> version=<v>  Herstel een gearchiveerde versie
/bile config                        Open de instellingen editor
/biletools debug dump              Upload een diagnostisch rapport

Permissies

Permissie          Standaard  Toegestaan
bile.use           op        Beheer plugins en verwijder jars
biletools.config    op        Instellingen editor en servertaal
biletools.debug     op        Diagnostische rapporten

Compatibiliteit en limieten

Werkt op: Paper, Purpur, Leaf, Folia, Canvas, Spigot, Velocity

Minecraft: 1.20.1 tot 26.3 op Java 17 of nieuwer. 26.x servers vereisen Java 25

• Platforms Paper, Purpur en Leaf zijn de belangrijkste doelen. Velocity heeft 3.4 of nieuwer nodig. Op Folia en Canvas moeten plugins hun eigen regio-werk opruimen. Spigot heeft toestemming nodig om symbolische links te maken.

• Integraties Plugins kunnen werken met herlaads via VolmLib's ReloadAware interface.

• Talen Engels plus 17 vertalingen, voor elke speler of de hele server. De proxy is alleen in het Engels.

• Netwerk Downloadt zijn bibliotheken en elke vertaling die je kiest. Controleert GitHub op updates. Debug-rapporten worden geüpload naar mclo.gs tenzij je upload=false. Luistert alleen op poort 9876 wanneer het deploys ontvangt.

• Limieten Statische staat, privé threads en pakket hooks hebben de opruiming van de plugin zelf nodig. Herstel kan geen gegevens of wereldwijzigingen ongedaan maken. Op Paper heeft een nieuwe jar met paper-plugin.yml een herstart nodig. BileTools kan zichzelf niet herladen op Velocity.

Vragen, suggesties en bugrapporten zijn welkom op Discord of GitHub.

• •