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
- Pide
cl_drawperfcuando los jugadores avisen de lag, para descartar la red. - Apunta cada script que no marque 0,00 ms en reposo en el resmon, en una zona concurrida.
- Perfila el cliente donde da tirones y el servidor en hora punta. Mira los picos, no las medias.
- Revisa los avisos de hitch y la gráfica de hilos de txAdmin después de una tarde llena.
- Busca bucles que corren en cada frame y eventos de servidor disparados desde bucles.
- Lleva el estado sincronizado a state bags y las preferencias del cliente a KVP.
- Configura
mysql_slow_query_warninge indexa tus consultas más lentas. - 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.