Saltar al contenido principal

Configuración de EternalTD

El flujo de configuración actual de EternalTD está basado en contenido gestionado por Nightbreak, soporte opcional de modelos a través de FreeMinecraftModels y un comando auxiliar para el paquete de recursos.

Requisitos​

  • EternalTD 1.7.1
  • Java 21
  • Un servidor compatible con Paper/Spigot en la línea API 1.21.4 actual

Integraciones opcionales:

  • FreeMinecraftModels para los modelos personalizados de EternalTD
  • ResourcePackManager si deseas que EternalTD registre su paquete de recursos oficial allí en lugar de escribir en server.properties
  • Floodgate y LibsDisguises son dependencias opcionales (soft-depends), no requisitos de configuración para el flujo de configuración actual

plugin.yml declara exactamente cuatro dependencias opcionales: FreeMinecraftModels, LibsDisguises, Floodgate y ResourcePackManager. ModelEngine ya no se referencia en ninguna parte del plugin.

Lo que EternalTD crea​

Al iniciar, EternalTD inicializa o utiliza estas rutas:

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 versiones anteriores:

  • El plugin ahora trata levels/ y npcs/ como nombres de carpeta canónicos.
  • Al iniciar y recargar, migra automáticamente las carpetas heredadas Levels/ y NPCs/ a las rutas en minúsculas.

Flujo recomendado para la primera vez​

  1. Instala EternalTD e inicia el servidor una vez.
  2. Vincula tu cuenta de Nightbreak con /nightbreaklogin <token>.
  3. Ejecuta /etd downloadall para descargar todos los paquetes de EternalTD accesibles en plugins/EternalTD/imports.
  4. Ejecuta /etd install para aplicar la configuración oficial del paquete de recursos de EternalTD.
  5. Ejecuta /etd setup en cualquier momento que desees explorar, habilitar, deshabilitar o actualizar paquetes individuales.

/nightbreaklogin <token> es parte del flujo de cuenta compartido de Nightbreak/MagmaCore, no un comando declarado en el plugin.yml de EternalTD.

El menú /etd setup​

/etd setup abre el menú de configuración compartido de MagmaCore. Junto a los paquetes de contenido de EternalTD (filtrados por Free Content, Premium Packs y Resources), el menú también expone estos controles estándar de MagmaCore:

  • una entrada Plugin Update que muestra la versión instalada frente a la última versión de EternalTD y descarga una actualización del plugin cuando hay una disponible,
  • una entrada Recommended Plugins que abre la vista de recomendación de plugins complementarios (también accesible con /etd recommendedplugins),
  • un botón de alternancia Automatic Updates que activa o desactiva el valor de configuración nightbreak.autoDownloadPluginUpdates,
  • una entrada Download All que ejecuta /etd downloadall (actualización del plugin más todo el contenido disponible).

Comportamiento del spawn y hub​

config.yml actualmente incluye:

  • setupDone — flag que rastrea si la guía de configuración inicial se ha completado (por defecto false).
  • spawnLocations — por defecto etd_spawn,0,65,0,0,0 y siempre se escribe en la configuración. EternalTD solo lo resuelve y lo usa cuando existe el mundo etd_spawn.
  • manageSpawn — por defecto true. Teletransporta a los jugadores que se unen al mundo hub de EternalTD cuando está disponible.
  • playerGuide — el texto del libro guía dentro del juego.
  • nightbreak.autoDownloadPluginUpdates — por defecto false. Ajuste compartido de MagmaCore; cuando es true, el plugin descarga automáticamente las actualizaciones disponibles del plugin y del contenido al iniciar (se aplican tras el siguiente reinicio). Esto también es conmutable dentro del juego desde el botón "Automatic Updates" del menú /etd setup.

Cuando manageSpawn: true y el mundo etd_spawn existe, los jugadores que se unen son teletransportados a la ubicación de spawn configurada de EternalTD.

El paquete oficial del hub se rastrea por separado de los mapas de juego y se instala como el mundo etd_spawn en el contenedor de mundos del servidor.

En Paper 26.1 y posteriores, los mundos se migran fuera de la raíz del contenedor de mundos a <level-name>/dimensions/minecraft/<world>. EternalTD busca etd_spawn tanto en la raíz antigua como en la ubicación migrada, así que un hub migrado sigue detectándose como instalado y se carga. Los restos de una migración a medias se ponen en cuarentena antes de crear el mundo, porque la migración de Paper se niega a fusionar una copia antigua situada junto a una migrada.

Recarga después de importaciones​

Usa /etd reload después de importaciones manuales o limpieza manual de archivos.

/etd reload es un reinicio completo del plugin en el sitio — ejecuta la ruta de deshabilitado, carga y habilitado de EternalTD — así que todo lo que hace el arranque vuelve a ocurrir:

  • las carpetas heredadas Levels/ y NPCs/ se migran a minúsculas
  • el importador se vuelve a ejecutar
  • se recargan los paquetes de contenido, las oleadas, los niveles, las plantillas de mundo y los NPCs
  • se actualiza el estado de actualización/acceso de los paquetes
  • el auxiliar del paquete de recursos se reinicializa

Dos consecuencias que conviene conocer:

  • Cualquier sesión de nivel en curso se desmonta, porque la recarga pasa por el apagado normal del plugin.
  • FreeMinecraftModels no se recarga con /etd reload. Recarga el contenido de FMM con su propio comando si importaste assets de modelos a mano.

Jugadores ya conectados​

manageSpawn normalmente teletransporta a los jugadores al hub al entrar, pero los jugadores que se conectan mientras EternalTD todavía se está inicializando se lo pierden (el mundo hub y el listener de entrada solo existen una vez terminada la inicialización). Cuando la inicialización se completa, EternalTD repasa a todos los que ya están conectados y teletransporta a la ubicación de spawn configurada a cualquiera que no esté ya en el mundo hub.