Comandos e Permissões do CannonRTP

O CannonRTP registra seus comandos sob o namespace cannonrtp.

• Comando raiz: /cannonrtp
• Aliases: /crtp, /wc

/wc é o alias curto que a maioria dos administradores usará, mas o nó de permissão subjacente é cannonrtp.admin para todos os subcomandos.

Comandos de Administrador

Comando	Remetente	Descrição
/cannonrtp	Qualquer	Mostra o cabeçalho de ajuda seguido por todos os subcomandos registrados que o remetente pode usar
/wc help	Qualquer	Igual a /cannonrtp -- exibe a listagem de ajuda
/wc create <id>	Jogador	Cria uma nova configuração de canhão e posiciona a primeira instância na sua localização atual
/wc create <id> <display_name>	Jogador	Igual ao acima, mas define um nome de exibição personalizado (sublinhados viram espaços)
/wc place <id>	Jogador	Adiciona outra instância de um canhão existente na sua localização atual
/wc remove <id>	Jogador	Remove a instância mais próxima de <id> no seu mundo atual (o arquivo de configuração é mantido)
/wc delete <id>	Qualquer	Apaga totalmente o arquivo de configuração do canhão
/wc target <id> <world>	Jogador	Altera o mundo de pouso de destino do canhão
/wc center <id>	Jogador	Define o centro de busca do canhão para a sua localização atual
/wc list	Qualquer	Lista todas as instâncias com nome de exibição, status, tamanho da fila e último detalhe de status
/wc status	Qualquer	Mesma saída que /wc list
/wc probe	Jogador	Testa se a sua localização atual passaria por todas as verificações de proteção ativadas
/wc reload	Qualquer	Recarrega a configuração global, todas as configurações por canhão, tarefas e adaptadores de proteção
/wc setup	Jogador	Abre o menu navegador de conteúdo no estilo Nightbreak (lista os pacotes de canhão instalados e baixáveis)
/wc recommendedplugins	Qualquer	Abre o catálogo Nightbreak de plugins complementares recomendados para o CannonRTP
/wc downloadpluginupdate	Qualquer	Baixa uma versão mais recente do jar do plugin CannonRTP do Nightbreak (aplicada após a próxima reinicialização do servidor)
/wc downloadall	Qualquer	Baixa a atualização do plugin CannonRTP e todos os pacotes de conteúdo disponíveis no Nightbreak
/wc downloadallcontent	Qualquer	Baixa todos os pacotes de conteúdo do CannonRTP disponíveis no Nightbreak (apenas conteúdo, sem o jar do plugin)
/wc updatecontent	Qualquer	Baixa atualizações para pacotes de conteúdo do CannonRTP desatualizados (alias: /wc updateallcontent)
/wc forcereinstallcontent <package|all>	Qualquer	Baixa novamente o conteúdo do Nightbreak mesmo quando a cópia local já está atualizada -- use para reparar arquivos de pacote danificados ou editados manualmente. Passe all para todos os pacotes já baixados, ou use o auto-completar para um único slug de pacote Nightbreak (free-cannon-model, cannonrtp-premium-cannon-model).

/wc initialize abre a configuração inicial para jogadores com cannonrtp.admin. /wc setup abre o navegador de conteúdo. Ambos são registados; os modos predefinidos não determinam se initialize existe.

Todos os subcomandos de administrador acima exigem cannonrtp.admin.

Estes comandos do Nightbreak vêm dentro do CannonRTP

/wc setup, /wc recommendedplugins, /wc downloadpluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent e /wc forcereinstallcontent são fornecidos pela biblioteca compartilhada MagmaCore que é embutida (shaded) no CannonRTP. Eles são registrados automaticamente -- você não os vê no plugin.yml. O comando separado /nightbreaklogin <token> (também do MagmaCore) registra o token da sua conta Nightbreak para downloads premium.

Consulte a página Pacotes de Conteúdo para detalhes sobre o que /wc setup, /wc downloadall e /wc updatecontent realmente gerenciam.

create vs place vs remove vs delete

Uma configuração de canhão (plugins/CannonRTP/cannons/<id>.yml) pode controlar várias instâncias no mundo. create cria a configuração e gera a primeira instância. place adiciona outra instância a uma configuração existente. remove apaga uma instância (a mais próxima de você no seu mundo), mas mantém a configuração. delete apaga o arquivo de configuração por completo, removendo todas as instâncias.

Interação do Jogador

Não existe comando de jogador para ativar um canhão. Os jogadores usam o CannonRTP entrando no raio de ativação do canhão (triggerRadius, padrão 1.75 blocos).

Permissões

Dois nós de permissão estão registrados no plugin.yml:

Permissão	Padrão	Descrição
cannonrtp.admin	op	Necessária para todo subcomando de administrador (incluindo os comandos do Nightbreak embutidos setup / downloadall / updatecontent)
cannonrtp.use	true	Necessária para que um jogador possa acionar qualquer canhão

O comando compartilhado /nightbreaklogin <token> (fornecido pelo MagmaCore, não declarado no plugin.yml do CannonRTP) usa seu próprio nó de permissão nightbreak.login.

Como cannonrtp.use funciona

Se um jogador não tiver cannonrtp.use, o canhão simplesmente ignora esse jogador. Nenhuma mensagem de negação é enviada para essa verificação de permissão base -- ele simplesmente atravessa a área do canhão sem ser lançado.

Restrição de Permissão por Canhão

Cada configuração de canhão também pode definir um campo requiredPermission.

• Se requiredPermission estiver em branco (o padrão), o canhão verifica apenas cannonrtp.use.
• Se requiredPermission estiver definido e o jogador tiver cannonrtp.use mas não tiver o nó específico do canhão, o CannonRTP envia a mensagem noPermission configurada incluindo o nome de exibição do canhão. A mensagem é limitada a uma vez a cada três segundos por jogador por canhão.

Auto-completar (Tab)

Os comandos que atuam sobre um canhão existente (place, remove, delete, target, center) completam <id> a partir da lista de ids de configuração de canhões conhecidos, e só aceitam um id que já exista. /wc create é a exceção: seu <id> e <display_name> são texto livre, então o auto-completar mostra apenas a dica <id> / <display_name>. Os comandos que recebem um argumento <world> completam a partir da lista de nomes de mundos atualmente carregados, e /wc forcereinstallcontent completa all mais cada slug de pacote Nightbreak.