Comandos e segurança
Comandos #
Alias: /vr. Permissão: veloroad.use (operadores por padrão). O plugin ainda permite apenas o console e operadores reais; blocos de comando e outros remetentes são recusados.
| Comando | O que faz |
|---|---|
/veloroad list | Lista os plugins. |
/veloroad info <plugin> | Mostra os detalhes de um plugin. |
/veloroad load <jar> | Carrega um jar. |
/veloroad reload <plugin> [all [install]] [force] | Substituição gerenciada com backup e reversão. all prepara a atualização nos servidores configurados da mesma máquina; adicione install apenas se os servidores vinculados que não têm o plugin devem recebê-lo. |
/veloroad check <plugin> | Pré-visualização de compatibilidade somente leitura. |
/veloroad doctor [plugin] | Audita a pasta de plugins sem alterar nada. |
/veloroad backups <plugin> | Lista os backups salvos. |
/veloroad restore <plugin> [latest|number] [force] | Restaura um backup. |
/veloroad unload <plugin> confirm [force] | Descarrega um plugin. |
/veloroad enable <plugin> e /veloroad disable <plugin> [force] | Ativa ou desativa um plugin. |
/veloroad history [plugin] [count] | Mostra o log de auditoria. |
/veloroad reloadconfig | Recarrega a configuração do próprio VeloRoad. |
Diagnóstico #
/veloroad doctor verifica a pasta de plugins. Com o nome de um plugin, ele também informa:
- o caminho do jar em uso e seu SHA-256,
- os candidatos de atualização pendentes e os jars de plugin duplicados,
- os plugins que dependem do alvo,
- o número de backups salvos e qualquer falha de integridade,
- os alvos de remapeamento do Paper inseguros ou que não podem ser resolvidos.
Controles de segurança #
- Jars que precisam de uma API de Java ou de Minecraft mais nova do que a do servidor são bloqueados antes de qualquer mudança.
- Dependências obrigatórias ausentes são detectadas. As fontes opcionais de dependências por HTTPS aceitam fixação de SHA-256, limites de tamanho e tempos limite.
- Recarregar, desativar e descarregar são bloqueados enquanto outros plugins dependerem do alvo, a menos que você adicione
force. - Uma lista configurável protege os plugins que não sobrevivem a uma recarga, como ProtocolLib, WorldEdit, WorldGuard, ViaVersion e FastAsyncWorldEdit.
- O log de auditoria é limitado e em UTF-8. As notificações opcionais do Discord não disparam menções.
force ignora um bloqueio de segurança. Ele não reinicia os plugins que dependem do alvo.
Implantação automática #
A implantação automática monitora os arquivos .jar.new e .jar.install já estabilizados e aplica as mesmas regras de verificação prévia, backup e reversão. Nomes de arquivo com versão, como Plugin-2.4.1.jar, são reconhecidos nos servidores vinculados.