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 de configuração no estilo Nightbreak
/wc downloadall	Qualquer	Baixa todos os pacotes de conteúdo disponíveis no Nightbreak
/wc updatecontent	Qualquer	Atualiza pacotes de conteúdo já instalados (alias: updateall)
/wc initialize	Jogador	Abre o menu de configuração inicial

Todos os comandos de administrador exigem cannonrtp.admin.

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

Apenas 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
cannonrtp.use	true	Necessária para que um jogador possa acionar qualquer canhão

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 recebem um argumento <id> de canhão completam automaticamente a partir da lista de ids de configuração de canhões conhecidos. Os comandos que recebem um argumento <world> completam a partir da lista de nomes de mundos atualmente carregados.