Archivos de modelo del vehículo (yft, _hi.yft, ytd) y el aviso de assets sobredimensionados

Los tres archivos tienen funciones fijas, y sus nombres deben seguir el nombre de modelo de vehicles.meta.

stream/
  mycar.yft        model: lower LODs, skeleton, collision
  mycar_hi.yft     model: high detail version shown up close
  mycar.ytd        textures (name matches <txdName>)
  mycar+hi.ytd     optional: high resolution versions of the same textures

Archivo	Contenido	Cuándo lo usa el juego
<model>.yft	El vehículo como fragment: las mallas de menor detalle, los bones (puertas, ruedas, asientos) y la colisión.	Siempre, mientras el vehículo exista.
<model>_hi.yft	La malla de alto detalle.	Solo cerca de la cámara, dentro del primer valor de lodDistances de vehicles.meta.
<txdName>.ytd	Todas las texturas del vehículo.	Siempre.
<txdName>+hi.ytd	Copias opcionales de las texturas a mayor resolución.	Cerca de la cámara.

El juego construye él mismo el nombre del modelo de alto detalle añadiendo _hi al nombre del modelo siempre que la primera distancia de LOD es mayor que cero, así que el archivo debe llamarse exactamente así. Las piezas de tuning son archivos de modelo pequeños y separados en la misma carpeta, con los nombres que figuran en carcols.meta.

Cuando un resource se inicia, FXServer lee la cabecera de cada archivo de stream y calcula cuánta memoria ocupará una vez cargado. Si es demasiada, muestra una línea como esta en la consola del servidor:

Asset mycar/mycar.ytd uses 62.5 MiB of physical memory. Oversized assets can and WILL lead to streaming issues (such as models not loading/rendering).

El número no es el tamaño del archivo en disco. Los archivos de stream están comprimidos, y la cabecera registra el tamaño de los datos descomprimidos en dos partes: memoria virtual (datos de estructura) y memoria física (sobre todo píxeles de texturas y geometría de mallas). Cada parte se comprueba por separado.

Memoria de un archivo	Línea de la consola
16 MiB o menos	No se muestra nada.
Más de 16 MiB	Se muestra en azul.
Más de 32 MiB	Se muestra en amarillo.
Más de 48 MiB	Se añade la frase "Oversized assets can and WILL lead to streaming issues (such as models not loading/rendering)".
Más de 64 MiB	Se muestra en rojo.

Estos escalones son los del código fuente de FXServer (ResourceStreamComponent.cpp). El aviso tiene que ver con los ordenadores de los jugadores, no con el servidor: cada jugador que esté cerca del vehículo tiene que mantener ese archivo en memoria. Mantén cada archivo en 16 MiB o menos y la consola se queda en silencio.

Para ver ese número de un archivo antes de arrancar el servidor, suéltalo en la calculadora de memoria de texturas YTD. También lista cada textura con la memoria que ocupa.

La memoria de una textura depende de la resolución y del formato, no del aspecto de la imagen. Reducir a la mitad el ancho y el alto deja la memoria en una cuarta parte. Los formatos comprimidos guardan 4 u 8 bits por píxel en lugar de 32. Los mipmaps añaden más o menos un tercio.

Resolución	DXT1 / BC1 (sin alfa)	DXT5 / BC3 (alfa)	32 bits sin comprimir
512 x 512	0.17 MiB	0.33 MiB	1.33 MiB
1024 x 1024	0.67 MiB	1.33 MiB	5.33 MiB
2048 x 2048	2.67 MiB	5.33 MiB	21.3 MiB
4096 x 4096	10.7 MiB	21.3 MiB	85.3 MiB

Los valores incluyen los mipmaps. Una sola textura de 4096 sin comprimir ya supera todos los escalones del aviso, y una única textura de 4096 en DXT5 pasa de 16 MiB por sí sola. Un .ytd con unas cuantas texturas 4K es el origen más común del aviso.

1. Localiza el archivo. La línea de la consola nombra el resource y el archivo. Arregla primero el más grande.
2. Reduce las texturas grandes. Las texturas de carrocería e interior a 2048 o 1024 bastan para un vehículo visto a la distancia normal de juego. Las piezas pequeñas, los emblemas y las luces rara vez necesitan más de 512.
3. Comprímelas. Usa DXT1 (BC1) para las texturas sin transparencia y DXT5 (BC3) para las que la tienen. Evita los formatos sin comprimir.
4. Borra las texturas que no se usan. Los modelos convertidos suelen arrastrar texturas que ningún material utiliza.
5. No dupliques las texturas compartidas. Las texturas que usan varios vehículos pueden estar en un único diccionario definido como padre en txdRelationships de vehicles.meta.
6. Reduce la malla. Si el archivo del aviso es un .yft, el modelo tiene demasiados polígonos, o el .yft principal contiene la malla de detalle completo en lugar de los LOD más bajos.
7. Reinicia el resource y vuelve a leer la consola. Si no hay ninguna línea, todos los archivos están en 16 MiB o menos.

Los ajustes de LOD, lodDistances y los tamaños de textura según su función están en cómo optimizar un vehículo FiveM.

El .yft principal está pensado para contener las versiones más ligeras del modelo, y el _hi.yft la detallada. Gracias a esa división, el juego mantiene en memoria solo un modelo ligero para los vehículos que están lejos. Una conversión que pone la misma malla pesada en los dos archivos duplica la memoria y hace que cada vehículo lejano cueste lo mismo que uno cercano.

Los niveles y sus distancias se explican en qué son los LOD en los vehículos de FiveM. En nuestro propio catálogo, el Coil S-Cooter y los tres hoverboards traen cuatro LOD, de High a Very Low.