Comandos e permissões do CannonRTP

O CannonRTP regista os comandos no namespace cannonrtp.

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

/wc é o alias curto que a maioria dos administradores utiliza. Todos os subcomandos exigem a permissão cannonrtp.admin.

Comandos de administrador

create, place, remove, target e center guardam a configuração antes de aplicar a alteração. Se a gravação falhar, o comando indica o erro e não recarrega nem aplica essa alteração. Corrija o problema indicado no ficheiro antes de tentar novamente.

Depois de uma alteração bem-sucedida, estes comandos e delete reconstroem todos os canhões, e não apenas o que editou. Os lançamentos ativos são cancelados e esses jogadores regressam ao assento do respetivo canhão, todos os canhões descartam os destinos em fila e recomeçam a pesquisa, e todos os tempos de espera entre lançamentos são repostos.

Comando	Remetente	Descrição
/cannonrtp	Qualquer	Mostra o cabeçalho de ajuda e todos os subcomandos registados que o remetente pode usar
/wc help	Qualquer	Apresenta a mesma lista de ajuda que /cannonrtp
/wc create <id>	Jogador	Cria uma configuração de canhão e coloca a primeira instância na posição atual. Recusa um ID que já exista; use /wc place para lhe acrescentar uma colocação.
/wc create <id> <display_name>	Jogador	Faz o mesmo, mas define um nome de apresentação personalizado, convertendo sublinhados em espaços
/wc place <id>	Jogador	Acrescenta outra colocação de um canhão existente na posição atual
/wc remove <id>	Jogador	Remove a colocação de <id> mais próxima no mundo atual, mantendo o ficheiro de configuração
/wc delete <id>	Qualquer	Elimina o ficheiro de configuração do canhão
/wc target <id> <world>	Jogador	Altera o mundo de destino da aterragem
/wc center <id>	Jogador	Define o centro de pesquisa do canhão como a posição atual
/wc list	Qualquer	Lista todas as colocações com nome de apresentação, estado, tamanho da fila e último detalhe de estado
/wc status	Qualquer	Apresenta o mesmo resultado que /wc list
/wc probe	Jogador	Verifica se a posição atual passa em todas as verificações de proteção ativas
/wc reload	Qualquer	Recarrega completamente o CannonRTP: todos os ficheiros de configuração, canhões e adaptadores de proteção, além de tudo o que estiver à espera na pasta imports/
/wc setup	Jogador	Abre o menu Nightbreak de conteúdo, com os pacotes de canhões instalados e disponíveis para descarga
/wc recommendedplugins	Qualquer	Abre o catálogo Nightbreak de plugins complementares recomendados para o CannonRTP
/wc downloadpluginupdate	Qualquer	Descarrega um JAR mais recente do CannonRTP a partir do Nightbreak. É usado após o próximo reinício do servidor, ou antes se nightbreak.applyPluginUpdatesWithoutRestart em config.yml for when-empty ou immediately
/wc applypluginupdate	Qualquer	Aplica sem reiniciar uma atualização do CannonRTP já descarregada, recarregando o plugin a partir do novo JAR. É recusado quando não há nenhuma atualização válida e mais recente à espera, quando um plugin de outro autor depende (ou tem uma dependência opcional) do CannonRTP, ou enquanto decorre outra troca de plugin. Se o novo JAR não conseguir ativar, o JAR anterior é carregado novamente e a atualização fica na pasta de atualizações para o próximo reinício. Consulte Aplicar atualizações sem reiniciar.
/wc downloadall	Qualquer	Descarrega a atualização do CannonRTP e todos os pacotes de conteúdo disponíveis no Nightbreak
/wc downloadallcontent	Qualquer	Descarrega todos os pacotes de conteúdo CannonRTP disponíveis no Nightbreak, sem o JAR do plugin
/wc updatecontent	Qualquer	Descarrega atualizações dos pacotes CannonRTP desatualizados. Também está disponível como /wc updateallcontent.
/wc forcereinstallcontent <package|all>	Qualquer	Volta a descarregar conteúdo do Nightbreak mesmo que a cópia local esteja atualizada, permitindo reparar ficheiros danificados ou editados manualmente. Use all para todos os pacotes já descarregados ou escolha com Tab um identificador Nightbreak: free-cannon-model ou cannonrtp-premium-cannon-model.

