Saltar al contenido principal

Modelos y paquete de recursos de EternalTD

EternalTD usa FreeMinecraftModels para los modelos y /etd install para configurar el paquete de recursos.

FreeMinecraftModels​

FreeMinecraftModels es una dependencia opcional.

  • EternalTD se carga sin él.
  • Si está presente, EternalTD puede sustituir los cuerpos de las torres por modelos estáticos de FMM. Un modelo ausente genera un aviso y deja el cuerpo normal en su sitio.
  • Si está ausente, EternalTD usa los cuerpos normales sin bloquear el arranque. El indicador de integración comprueba la presencia del plugin: una instalación de FMM deshabilitada o incompatible no equivale a su ausencia.

El paquete compartido de modelos actual es:

  • EternalTD Custom Models

Se descarga mediante el sistema de contenido de EternalTD y el código lo describe como contenido que se importa a FreeMinecraftModels cuando este está disponible.

El seguimiento de paquetes de EternalTD también acepta cualquiera de estas carpetas de FMM no vacías como contenido instalado:

plugins/FreeMinecraftModels/models/EternalTD default towers/
plugins/FreeMinecraftModels/Models/EternalTD default towers/

La variante con mayúscula es el nombre antiguo. Detectar cualquiera de las dos carpetas no vacías hace que el contenido cuente como instalado e intenta escribir plugins/EternalTD/content_markers/eternaltd_custom_models.marker; si falla, se registra el error. Un marcador existente también cuenta aunque después se hayan eliminado los modelos. Ninguna comprobación valida su contenido ni demuestra que se hayan cargado.

Qué hace /etd reload con los modelos​

/etd reload reinicia EternalTD dentro del servidor y procesa las importaciones pendientes. Cuando el importador compartido instala modelos u otros archivos en las carpetas de FMM (como scripts) y FMM está habilitado, la notificación de instalación llama a la recarga de contenido importado de FMM. Esto es condicional: no ocurre con cada /etd reload. El método de reenvío independiente de EternalTD no tiene llamadas.

Si editas o copias archivos directamente en las carpetas de FMM, usa su propio comando de recarga. Comprueba los registros y un modelo real en el juego; el marcador del paquete no basta.

/etd install​

/etd install no descarga modelos. Aplica los ajustes de distribución del paquete oficial de recursos de EternalTD.

La URL oficial actual es:

https://www.magmaguy.com/downloads/eternaltd_resource_pack.zip

Si ResourcePackManager está instalado​

Si ResourcePackManager está habilitado, EternalTD registra el paquete oficial y le pide que recargue su estado de paquetes.

En este modo:

  • EternalTD no escribe la URL en server.properties.
  • ResourcePackManager distribuye el paquete a los jugadores.
  • EternalTD registra /etd reload como comando de recarga posterior.

El mensaje de registro confirma las llamadas a la API, no la entrega a un cliente. Al arrancar, EternalTD solo considera que ResourcePackManager habilitado es una configuración activa; no registra el paquete. Ejecuta /etd install para solicitar el registro y comprueba el paquete con un jugador conectado.

Si ResourcePackManager no está disponible o falla el registro​

EternalTD edita directamente server.properties si ResourcePackManager está deshabilitado, ausente o su registro por API lanza un error.

Escribe:

  • resource-pack
  • resource-pack-sha1

Antes de cambiar cualquiera de las dos propiedades, descarga el paquete y calcula su SHA1 a medida que llegan los bytes, sin guardar el paquete en disco. La descarga usa un tiempo de espera de conexión de 10 segundos y uno de lectura de 30 segundos. Si falla la descarga o el cálculo, no modifica server.properties. Si funciona, escribe ambos valores juntos mediante un archivo temporal y sustitución atómica cuando el sistema operativo lo permite. Si ambos valores ya coinciden, el archivo no se reescribe.

En este modo alternativo, el comando indica que reinicies el servidor para aplicar los ajustes nuevos.

Comprobación de cambios del SHA1​

Si EternalTD usa server.properties en lugar de ResourcePackManager, también comprueba al arrancar (y con /etd reload) si ha cambiado el SHA1 del paquete oficial.

La comprobación solo se ejecuta cuando resource-pack es exactamente la URL oficial de EternalTD indicada arriba; un paquete con cualquier otra URL no se toca. Si el hash ha cambiado, EternalTD escribe el nuevo resource-pack-sha1 tras confirmar que resource-pack sigue conteniendo la URL oficial. No anuncia el cambio; el servidor envía el nuevo hash a los jugadores después de su siguiente reinicio. Si la escritura se omite o falla, la consola registra que la suma de verificación no se ha actualizado. Cuando ResourcePackManager está habilitado, se evita esta ruta de arranque.

Avisos a operadores​

Cuando se cumplen estas condiciones:

  • FreeMinecraftModels está instalado.
  • El jugador que se conecta es operador.
  • EternalTD no detecta una configuración activa de paquete de recursos.

EternalTD programa un aviso para cinco segundos después, si el jugador sigue siendo válido. Indica estos comandos:

  • /etd install
  • /etd initialize, que abre el menú de configuración inicial y exige eternaltd.*.
  • /etd setup

La detección solo comprueba que ResourcePackManager esté habilitado o que server.properties tenga algún valor no vacío en resource-pack. No comprueba la aceptación del cliente ni que el paquete contenga los recursos de EternalTD. El aviso describe la ruta de server.properties, pero /etd install sigue intentando usar ResourcePackManager primero.

Notas de limpieza​

El paquete de modelos se trata como recursos compartidos, no como un paquete normal que pueda deshabilitarse.

Para quitarlo:

  1. Elimina los modelos importados que quieras quitar, revisando las carpetas actuales y antiguas de FMM.
  2. Elimina plugins/EternalTD/content_markers/eternaltd_custom_models.marker si quieres que el paquete deje de contar como instalado. Cualquier carpeta alternativa no vacía volverá a crear ese estado en la siguiente comprobación.
  3. Recarga FMM para aplicar las eliminaciones directas y ejecuta /etd reload. Revisa /fmm setup si hace falta. Estos pasos no eliminan el registro del paquete de recursos ni sus ajustes en server.properties.