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.6.0
  • 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, ModelEngine e LibsDisguises são dependências opcionais, não requisitos de configuração para o fluxo atual

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. Só é semeado/usado 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.

Recarga Após Importações​

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

A recarga do EternalTD atualmente:

  • reexecuta o importador
  • recarrega os pacotes de conteúdo
  • recarrega níveis, ondas, NPCs e modelos de mundo
  • atualiza o estado de atualização/acesso dos pacotes
  • reinicializa o auxiliar do pacote de recursos
  • solicita ao FreeMinecraftModels que recarregue o conteúdo importado se esse plugin estiver presente