Pular para o conteúdo principal

EternalTD Setup

O fluxo atual de setup do EternalTD gira em torno de conteudo gerido pelo Nightbreak, suporte opcional a modelos atraves do FreeMinecraftModels e um comando auxiliar para o resource pack.

Requisitos​

  • EternalTD 1.4.1
  • Java 21
  • Um servidor compativel com Paper/Spigot na linha atual da API 1.21

Integracoes opcionais:

  • FreeMinecraftModels para os modelos personalizados do EternalTD
  • ResourcePackManager se quiseres que o EternalTD registe ali o resource pack oficial em vez de escrever em server.properties
  • Floodgate, ModelEngine e LibsDisguises sao soft-depends, nao requisitos de setup para o fluxo atual

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/

Nota de legacy:

  • O plugin agora trata levels/ e npcs/ como nomes de pasta canonicos.
  • No arranque e no reload ele migra automaticamente as pastas antigas Levels/ e NPCs/ para os caminhos em minusculas.

Fluxo recomendado para a primeira configuracao​

  1. Instala o EternalTD e arranca o servidor uma vez.
  2. Executa /etd initialize como jogador com eternaltd.*.
  3. Liga a tua conta Nightbreak com /nightbreaklogin <token>.
  4. Executa /etd downloadall para transferir todos os pacotes EternalTD acessiveis para plugins/EternalTD/imports.
  5. Executa /etd install para aplicar a configuracao oficial do resource pack do EternalTD.
  6. Executa /etd setup sempre que quiseres navegar, ativar, desativar ou atualizar pacotes individuais.

/nightbreaklogin <token> faz parte do fluxo partilhado de conta Nightbreak/MagmaCore, nao e um comando declarado no plugin.yml do EternalTD.

O que /etd initialize faz na pratica​

/etd initialize abre um menu de configuracao inicial. Nao transfere conteudo nem instala o resource pack por ti.

O menu atual oferece tres resultados:

  • Recommended Setup: marca o setup como concluido e diz-te para executar /nightbreaklogin <token>, /etd downloadall e /etd install
  • Manual Setup: marca o setup como concluido e deixa a gestao de conteudo contigo
  • Use Current Content: marca o setup como concluido e mantem o conteudo atual em disco tal como esta

Como as tres opcoes definem setupDone: true, trata /etd initialize como um fluxo de orientacao, nao como um passo de validacao.

Comportamento de spawn e hub​

Atualmente config.yml inclui:

  • setupDone
  • spawnLocations
  • manageSpawn
  • playerGuide

Quando manageSpawn: true e o mundo etd_spawn existe, os jogadores que entram sao teleportados para o spawn EternalTD configurado.

O pacote oficial do hub e acompanhado separadamente dos mapas de gameplay e e instalado como o mundo etd_spawn dentro do world container do servidor.

Reload depois de imports manuais​

Usa /etd reload depois de imports manuais ou limpeza manual de ficheiros.

Atualmente, fazer reload ao EternalTD:

  • volta a correr o importer
  • recarrega content packages
  • recarrega levels, waves, NPCs e world templates
  • atualiza o estado de acesso e atualizacao dos pacotes
  • reinicializa o helper do resource pack
  • pede ao FreeMinecraftModels para recarregar conteudo importado se esse plugin estiver presente