← Devlog

Rendimiento en FiveM: encontrar qué va con lag, del resmon al profiler del servidor

Averigua por qué va con lag un servidor de FiveM con las herramientas que trae: resmon, profiler, avisos de hitch, state bags, eventos y base de datos.

«El servidor va con lag» es un síntoma, no un diagnóstico. Puede ser el PC del jugador, su conexión, el servidor, un script en cualquiera de los dos lados, la base de datos o los assets que el juego tiene que cargar. El arreglo de uno no hace nada por los otros, así que lo primero es averiguar cuál es.

Esta guía repasa las herramientas que trae FiveM para eso, y los problemas que aparecen una y otra vez en los servidores grandes. Vale para FiveM tal como lo usan hoy la mayoría de servidores (FXServer sobre GTA V Legacy); la nueva versión para GTA V Enhanced cambia algunas herramientas.

Primero, ¿dónde va con lag?

  • Todos en el mismo momento (rubber-banding, acciones que responden tarde): casi siempre el servidor o la base de datos.
  • Un jugador, o un sitio: el cliente. Su equipo, los scripts que corren cerca de él o los assets de alrededor.

En el cliente, cl_drawperf true muestra en pantalla FPS, ping, pérdida de paquetes, CPU y GPU, y netgraph true muestra el tráfico de red. Un ping alto o pérdida de paquetes es un problema de red que ningún cambio en un script va a arreglar.

Resmon: lo que cuestan los scripts del cliente

resmon true en la consola del cliente (F8) abre el Resource Monitor: tiempo de CPU por recurso en milisegundos, memoria y streaming. Tres cosas a saber:

  • Es una media de los últimos 64 ticks, y en el cliente un tick es un frame. Un script a 0,01 ms que tarda 5 ms una vez por segundo provoca igualmente un tirón, y el resmon parecerá limpio.
  • Solo enseña el cliente. Los scripts de servidor no aparecen.
  • FiveM avisa a los jugadores cuando un recurso pasa de 6 ms de media, con su nombre en pantalla.

Un script bien hecho marca 0,00 ms en reposo. Las excepciones son nativos que tienen que ejecutarse en cada frame mientras algo está en pantalla (dibujar texto o un marcador, desactivar un control), y solo mientras hacen falta. En uso, una cifra pequeña está bien, y después vuelta a 0,00 ms. Los núcleos del framework y las librerías marcan más porque trabajan para todos los demás recursos; lo que importa es que su cifra sea estable. Mira en sitios concurridos: un script a 0,00 ms en un descampado puede marcar 0,30 ms entre la gente.

El profiler: qué función, y cuándo

El resmon te dice qué recurso. El profiler te dice qué función, y enseña los picos que la media esconde:

profiler record 500
profiler view

record recibe un número de frames y view abre una línea de tiempo en un visor de Chrome DevTools. profiler saveJSON archivo.json la guarda para comparar antes y después de un cambio. Los mismos comandos funcionan en la consola del servidor, donde cuentan ticks del servidor e imprimen un enlace para abrir. Los eventos de servidor, los callbacks de ox_lib y las esperas de base de datos aparecen con su nombre.

El servidor: avisos de hitch y txAdmin

FXServer tiene tres hilos principales e imprime un aviso cuando uno tarda mucho más de su intervalo:

Hilo Se ejecuta cada Aviso
Principal (scripts, eventos) 50 ms server thread hitch warning: timer interval of N milliseconds
Red 10 ms network thread hitch warning: ...
Sincronización (OneSync) unos 8 ms sync thread hitch warning: ...

Los scripts de servidor corren en el hilo principal, así que un Wait(0) ahí se reanuda en el siguiente tick del servidor, unos 50 ms después. Un par de avisos al arrancar es normal; los avisos durante la partida son el lag que describen tus jugadores.

txAdmin dibuja en su panel los tiempos de tick de cada hilo. Un servidor sano tiene casi todos los ticks en las franjas más rápidas. Ticks lentos del hilo principal en hora punta apuntan a un script o una consulta; ticks lentos de sincronización, a entidades y a OneSync.

Bucles de cliente

El objetivo es sencillo: casi nada debería ejecutarse en cada frame para todos los jugadores. Un servidor con cientos de recursos puede funcionar con un puñado de bucles permanentes por frame, como la densidad de tráfico; todo lo demás debería esperar a una distancia, una tecla o un evento.

Wait no puede ir más rápido que un frame. La documentación de FiveM es clara: Wait(0) pausa hasta el siguiente tick, y un hilo se reanuda como mucho una vez por tick. Wait(2) no son «500 veces por segundo»: a 60 FPS son 60, como Wait(0). Para menos trabajo, espera más o para el bucle.

Separa el trabajo del dibujado. Saber quién está cerca es caro y puede hacerse cada 500 ms. Dibujar se hace en cada frame, pero solo mientras hay alguien a quien dibujar:

local nearby = {}

