BileTools - Teste Plugins Mais Rápido

Recarregar plugins sem reiniciar o servidor

BileTools recarrega seu plugin em um servidor de teste assim que uma nova versão chega na pasta de plugins. Plugins que dependem dele são recarregados na ordem correta, e uma recarga falha restaura as versões antigas. Ele também funciona no Velocity e pode enviar versões para outros servidores de desenvolvimento.

BileTools carrega, descarrega e exclui plugins em tempo de execução; é recomendado apenas para uso em desenvolvimento.

Recarga automática

O observador

• Um jar alterado recarrega assim que o arquivo para de mudar

• Um novo jar carrega, com quaisquer jars de dependência ausentes

• Um jar excluído descarrega após três segundos

• Jars reconstruídos recarregam juntos, dependências primeiro

• Um novo jar do BileTools atualiza o próprio BileTools

Sem recargas falsas

• Uma verificação SHA-256 confirma que um jar realmente mudou

• Jars meio escritos são ignorados até estarem completos

• Uma recarga automática falha pausa aquele plugin até que você o recarregue manualmente

• Listas de ignorar e permitir limitam o que recarrega por conta própria

Recargas mais seguras e rollback

Verificações antes da desmontagem

• Dependências ausentes, ciclos e conflitos de nomes impedem uma recarga antes que algo seja descarregado

• Tarefas, ouvintes e comandos são limpos

• Os jogadores recebem uma nova lista de comandos

• Erros enquanto um plugin é habilitado contam como uma recarga falha

• Plugins podem terminar seu trabalho ou recusar uma recarga

Recuperação

• Uma troca falha carrega de volta as versões antigas de todo o grupo

• Cada versão que você executa é arquivada

• /bile install restaura uma versão arquivada

Proxies e implantação remota

Proxies Velocity

• Plugins de proxy reconstruídos recarregam com seus dependentes

• As mesmas verificações e recuperação se aplicam

Implantação remota

• Seu servidor principal envia um jar recarregado para os servidores de desenvolvimento que você listar

• Cada servidor cria sua própria chave na primeira inicialização

• Ambos os lados só se comunicam com chaves em que você confia

• Jars viajam por TLS criptografado

• Uma lista de IP opcional limita quem pode se conectar

A implantação remota está desativada por padrão.

Começando

1. Coloque o jar do BileTools em plugins/ no seu servidor de desenvolvimento ou proxy Velocity e inicie-o uma vez.

2. Aponte sua saída de build para plugins/ e reconstrua.

3. Observe o console para a recarga.

Comandos e permissões

Comandos

Aliases: /bile, /bi e /b para /biletools

/bile reload <plugin>              Recarrega um plugin e dependentes
/bile load <plugin>                Carrega um jar de plugins/
/bile unload <plugin>              Descarrega um plugin e dependentes
/bile inspect <plugin>             Verifica se pode recarregar
/bile library plugin=<name>        Lista versões arquivadas
/bile install <plugin> version=<v>  Restaura uma versão arquivada
/bile config                       Abre o editor de configurações
/biletools debug dump              Envia um relatório de diagnóstico

Permissões

Permissão         Padrão  Permite
bile.use          op       Gerenciar plugins e excluir jars
biletools.config   op       Editor de configurações e idioma do servidor
biletools.debug    op       Relatórios de diagnóstico

Compatibilidade e limites

Funciona em: Paper, Purpur, Leaf, Folia, Canvas, Spigot, Velocity

Minecraft: 1.20.1 a 26.3 no Java 17 ou mais recente. Servidores 26.x requerem Java 25

• Plataformas Paper, Purpur e Leaf são os principais alvos. Velocity precisa de 3.4 ou mais recente. Em Folia e Canvas, plugins devem limpar seu próprio trabalho de região. Spigot precisa de permissão para criar links simbólicos.

• Integrações Plugins podem funcionar com recargas através da interface ReloadAware da VolmLib.

• Idiomas Inglês mais 17 traduções, para cada jogador ou para o servidor inteiro. O proxy é apenas em inglês.

• Rede Baixa suas bibliotecas e qualquer tradução que você escolher. Verifica o GitHub para atualizações. Relatórios de depuração são enviados para mclo.gs a menos que você adicione upload=false. Escuta na porta 9876 apenas ao receber implantações.

• Limites Estado estático, threads privadas e ganchos de pacotes precisam da limpeza do próprio plugin. A recuperação não pode desfazer dados ou mudanças de mundo. No Paper, um novo jar com paper-plugin.yml precisa de um reinício. O BileTools não pode se recarregar no Velocity.

Perguntas, sugestões e relatórios de bugs são bem-vindos no Discord ou GitHub.

Código Fonte • Documentação • Discord