Saltar al contenido principal

Configuración inicial de EternalTD

La configuración actual de EternalTD gira en torno al contenido gestionado por Nightbreak, los modelos opcionales de FreeMinecraftModels y un comando auxiliar para el paquete de recursos.

Requisitos​

  • EternalTD; estas instrucciones siguen el código fuente actual 1.7.8
  • Java 21
  • Un servidor compatible con Paper/Spigot de la línea actual de API 1.21.4

Integraciones opcionales:

  • FreeMinecraftModels para los modelos personalizados de EternalTD.
  • ResourcePackManager para registrar en él el paquete oficial de recursos en lugar de escribir en server.properties.
  • floodgate y LibsDisguises son dependencias opcionales, no requisitos del proceso actual de configuración.

plugin.yml declara exactamente cuatro dependencias opcionales: FreeMinecraftModels, LibsDisguises, floodgate y ResourcePackManager. El plugin ya no hace referencia a ModelEngine.

Qué crea EternalTD​

Al arrancar, EternalTD inicializa o usa 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:

  • levels/ y npcs/ son ahora los nombres oficiales de las carpetas.
  • Al arrancar y recargar, el plugin migra automáticamente las carpetas antiguas Levels/ y NPCs/ a las rutas en minúsculas.
  • La migración nunca sobrescribe un archivo. Si la carpeta en minúsculas ya contiene un archivo con el mismo nombre, el traslado se detiene, los archivos no trasladados se quedan en la carpeta antigua o en levels_migration/ (npcs_migration/) y EternalTD registra un fallo de inicialización. Combina los archivos a mano y reinicia.
  1. Instala EternalTD y arranca el servidor una vez.
  2. Vincula tu cuenta de Nightbreak con /nightbreaklogin y después aprueba el servidor en el enlace que imprime.
  3. Ejecuta /etd downloadall para descargar todos los paquetes de EternalTD a los que tengas acceso en plugins/EternalTD/imports.
  4. Ejecuta /etd install para aplicar la configuración oficial del paquete de recursos.
  5. Usa /etd setup para explorar, habilitar, deshabilitar o actualizar paquetes individuales.

/nightbreaklogin pertenece al sistema compartido de cuentas de Nightbreak/MagmaCore; no se declara en el plugin.yml de EternalTD.

El menú /etd initialize​

Mientras setupDone sea false, los jugadores con eternaltd.* reciben un recordatorio de configuración 10 segundos después de conectarse. Incluye enlaces a /etd initialize y /etd setup.

/etd initialize abre el menú de configuración inicial. Sus tres opciones establecen setupDone: true, lo que detiene el recordatorio:

  • Recommended Setup muestra los pasos de la configuración guiada y, si el servidor aún no está vinculado, inicia para ti un enlace de /nightbreaklogin.
  • Manual Setup te deja la gestión de los paquetes y te recuerda que ejecutes /etd install.
  • Use Current Content conserva tal cual tus carpetas de contenido de EternalTD.

El menú /etd setup​

/etd setup abre el menú compartido de MagmaCore. Junto a los paquetes de EternalTD, filtrados en contenido gratuito, paquetes prémium y recursos, ofrece estos controles estándar:

  • Actualización del plugin: muestra la versión instalada y la más reciente, y descarga la actualización cuando está disponible. Se aplica al reiniciar, o antes si nightbreak.applyPluginUpdatesWithoutRestart lo permite.
  • Plugins recomendados: abre las recomendaciones de plugins complementarios; también se accede con /etd recommendedplugins.
  • Actualizaciones automáticas: activa o desactiva nightbreak.autoDownloadPluginUpdates.
  • Descargar todo: ejecuta /etd downloadall para obtener la actualización del plugin y todo el contenido disponible.

Punto de aparición y centro de reunión​

