Saltar al contenido

¿Ped add-on invisible o crasheando? Arréglalo

Un ped add-on que no carga nada, que aparece como un maniquí gris o morado, o que crashea el cliente casi siempre se debe a una de seis cosas. Revísalas en este orden.

1. Los archivos no están en stream/

FiveM solo hace streaming de los assets que están dentro de una carpeta llamada stream (a cualquier profundidad por debajo). Un ped colocado en la raíz del recurso, o en una carpeta llamada models, nunca carga. Comprueba que cada .ydd, .yft, .ytd y .ymt del ped está bajo stream/.

2. Falta peds.meta o no se carga

Un ped nuevo necesita una entrada en peds.meta y el manifest tiene que cargarlo:

files { 'peds.meta' }
data_file 'PED_METADATA_FILE' 'peds.meta'

Sin eso, el nombre del modelo existe pero el juego no tiene ninguna definición de ped y no genera nada, o recurre a uno por defecto.

3. Los nombres no coinciden

El nombre del modelo en peds.meta, el .yft, el .ydd y el .ytd tienen que usar todos el mismo nombre base. Una errata y las texturas o los drawables fallan sin avisar. Ponlo todo en minúsculas; evita espacios y guiones.

4. Texturas demasiado grandes

Un diccionario de texturas demasiado grande (un solo .ytd de más de 16 MB, o unos cuantos mapas 4K) puede directamente no cargar, lo que se ve como un ped invisible o sin texturas, y en clientes más débiles como un crash. Reduce las texturas; un ped rara vez necesita mapas de más de 2048 px.

5. Un esqueleto que GTA no conoce

Si el ped aparece pero se queda en T-pose, se desliza o tiene las extremidades retorcidas, su esqueleto y sus pesos no coinciden con lo que esperan las animaciones de GTA. Construirlo sobre el esqueleto freemode lo evita por completo: todas las animaciones y emotes funcionan con él.

6. Demasiadas colecciones de ropa

Si al añadir el ped empiezan a crashear todos los peds MP masculinos o femeninos, el problema no es el ped sino las colecciones de ropa cargadas con él: GTA solo carga un número limitado de archivos de ropa .ymt por género. Consulta la guía del límite de YMT.

Pruébalo aislado

Arranca un servidor solo con tu framework y el ped, y haz spawn con SetPlayerModel. Si ahí funciona, otro recurso está sobrescribiendo el mismo nombre de modelo o superando algún límite.

Preguntas frecuentes

El ped es invisible pero veo su sombra o su nombre. ¿Por qué?

El modelo se ha cargado pero sus drawables no: normalmente es un diccionario de texturas que no ha podido cargar (demasiado grande o con nombre incorrecto) o drawables con un nombre distinto al que espera el modelo.

El ped se queda en T-pose y no se anima. ¿Por qué?

Su esqueleto no es uno que conozcan las animaciones de GTA. Las animaciones se reproducen sobre huesos con nombre; un ped construido sobre su propio esqueleto solo reproduce animaciones hechas para él.

¿Un solo ped roto puede crashear a todo el mundo?

Sí. Un ped cuyos archivos superan los límites de streaming o cuyo meta está mal formado puede crashear a cada cliente que lo cargue, por eso a menudo parece un crash aleatorio cerca de un mismo lugar.

Pruébalo gratis

Crea una cuenta gratis, únete al Discord para tus créditos, y construye tu primer asset en minutos.