/wc initialize abre a configuração inicial para jogadores com cannonrtp.admin. /wc setup abre o navegador de conteúdo. A inicialização partilhada regista ambos os comandos; os modos predefinidos não determinam se initialize existe.

Enquanto a configuração não estiver marcada como concluída (setupDone em config.yml), os jogadores com cannonrtp.admin recebem no chat um lembrete cerca de 10 segundos depois de entrarem, com ligações clicáveis para /wc initialize e /wc setup. Cada opção do menu inicial (Recommended Setup, Manual Setup, Use Current Content) define setupDone como true e termina o lembrete.

Todos os subcomandos de administrador acima exigem cannonrtp.admin.

Estes comandos Nightbreak estão incluídos no CannonRTP

/wc setup, /wc initialize, /wc recommendedplugins, /wc downloadpluginupdate, /wc applypluginupdate, /wc downloadall, /wc downloadallcontent, /wc updatecontent e /wc forcereinstallcontent são fornecidos pela biblioteca partilhada MagmaCore, incorporada no CannonRTP por shading. São registados automaticamente e não aparecem em plugin.yml. O comando separado /nightbreaklogin, também do MagmaCore, vincula o servidor à sua conta Nightbreak para descargas premium, e /nightbreaklogout desliga-o (consulte Desligar um servidor).

O MagmaCore também regista /wcchangelog, que mostra aos administradores as notas de lançamento do CannonRTP e dos pacotes de canhões ainda não lidas. Consulte Notificações de notas de lançamento.

Consulte Pacotes de conteúdo para saber o que /wc setup, /wc downloadall e /wc updatecontent gerem.

Diferenças entre create, place, remove e delete

Uma configuração de canhão, plugins/CannonRTP/cannons/<id>.yml, pode controlar várias colocações no mundo. create cria a configuração e a primeira colocação. place acrescenta uma colocação a uma configuração existente. remove elimina a colocação mais próxima no mundo atual, mantendo a configuração. delete elimina o ficheiro de configuração e todas as colocações. Os três ficheiros incluídos (example_cannonrtp, cannonrtp_free_cannon, cannonrtp_premium_cannon) voltam com os valores predefinidos e sem colocações no recarregamento seguinte.

Interação dos jogadores

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

Permissões

O plugin.yml regista duas permissões:

Permissão	Valor predefinido	Descrição
cannonrtp.admin	op	Exigida por todos os subcomandos de administrador, incluindo os comandos Nightbreak incorporados setup / downloadall / updatecontent
cannonrtp.use	true	Exigida para um jogador poder ativar qualquer canhão

Os comandos partilhados /nightbreaklogin e /nightbreaklogout, fornecidos pelo MagmaCore e não declarados no plugin.yml do CannonRTP, utilizam a sua própria permissão nightbreak.login, predefinida como op.

Como funciona cannonrtp.use

Se um jogador não tiver cannonrtp.use, o canhão ignora-o sem enviar uma mensagem de recusa. O jogador atravessa a área do canhão sem ser lançado.

Permissão específica de cada canhão

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

• Se requiredPermission estiver vazio, como por predefinição, só é verificada cannonrtp.use.
• Se estiver definido e o jogador tiver cannonrtp.use, mas não a permissão específica, o CannonRTP envia a mensagem noPermission com o nome do canhão. A mensagem tem um limite de uma vez a cada três segundos por jogador e por canhão.

Sugestões com Tab

Os comandos que atuam sobre um canhão existente, place, remove, delete, target e center, sugerem <id> a partir dos identificadores de configuração conhecidos e só aceitam identificadores existentes. /wc create é a exceção: <id> e <display_name> são texto livre, pelo que as sugestões mostram apenas essas indicações. Comandos com um argumento <world> sugerem os nomes dos mundos atualmente carregados. /wc forcereinstallcontent sugere all e os identificadores dos pacotes Nightbreak.