Pular para o conteúdo principal

Empacotamento de conteúdo personalizado do EternalTD

O EternalTD ainda suporta conteúdo personalizado baseado no sistema de arquivos, mas o código atual espera um layout de pastas específico e um modelo de rastreamento de pacotes.

Raiz de importação​

As importações manuais ainda passam por:

plugins/EternalTD/imports/

Após importar conteúdo manualmente, execute:

/etd reload

Pastas de conteúdo canônicas​

O plugin atual verifica estas pastas em minúsculas:

plugins/EternalTD/levels/
plugins/EternalTD/waves/
plugins/EternalTD/npcs/
plugins/EternalTD/worlds/

Nota sobre versões anteriores:

  • Levels/ e NPCs/ são nomes de pastas legados.
  • O EternalTD agora os migra para levels/ e npcs/ durante a inicialização e recarga.

Regras de empacotamento de mundos​

O EternalTD trata os mundos em:

plugins/EternalTD/worlds/

como modelos de mundo.

Quando um jogador inicia um nível, o EternalTD clona o mundo modelo correspondente no contêiner de mundos do servidor e executa a sessão nessa cópia clonada.

Implicação prática:

  • empacote os mundos modelo em plugins/EternalTD/worlds/
  • não trate os mundos clonados em tempo de execução como a fonte de verdade para o conteúdo empacotado

O mundo hub oficial é um caso especial e é rastreado diretamente no contêiner de mundos do servidor como:

etd_spawn

O que torna um pacote alternável​

A alternância de pacotes em /etd setup só funciona para pacotes que expõem arquivos de configuração rastreados.

Os campos de assets rastreados atuais são:

  • levelFiles
  • waveFiles
  • npcFiles
  • worldFolders
  • worldContainerFolders
  • markerFileName

Na prática:

  • pacotes de nível, ondas e NPC podem ser habilitados ou desabilitados escrevendo isEnabled dentro desses arquivos YAML
  • conteúdo compartilhado do contêiner de mundos e pacotes de recursos com apenas marcador não são alternáveis da mesma forma

Campos de metadados do pacote​

O modelo de campos de configuração de pacote atual suporta:

  • isEnabled
  • name
  • description
  • downloadLink
  • version
  • nightbreakSlug
  • levelFiles
  • waveFiles
  • npcFiles
  • worldFolders
  • worldContainerFolders
  • markerFileName
  • category
  • toggleable

Se você deseja que o conteúdo personalizado se comporte como um pacote rastreado na interface de configuração, você precisa de metadados de pacote que correspondam a esses campos.

Notas sobre empacotamento de modelos​

O pacote atual EternalTD Custom Models é rastreado com um arquivo marcador em vez de arquivos de configuração normais do EternalTD.

Isso significa:

  • o EternalTD pode rastrear se o pacote de modelos compartilhado foi baixado
  • os assets de modelos reais residem no lado do FreeMinecraftModels da configuração quando o FMM está instalado
  • a limpeza é manual e seguida por /etd reload

O que esta página não afirma​

Esta página documenta os destinos atuais em disco e o modelo de rastreamento que são verificados no repositório.

Ela não define um esquema ZIP proprietário para arquivos de pacotes do Nightbreak, porque esse formato de empacotamento não está descrito neste repositório como uma especificação de autoria pública independente.