Saltar para o conteúdo principal

Configuração inicial do EternalTD

A configuração atual do EternalTD usa conteúdo gerido pelo Nightbreak, suporte opcional de modelos através do FreeMinecraftModels e um comando auxiliar para o pacote de recursos.

Requisitos​

  • EternalTD; estas instruções seguem o código-fonte atual 1.7.8
  • Java 21
  • Servidor compatível com Paper/Spigot na linha atual da API 1.21.4

Integrações opcionais:

  • FreeMinecraftModels para os modelos personalizados do EternalTD
  • ResourcePackManager para registar e distribuir o pacote oficial em vez de escrever em server.properties
  • floodgate e LibsDisguises são dependências opcionais, não requisitos do procedimento de configuração atual

O plugin.yml declara exatamente quatro dependências opcionais: FreeMinecraftModels, LibsDisguises, floodgate e ResourcePackManager. O plugin já não referencia ModelEngine em nenhum ponto.

O que o EternalTD cria​

No arranque, o EternalTD inicializa ou usa estes caminhos:

plugins/EternalTD/config.yml
plugins/EternalTD/content_packages/
plugins/EternalTD/imports/
plugins/EternalTD/levels/
plugins/EternalTD/waves/
plugins/EternalTD/npcs/
plugins/EternalTD/worlds/

Sobre pastas antigas:

  • levels/ e npcs/ são os nomes oficiais usados pelo plugin.
  • No arranque e recarregamento, as pastas antigas Levels/ e NPCs/ são migradas automaticamente para os caminhos em minúsculas.
  • A migração nunca substitui um ficheiro. Se a pasta em minúsculas já contiver um ficheiro com o mesmo nome, a transferência para, os ficheiros não movidos ficam na pasta antiga ou em levels_migration/ (npcs_migration/) e o EternalTD regista uma falha de inicialização. Junte os ficheiros manualmente e reinicie.
  1. Instale EternalTD e inicie o servidor uma vez.
  2. Associe a conta Nightbreak com /nightbreaklogin e depois aprove o servidor na ligação que o comando imprime.
  3. Execute /etd downloadall para transferir todos os pacotes EternalTD a que tem acesso para plugins/EternalTD/imports.
  4. Execute /etd install para aplicar a configuração oficial do pacote de recursos.
  5. Use /etd setup para consultar, ativar, desativar ou atualizar pacotes individuais.

/nightbreaklogin pertence ao sistema de contas partilhado Nightbreak/MagmaCore e não está declarado no plugin.yml do EternalTD.

Menu /etd initialize​

Enquanto setupDone for false, os jogadores com eternaltd.* recebem um lembrete de configuração 10 segundos depois de entrarem. O lembrete contém ligações para /etd initialize e /etd setup.

/etd initialize abre o menu de configuração inicial. As suas três opções definem todas setupDone: true, o que termina o lembrete:

  • Configuração recomendada (Recommended Setup): apresenta os passos da configuração guiada e, se o servidor ainda não estiver vinculado, inicia por si uma vinculação com /nightbreaklogin.
  • Configuração manual (Manual Setup): deixa a gestão dos pacotes a seu cargo e lembra-o de executar /etd install.
  • Usar o conteúdo atual (Use Current Content): mantém as pastas de conteúdo EternalTD existentes tal como estão.

Menu /etd setup​

/etd setup abre o menu partilhado do MagmaCore. Além dos pacotes EternalTD, filtrados por Free Content, Premium Packs e Resources, apresenta estes controlos comuns:

  • Atualização do plugin: compara a versão instalada com a mais recente e transfere a atualização quando existe; esta é aplicada ao reiniciar, ou antes se nightbreak.applyPluginUpdatesWithoutRestart o permitir.
  • Plugins recomendados: abre as recomendações de plugins complementares, também acessíveis por /etd recommendedplugins.
  • Atualizações automáticas: ativa ou desativa nightbreak.autoDownloadPluginUpdates.
  • Transferir tudo: executa /etd downloadall, incluindo a atualização do plugin e todo o conteúdo disponível.

Comportamento do spawn e do hub​