config.yml incluye actualmente:

  • setupDone: registra si se ha completado la guía de configuración inicial; predeterminado false.
  • spawnLocations: valor predeterminado etd_spawn,0,65,0,0,0, escrito siempre en la configuración. EternalTD solo lo resuelve y usa si existe el mundo etd_spawn.
  • manageSpawn: predeterminado true. Teletransporta a los jugadores que se conectan al mundo central de EternalTD cuando está disponible.
  • playerGuide: texto del libro de instrucciones del juego.
  • nightbreak.autoDownloadPluginUpdates: predeterminado false. Ajuste compartido de MagmaCore que, con true, descarga automáticamente al arrancar las actualizaciones disponibles del plugin y del contenido para usarlas tras el siguiente reinicio, salvo que nightbreak.applyPluginUpdatesWithoutRestart aplique antes la actualización del plugin. También se cambia con el botón de actualizaciones automáticas de /etd setup.
  • nightbreak.applyPluginUpdatesWithoutRestart: predeterminado never. Ajuste compartido de MagmaCore que controla cuándo se aplica sin reiniciar una actualización del plugin descargada: never espera al siguiente reinicio, when-empty la aplica la próxima vez que no haya jugadores conectados e immediately la aplica en cuanto termina la descarga. Cualquier otro valor cuenta como never. Aplicar una actualización deshabilita y vuelve a habilitar EternalTD, así que los niveles en curso terminan. /etd applypluginupdate aplica a petición una actualización descargada.

Con manageSpawn: true y el mundo etd_spawn existente, los jugadores que se conectan se teletransportan a la ubicación de aparición configurada.

El paquete oficial del centro de reunión se registra por separado de los mapas de juego y se instala como etd_spawn en el contenedor de mundos del servidor.

En Paper 26.1 y posteriores, los mundos se migran de la raíz del contenedor a <level-name>/dimensions/minecraft/<world>. EternalTD busca etd_spawn tanto en la raíz antigua como en la ubicación migrada, por lo que sigue detectándolo y cargándolo. Los restos de migraciones incompletas se apartan antes de crear el mundo, porque Paper rechaza combinar una copia antigua con otra migrada que coexista junto a ella.

Recargar tras importar​

Usa /etd reload tras importar contenido o limpiar archivos manualmente.

Es un reinicio completo del plugin dentro del servidor: ejecuta su deshabilitación, carga y habilitación, repitiendo las operaciones del arranque:

  • Migra Levels/ y NPCs/ a minúsculas.
  • Vuelve a ejecutar el importador.
  • Recarga paquetes, oleadas, niveles, plantillas de mundos y NPC.
  • Actualiza el estado de acceso y actualización de paquetes.
  • Reinicializa el sistema auxiliar del paquete de recursos.

Esto tiene dos consecuencias:

  • Se desmontan todas las sesiones de nivel activas porque la recarga ejecuta el cierre normal del plugin.
  • Si esta recarga importa modelos u otros archivos en las carpetas de FreeMinecraftModels (como scripts) y FreeMinecraftModels está habilitado, el importador compartido activa la recarga del contenido de FMM. Si editas o copias archivos directamente en las carpetas de FMM, utiliza su propio comando de recarga.

Jugadores ya conectados​

manageSpawn normalmente teletransporta al centro de reunión al conectarse. Los jugadores que entran durante la inicialización de EternalTD no reciben ese teletransporte, porque el mundo y el listener de conexión solo existen al terminar. Al completar la inicialización, EternalTD revisa a todos los conectados y teletransporta al punto configurado a quienes no estén ya en el mundo central.

Solución de problemas​

  • No se puede entrar en un nivel. Revisa la consola en busca de errores sobre el archivo de ese nivel, su archivo de oleadas o la plantilla de su mundo, y confirma en /etd setup que el paquete está instalado y activado. Los mensajes de entrada y de inicio se enumeran en Ciclo de vida del mundo y Validación al iniciar la sesión.
  • Las torres aparecen como mobs vanilla o los modelos no tienen texturas. Comprueba las dos mitades por separado. Los modelos necesitan FreeMinecraftModels y el paquete EternalTD Custom Models. Las texturas necesitan que el resource pack llegue al jugador; consulta Modelos y paquete de recursos.
  • Antes de actualizar el contenido, haz una copia de seguridad de cualquier archivo de nivel, de oleadas o de NPC empaquetado que hayas editado. Una actualización de contenido escribe los archivos del paquete encima de tus copias editadas.

Cuando pidas ayuda, incluye las versiones de EternalTD y del servidor, el nivel afectado, los archivos de configuración relevantes y el registro completo del servidor. /logify sube el registro y devuelve un enlace.