Pacotes de conteúdo do CannonRTP

O CannonRTP gere os modelos oficiais de canhões como pacotes de conteúdo do Nightbreak. Os downloads atuais Free Cannon e Premium Cannon contêm o modelo FreeMinecraftModels e um marcador da versão do pacote em content_packages/. O próprio CannonRTP gera as configurações de canhão correspondentes em cannons/; os downloads não incluem configurações de posicionamento.

Comandos principais

Comando	Função
/wc setup	Abre o menu Nightbreak de conteúdo, com os pacotes instalados e disponíveis para descarga
/wc downloadall	Descarrega a atualização do CannonRTP e todos os pacotes de conteúdo disponíveis no Nightbreak
/wc updatecontent	Atualiza em conjunto os pacotes CannonRTP desatualizados. Também está disponível como /wc updateallcontent.
/wc reload	Recarrega o CannonRTP após uma importação manual
/nightbreaklogin <token>	Regista o token partilhado do Nightbreak, necessário para pacotes premium

Os comandos de gestão /wc exigem cannonrtp.admin. O comando de conta separado /nightbreaklogin <token> exige nightbreak.login.

Além dos pacotes de canhões, o menu /wc setup apresenta uma opção de atualização do plugin (clique nela para descarregar uma atualização disponível), uma opção de plugins recomendados, uma opção para descarregar tudo, que executa /wc downloadall, e uma opção de atualizações automáticas que escreve nightbreak.autoDownloadPluginUpdates em config.yml (consulte Configuração).

Pacotes incluídos

O CannonRTP inclui por predefinição as definições de dois pacotes Nightbreak:

Identificador	Nome apresentado	Origem
cannonrtp	Free CannonRTP	Descarga gratuita do Nightbreak
cannonrtp_premium	Premium CannonRTP	Exige acesso de apoiante premium do Nightbreak

Cada definição fica em plugins/CannonRTP/content_packages/<id>.yml e guarda:

• isEnabled, que indica se o pacote está ativo; o menu /wc setup escreve-o quando ativa ou desativa o pacote
• version, a versão instalada localmente, usada por /wc updatecontent para identificar pacotes desatualizados
• name e description, apresentados em /wc setup
• downloadLink, a página Nightbreak indicada pelo CannonRTP quando um pacote não tem nightbreakSlug e tem de ser descarregado manualmente, e a ligação incluída no aviso da consola sobre um pacote desatualizado
• folderName e contentFilePrefixes, que identificam os ficheiros considerados parte do pacote
• nightbreakSlug, o identificador do projeto Nightbreak usado pelo serviço de descarga e atualização

Normalmente, não deve editar estes ficheiros manualmente. O plugin volta a gerá-los e a escrevê-los.

Estados dos pacotes

No menu /wc setup, cada pacote aparece num destes estados:

• instalado, quando passa as verificações de descarga abaixo, os metadados têm isEnabled: true e existem entradas de canhões correspondentes em plugins/CannonRTP/cannons/
• descarregado, mas desativado, quando a descarga do modelo é reconhecida, mas o pacote não está ativo; desativá-lo no menu move os ficheiros dos canhões para plugins/CannonRTP/cannons_disabled/
• desatualizado, quando o pacote está instalado e existe uma versão mais recente no Nightbreak; se a conta associada já não tiver acesso, o menu indica-o em vez de oferecer a atualização
• requer acesso, quando o pacote não está descarregado, tem sessão iniciada e a sua conta Nightbreak não tem acesso a ele
• não descarregado, quando falta um marcador de versão local positivo ou não se encontram os ficheiros do modelo

Os YAML de canhões gerados não comprovam, por si só, que o pacote foi descarregado. O CannonRTP exige uma version local superior a zero e pelo menos um ficheiro .bbmodel dentro da pasta folderName do pacote, em plugins/FreeMinecraftModels/models/ ou plugins/FreeMinecraftModels/Models/. Se faltar a pasta do modelo, o pacote volta a estar disponível para descarga mesmo que a configuração de canhão gerada ainda exista.

Clicar num pacote descarrega-o, instala-o, ativa-o ou desativa-o. Desativar um pacote move as configurações de cannons/ para cannons_disabled/ sem as eliminar. Ao reativá-lo, são restaurados os mesmos ficheiros. O CannonRTP recria os seus ficheiros incluídos cannonrtp_free_cannon.yml e cannonrtp_premium_cannon.yml sempre que faltam em cannons/, pelo que, depois de uma desativação, o recarregamento deixa aí cópias predefinidas sem posições; reativar o pacote volta a colocar os ficheiros guardados por cima delas.

Organização das pastas

Pasta	Função
plugins/CannonRTP/cannons/	Configurações de canhões ativas, carregadas no arranque ou com /wc reload.
plugins/CannonRTP/cannons_disabled/	Configurações de pacotes atualmente desativadas. O carregador ignora estes ficheiros, mas conserva-os para uma futura reativação.
plugins/CannonRTP/imports/	Pasta para importações manuais. O CannonRTP verifica-a no arranque e combina o seu conteúdo com as pastas dos pacotes.

Importação manual como alternativa

Continua a ser possível instalar um pacote manualmente:

1. Descarregue o ZIP do Nightbreak.
2. Coloque o ZIP intacto em plugins/CannonRTP/imports/.
3. Execute /wc reload.

O CannonRTP deteta o pacote, move os ficheiros para as pastas correspondentes e recarrega as configurações dos canhões. A importação manual continua disponível, mas o processo recomendado é usar /wc setup e /wc downloadall, que tratam destes passos automaticamente.

Acesso premium

Os pacotes premium, como cannonrtp_premium, exigem uma conta Nightbreak ligada. Execute uma vez /nightbreaklogin <token> com um token da página da sua conta. Depois, /wc downloadall ou o menu /wc setup podem obter o conteúdo premium.

Sem sessão iniciada, os pacotes premium continuam visíveis no menu de configuração, mas não podem ser descarregados.