O config.yml inclui atualmente:

  • setupDone: regista se a orientação inicial foi concluída; predefinição false.
  • spawnLocations: predefinido como etd_spawn,0,65,0,0,0 e sempre escrito na configuração. Só é resolvido e usado se o mundo etd_spawn existir.
  • manageSpawn: predefinição true. Teleporta os jogadores que entram para o hub EternalTD quando está disponível.
  • playerGuide: texto do livro de instruções no jogo.
  • nightbreak.autoDownloadPluginUpdates: predefinição false. Opção partilhada do MagmaCore que, com true, transfere atualizações disponíveis do plugin e do conteúdo no arranque, aplicadas após o próximo reinício, a menos que nightbreak.applyPluginUpdatesWithoutRestart aplique antes a atualização do plugin. Também pode ser alterada no botão de atualizações automáticas de /etd setup.
  • nightbreak.applyPluginUpdatesWithoutRestart: predefinição never. Opção partilhada do MagmaCore que controla quando uma atualização do plugin transferida é aplicada sem reiniciar: never aguarda o próximo reinício, when-empty aplica-a na próxima vez que não houver jogadores online e immediately aplica-a assim que a transferência termina. Qualquer outro valor conta como never. Aplicar uma atualização desativa e volta a ativar o EternalTD, pelo que os níveis em curso terminam. /etd applypluginupdate aplica uma atualização transferida a pedido.

Com manageSpawn: true e o mundo etd_spawn presente, os jogadores que entram são teleportados para o spawn EternalTD configurado.

O pacote oficial do hub é acompanhado separadamente dos mapas de jogo e instalado como mundo etd_spawn na pasta de mundos do servidor.

No Paper 26.1 e posteriores, os mundos são migrados da raiz da pasta de mundos para <level-name>/dimensions/minecraft/<world>. O EternalTD procura etd_spawn em ambos os locais, para continuar a detetar e carregar um hub migrado. Restos de migrações incompletas são colocados em quarentena antes de criar o mundo, porque o Paper recusa fundir uma cópia antiga com outra já migrada.

Recarregar após importações​

Use /etd reload após importações ou limpeza manual de ficheiros.

Este comando reinicia completamente o plugin no mesmo processo, executando a desativação, o carregamento e a ativação. Repete tudo o que acontece no arranque:

  • migração de Levels/ e NPCs/ para minúsculas
  • execução do importador
  • recarregamento dos pacotes, vagas, níveis, mundos de origem e NPCs
  • atualização do estado de acesso e das atualizações dos pacotes
  • reinicialização do auxiliar do pacote de recursos

Duas consequências:

  • Todas as sessões de nível em curso terminam, porque o recarregamento passa pelo encerramento normal do plugin.
  • Se este recarregamento importar modelos ou outros ficheiros para as pastas do FreeMinecraftModels (como scripts) e o FreeMinecraftModels estiver ativo, o importador partilhado aciona o recarregamento do conteúdo do FMM. Se editar ou copiar ficheiros diretamente nas pastas do FMM, use o comando de recarregamento do próprio FMM.

Jogadores já ligados​

manageSpawn normalmente envia os jogadores para o hub quando entram. Quem se liga durante a inicialização do EternalTD não passa por esse processo, pois o mundo do hub e o listener de entrada só ficam disponíveis no fim. Quando a inicialização termina, o EternalTD percorre os jogadores ligados e teleporta para o spawn configurado quem ainda não está no mundo do hub.

Resolução de problemas​

  • Não é possível entrar num nível. Verifique na consola se há erros sobre o ficheiro desse nível, o ficheiro das vagas ou o modelo de mundo, e confirme em /etd setup que o pacote está instalado e ativado. As mensagens de entrada e de início estão listadas em Ciclo de vida do mundo e Validação do início da sessão.
  • As torres aparecem como mobs vanilla, ou os modelos não têm texturas. Verifique as duas metades em separado. Os modelos precisam do FreeMinecraftModels e do pacote EternalTD Custom Models. As texturas precisam de que o pacote de recursos chegue ao jogador; consulte Modelos e pacote de recursos.
  • Antes de atualizar o conteúdo, faça uma cópia de segurança de qualquer ficheiro de nível, de vagas ou de NPC do pacote que tenha editado. Uma atualização de conteúdo escreve os ficheiros do pacote por cima das suas cópias editadas.

Ao pedir ajuda, indique as versões do EternalTD e do servidor, o nível afetado, os ficheiros de configuração relevantes e o registo completo do servidor. O /logify envia o registo e devolve uma ligação.