Saltar al contenido principal

Empaquetado de contenido personalizado de EternalTD

EternalTD todavía soporta contenido personalizado basado en el sistema de archivos, pero el código actual espera una estructura de carpetas específica y un modelo de seguimiento de paquetes.

Raíz de importación​

Las importaciones manuales siguen pasando por:

plugins/EternalTD/imports/

Después de importar contenido manualmente, ejecuta:

/etd reload

Carpetas de contenido canónicas​

El plugin actual escanea estas carpetas en minúsculas:

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

Nota sobre versiones anteriores:

  • Levels/ y NPCs/ son nombres de carpetas heredados.
  • EternalTD ahora los migra a levels/ y npcs/ durante el inicio y la recarga.

Reglas de empaquetado de mundos​

EternalTD trata los mundos bajo:

plugins/EternalTD/worlds/

como plantillas de mundos.

Cuando un jugador inicia un nivel, EternalTD clona el mundo plantilla correspondiente en el contenedor de mundos del servidor y ejecuta la sesión en esa copia clonada.

Implicación práctica:

  • empaqueta los mundos plantilla bajo plugins/EternalTD/worlds/
  • no trates los mundos clonados en tiempo de ejecución como la fuente de verdad para el contenido empaquetado

El mundo hub oficial es un caso especial y se rastrea directamente en el contenedor de mundos del servidor como:

etd_spawn

Qué hace un paquete conmutable​

La conmutación de paquetes en /etd setup solo funciona para paquetes que exponen archivos de configuración rastreados.

Los campos de assets rastreados actuales son:

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

En la práctica:

  • los paquetes de nivel, oleadas y NPC pueden habilitarse o deshabilitarse escribiendo isEnabled dentro de esos archivos YAML
  • el contenido compartido del contenedor de mundos y los paquetes de recursos con solo marcador no son conmutables de la misma manera

Campos de metadatos del paquete​

El modelo de campos de configuración de paquetes actual soporta:

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

Si deseas que el contenido personalizado se comporte como un paquete rastreado en la interfaz de configuración, necesitas metadatos de paquete que coincidan con esos campos.

Notas sobre el empaquetado de modelos​

El paquete actual EternalTD Custom Models se rastrea con un archivo marcador en lugar de archivos de configuración normales de EternalTD.

Eso significa:

  • EternalTD puede rastrear si el paquete de modelos compartido fue descargado
  • los assets de modelos reales residen en el lado de FreeMinecraftModels de la configuración cuando FMM está instalado
  • la limpieza es manual y seguida por /etd reload

Lo que esta página no afirma​

Esta página documenta los destinos actuales en disco y el modelo de seguimiento que están verificados en el repositorio.

No define un esquema ZIP de primera parte para archivos de paquetes de Nightbreak, porque ese formato de empaquetado no está descrito en este repositorio como una especificación de autoría pública independiente.