Pular para o conteúdo principal

Configuração do EternalTD

O fluxo de configuração atual do EternalTD é construído em torno de conteúdo gerenciado pelo Nightbreak, suporte opcional a modelos através do FreeMinecraftModels e um comando auxiliar para o pacote de recursos.

Requisitos​

  • EternalTD 1.7.1
  • Java 21
  • Um servidor compatível com Paper/Spigot na linha de API 1.21.4 atual

Integrações opcionais:

  • FreeMinecraftModels para os modelos personalizados do EternalTD
  • ResourcePackManager se você quiser que o EternalTD registre seu pacote de recursos oficial lá em vez de escrever no server.properties
  • Floodgate e LibsDisguises são soft-depends, não requisitos de configuração para o fluxo atual

O plugin.yml declara exatamente quatro soft-depends: FreeMinecraftModels, LibsDisguises, Floodgate e ResourcePackManager. O ModelEngine não é mais referenciado em nenhum lugar do plugin.

O Que o EternalTD Cria​

Na inicialização, o EternalTD inicializa ou utiliza 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/

Nota sobre versões anteriores:

  • O plugin agora trata levels/ e npcs/ como nomes de pasta canônicos.
  • Na inicialização e recarga, ele migra automaticamente as pastas legadas Levels/ e NPCs/ para os caminhos em minúsculas.

Fluxo Recomendado Para a Primeira Vez​

  1. Instale o EternalTD e inicie o servidor uma vez.
  2. Vincule sua conta Nightbreak com /nightbreaklogin <token>.
  3. Execute /etd downloadall para baixar todos os pacotes EternalTD acessíveis em plugins/EternalTD/imports.
  4. Execute /etd install para aplicar a configuração oficial do pacote de recursos do EternalTD.
  5. Execute /etd setup a qualquer momento para navegar, ativar, desativar ou atualizar pacotes individuais.

/nightbreaklogin <token> faz parte do fluxo de conta compartilhado Nightbreak/MagmaCore, não é um comando declarado no plugin.yml do EternalTD.

O menu /etd setup​

/etd setup abre o menu de configuração compartilhado do MagmaCore. Além dos pacotes de conteúdo do EternalTD (filtrados por Free Content, Premium Packs e Resources), o menu também expõe estes controles padrão do MagmaCore:

  • uma entrada Plugin Update que mostra a versão instalada vs. a mais recente do EternalTD e baixa uma atualização do plugin quando há uma disponível,
  • uma entrada Recommended Plugins que abre a visão de recomendação de plugins complementares (também acessível com /etd recommendedplugins),
  • um botão de alternância Automatic Updates que ativa ou desativa o valor de configuração nightbreak.autoDownloadPluginUpdates,
  • uma entrada Download All que executa /etd downloadall (atualização do plugin mais todo o conteúdo disponível).

Comportamento de Spawn e Hub​

config.yml atualmente inclui:

  • setupDone — flag que rastreia se a orientação de configuração de primeira vez foi concluída (padrão false).
  • spawnLocations — padrão para etd_spawn,0,65,0,0,0 e é sempre escrito na configuração. O EternalTD só o resolve e usa quando o mundo etd_spawn existe.
  • manageSpawn — padrão true. Teletransporta jogadores que entram para o mundo do hub do EternalTD quando ele está disponível.
  • playerGuide — o texto do livro guia dentro do jogo.
  • nightbreak.autoDownloadPluginUpdates — padrão false. Configuração compartilhada do MagmaCore; quando true, o plugin baixa automaticamente as atualizações de plugin e conteúdo disponíveis na inicialização (usadas após o próximo reinício). Também pode ser alternado dentro do jogo pelo botão "Automatic Updates" do menu /etd setup.

Quando manageSpawn: true e o mundo etd_spawn existe, os jogadores que entram são teletransportados para o local de spawn configurado do EternalTD.

O pacote oficial do hub é rastreado separadamente dos mapas de jogabilidade e é instalado como o mundo etd_spawn no contêiner de mundos do servidor.

No Paper 26.1 e mais recente, os mundos são migrados da raiz do contêiner de mundos para <level-name>/dimensions/minecraft/<world>. O EternalTD procura etd_spawn tanto na raiz legada quanto no local migrado, então um hub migrado continua sendo detectado como instalado e carregado. Sobras de migração pela metade são postas em quarentena antes de o mundo ser criado, porque a migração do Paper se recusa a fundir uma cópia legada que esteja ao lado de uma migrada.

Recarga Após Importações​

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

/etd reload é um reinício completo do plugin no lugar — ele executa o caminho de disable, load e enable do EternalTD — então tudo o que a inicialização faz acontece novamente:

  • pastas legadas Levels/ e NPCs/ são migradas para minúsculas
  • o importador é reexecutado
  • pacotes de conteúdo, ondas, níveis, modelos de mundo e NPCs são recarregados
  • o estado de atualização/acesso dos pacotes é atualizado
  • o auxiliar do pacote de recursos é reinicializado

Duas consequências que vale conhecer:

  • Qualquer sessão de nível em andamento é desmontada, porque a recarga passa pelo desligamento normal do plugin.
  • O FreeMinecraftModels não é recarregado por /etd reload. Recarregue o conteúdo do FMM com o comando dele se você importou assets de modelo manualmente.

Jogadores Já Online​

manageSpawn normalmente teletransporta os jogadores para o hub ao entrar, mas jogadores que se conectam enquanto o EternalTD ainda está inicializando não passam por isso (o mundo do hub e o listener de entrada só existem depois que a inicialização termina). Quando a inicialização é concluída, o EternalTD varre todos que já estão online e teletransporta quem não estiver já no mundo do hub para o spawn configurado.