BileTools - Testa i Plugin più Velocemente

Ricarica i plugin senza riavviare il server

BileTools ricarica il tuo plugin su un server di test non appena una nuova build arriva nella cartella dei plugin. I plugin che dipendono da esso si ricaricano nell'ordine corretto, e un ricaricamento fallito ripristina le vecchie versioni. Funziona anche su Velocity e può inviare build ad altri server di sviluppo.

BileTools carica, scarica ed elimina i plugin durante l'esecuzione; è consigliato solo per uso in sviluppo.

Ricarica automatica

Il watcher

• Un jar modificato si ricarica una volta che il file smette di cambiare

• Un nuovo jar si carica, con eventuali jar di dipendenza mancanti

• Un jar eliminato si scarica dopo tre secondi

• I jar ricostruiti si ricaricano insieme, prima le dipendenze

• Un nuovo jar di BileTools aggiorna BileTools stesso

Nessun ricaricamento falso

• Un controllo SHA-256 conferma che un jar è realmente cambiato

• I jar scritti a metà vengono saltati fino al completamento

• Un ricaricamento automatico fallito mette in pausa quel plugin fino a quando non lo ricarichi manualmente

• Le liste di ignorati e consentiti limitano cosa si ricarica da solo

Ricariche più sicure e rollback

Controlli prima dello smantellamento

• Dipendenze mancanti, cicli e conflitti di nomi fermano un ricaricamento prima che qualcosa venga scaricato

• Attività, listener e comandi vengono ripuliti

• I giocatori ricevono una nuova lista di comandi

• Errori durante l'attivazione di un plugin contano come un ricaricamento fallito

• I plugin possono terminare il loro lavoro o rifiutare un ricaricamento

Recupero

• Uno swap fallito carica di nuovo le vecchie versioni dell'intero gruppo

• Ogni versione che esegui è archiviata

• /bile install ripristina una versione precedente

Proxy e distribuzione remota

Proxy Velocity

• I plugin proxy ricostruiti si ricaricano con i loro dipendenti

• Gli stessi controlli e recupero si applicano

Distribuzione remota

• Il tuo server principale invia un jar ricaricato ai server di sviluppo che elenchi

• Ogni server crea la propria chiave al primo avvio

• Entrambi i lati parlano solo con le chiavi di cui ti fidi

• I jar viaggiano su TLS crittografato

• Una lista IP opzionale limita chi può connettersi

La distribuzione remota è disattivata per impostazione predefinita.

Iniziare

1. Metti il jar di BileTools in plugins/ sul tuo server di sviluppo o proxy Velocity e avvialo una volta.

2. Punta il tuo output di build a plugins/ e ricostruisci.

3. Guarda la console per il ricaricamento.

Comandi e permessi

Comandi

Alias: /bile, /bi e /b per /biletools

/bile reload <plugin>               Ricarica un plugin e le dipendenze
/bile load <plugin>                Carica un jar da plugins/
/bile unload <plugin>              Scarica un plugin e le dipendenze
/bile inspect <plugin>             Controlla se può ricaricarsi
/bile library plugin=<name>        Elenca le versioni archiviate
/bile install <plugin> version=<v> Ripristina una versione archiviata
/bile config                       Apri l'editor delle impostazioni
/biletools debug dump              Carica un rapporto diagnostico

Permessi

Permesso          Predefinito  Consente
bile.use          op          Gestire i plugin ed eliminare i jar
biletools.config   op          Editor delle impostazioni e lingua del server
biletools.debug    op          Rapporti diagnostici

Compatibilità e limiti

Funziona su: Paper, Purpur, Leaf, Folia, Canvas, Spigot, Velocity

Minecraft: 1.20.1 a 26.3 su Java 17 o versioni successive. I server 26.x richiedono Java 25

• Piattaforme Paper, Purpur e Leaf sono i principali obiettivi. Velocity ha bisogno di 3.4 o versioni successive. Su Folia e Canvas, i plugin devono pulire il proprio lavoro di regione. Spigot ha bisogno di permessi per creare collegamenti simbolici.

• Integrazioni I plugin possono funzionare con i ricaricamenti attraverso l'interfaccia ReloadAware di VolmLib.

• Lingue Inglese più 17 traduzioni, per ogni giocatore o per l'intero server. Il proxy è solo in inglese.

• Rete Scarica le proprie librerie e qualsiasi traduzione che scegli. Controlla GitHub per aggiornamenti. I rapporti di debug vengono caricati su mclo.gs a meno che non aggiungi upload=false. Ascolta solo sulla porta 9876 quando riceve distribuzioni.

• Limiti Lo stato statico, i thread privati e i ganci dei pacchetti necessitano della pulizia del plugin stesso. Il recupero non può annullare i cambiamenti di dati o di mondo. Su Paper, un nuovo jar con paper-plugin.yml necessita di un riavvio. BileTools non può ricaricarsi su Velocity.

Domande, suggerimenti e segnalazioni di bug sono benvenuti su Discord o GitHub.

Codice sorgente • Documentazione • Discord