CreateThread(function()
    while true do
        local found, myPed = {}, PlayerPedId()
        local me = GetEntityCoords(myPed)
        for _, player in ipairs(GetActivePlayers()) do
            local ped = GetPlayerPed(player)
            if ped ~= myPed and #(GetEntityCoords(ped) - me) < 25.0 then
                found[#found + 1] = player
            end
        end
        nearby = found
        Wait(500)
    end
end)

CreateThread(function()
    while true do
        if #nearby > 0 then
            for _, player in ipairs(nearby) do
                -- dibuja la ID de este jugador
            end
            Wait(0)
        else
            Wait(500)
        end
    end
end)

Crea las cosas solo cerca del jugador. Un error habitual es crear todos los peds de tiendas, cajeros y objetos en cuanto el jugador entra. Lo arregla un hilo que comprueba la distancia cada pocos cientos de milisegundos, crea la entidad cuando el jugador se acerca y la borra cuando se va. Los points de ox_lib o PolyZone lo envuelven, pero el patrón no necesita ninguna librería.

Los nativos se suman. Cada llamada a un nativo cruza de Lua al juego. Un PlayerPedId() es barato; la misma llamada dentro de bucles en decenas de recursos, no. Con ox_lib, cache.ped y cache.vehicle se actualizan cada 100 ms; sin él, lee el valor una vez por vuelta y reutilízalo. ESX y ox_lib siguen cada uno al jugador en su propio hilo, así que no añadas un tercero.

State bags en lugar de tormentas de eventos

Los scripts antiguos suelen enviar un evento a todos los jugadores cada vez que algo cambia. Los state bags lo hacen por ti: GlobalState para valores de todo el servidor, Player(source).state para un jugador y Entity(entidad).state para un vehículo, un ped o un objeto. El estado escrito en el servidor se replica solo, quien entra después recibe el valor actual, y los clientes reaccionan con AddStateBagChangeHandler.

Lo que muerde en la práctica: cada lectura devuelve el valor completo serializado, así que no leas tablas grandes en bucles; las escrituras anidadas (state.data.money = 10) no se replican; los clientes pueden escribir estado en las entidades que controlan salvo que actives sv_stateBagStrictMode; y un cliente que envía demasiadas actualizaciones es expulsado. No son para valores que cambian en cada frame.

Los eventos y sus límites

TriggerClientEvent(nombre, -1, ...) llega a todos los jugadores. Está bien para el clima o un anuncio global, y mal para casi todo lo demás, como un chat que envía cada /me a todo el mapa. Con OneSync el servidor sabe dónde está cada uno, así que envíalo a los jugadores cerca del origen.

Para cargas grandes, TriggerLatentClientEvent envía en segundo plano (25.000 bytes por segundo por jugador por defecto) en lugar de bloquear el canal de red del jugador. En la otra dirección, el servidor limita los eventos de cada cliente: un script que dispara eventos de servidor desde un bucle hace que su jugador sea expulsado con Reliable network event overflow.

KVP para datos pequeños

SetResourceKvp y GetResourceKvpString guardan datos clave-valor sin la base de datos. En el cliente se guardan en el PC del jugador y sirven para preferencias como la disposición de un HUD, con dos matices: van por nombre de recurso, no por servidor, y el jugador puede editarlos, así que nunca te fíes de ellos. En el servidor es un almacén local para ajustes pequeños de un recurso.

La base de datos

Encuentra primero las consultas lentas. oxmysql imprime cada consulta que pasa de un umbral (200 ms por defecto) con el recurso que la envió:

set mysql_slow_query_warning 150

Después busca los patrones de siempre: un insert por jugador dentro de un bucle en lugar de un solo insert de varias filas; una consulta por fila después de leer una tabla (el clásico N+1); y actualizaciones esperadas una a una al parar un recurso. Y los índices: owned_vehicles.owner lo usan decenas de consultas en un servidor ESX típico y a menudo no tiene ninguno.

CREATE INDEX idx_owned_vehicles_owner ON owned_vehicles (owner);

En el servidor, no busques a los jugadores uno a uno. ESX Legacy filtra por ti y, desde la 1.10.2, cuenta por trabajo:

for _, xPlayer in pairs(ESX.GetExtendedPlayers('job', 'police')) do
    -- solo la policía, en una pasada
end

local cops = ESX.GetNumPlayers('job', 'police') -- leído de un contador

En QBCore, QBCore.Functions.GetQBPlayers(); en Qbox, exports.qbx_core:GetQBPlayers().

Assets

El streaming es lo más lento al entrar en un servidor grande, y los packs de ropa suelen ser la parte más pesada. Con discos lentos, un cliente puede quedarse parado al entrar lo bastante como para que caduquen las peticiones de modelos de los scripts. FXServer avisa al arrancar un recurso cuando un asset usa más de 16 MiB de memoria, y por encima de 48 MiB añade que dará problemas de streaming: lee esos avisos, dicen el nombre del archivo. En el cliente, strmem lista la memoria de streaming por asset. Vigila los nombres de archivo duplicados entre recursos (solo se usa uno), y recomprime con cuidado: una pasada agresiva ahorra memoria, pero la pérdida de calidad se puede notar.

Lista

  1. Pide cl_drawperf cuando los jugadores avisen de lag, para descartar la red.
  2. Apunta cada script que no marque 0,00 ms en reposo en el resmon, en una zona concurrida.
  3. Perfila el cliente donde da tirones y el servidor en hora punta. Mira los picos, no las medias.
  4. Revisa los avisos de hitch y la gráfica de hilos de txAdmin después de una tarde llena.
  5. Busca bucles que corren en cada frame y eventos de servidor disparados desde bucles.
  6. Lleva el estado sincronizado a state bags y las preferencias del cliente a KVP.
  7. Configura mysql_slow_query_warning e indexa tus consultas más lentas.
  8. Lee los avisos de assets al arrancar los recursos, empezando por los archivos más grandes.

Cada script de XeX se mide así antes de publicarse, y su resmon aparece en su página. Si prefieres que otra persona revise tu servidor, la auditoría de rendimiento y seguridad lo perfila en hora punta y ordena los puntos más lentos por impacto, con el arreglo de cada uno.