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 falhada 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.

Recarregamento automático

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 falhada pausa aquele plugin até que você o recarregue manualmente

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

Recarregamentos mais seguros e rollback

Verificações antes da desmontagem

• Dependências ausentes, ciclos e conflitos de nome impedem uma recarga antes que qualquer coisa seja descarregada

• Tarefas, ouvintes e comandos são limpos

• Os jogadores recebem uma nova lista de comandos

• Erros enquanto um plugin é ativado contam como uma recarga falhada

• Plugins podem terminar seu trabalho ou recusar uma recarga

Recuperação

• Uma troca falhada 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 todo o servidor. 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 hooks de pacotes precisam da limpeza do próprio plugin. A recuperação não pode desfazer alterações de dados ou 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