Cómo eliminar la mira en FiveM (HideHudComponentThisFrame 14)

Respuesta rápida: Los servidores FiveM eliminan la mira cruzada predeterminada GTA — componente HUD 14, el retículo — ejecutando HideHudComponentThisFrame(14) cada frame en un script de cliente. La llamada debe ejecutarse en el cliente, dentro de un bucle, porque los componentes de HUD se vuelven a renderizar en el siguiente frame. A continuación: el recurso de copia-pega, un comando opcional de alternancia de jugador y correcciones para una mira que sigue apareciendo.

Los ejemplos de configuración y código aquí están dirigidos a FiveM para GTA V Legacy. Enhanced tiene diferentes reglas de tiempo de ejecución y compatibilidad; consulta los cambios de Legacy a Enhanced de Cfx.re antes de aplicarlos a un servidor Enhanced.

Script de cliente copiable

Crea un pequeño recurso de cliente y pon esto en client.lua:

CreateThread(function()
 while true do
 Wait(0)
 HideHudComponentThisFrame(14)
 end
end)

La referencia nativa oficial de Cfx.re enumera HideHudComponentThisFrame como la nativa para ocultar componentes HUD. El componente 14 es la retícula/punto de mira.

fxmanifest.lua mínimo

Coloca esto junto a client.lua en una carpeta de recursos, por ejemplo resources/[local]/no-crosshair/:

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

Luego agrega el recurso a server.cfg:

ensure no-crosshair

Por qué tiene que ejecutarse en cada fotograma

El ocultamiento de HUD se basa en fotogramas. Llamar al nativo una vez puede parecer que funcionó por un momento, pero la retícula regresa porque GTA renderiza los componentes de HUD nuevamente en fotogramas posteriores. Mantén el bucle ligero y no agregues lógica costosa dentro de él.

Eliminación de mira del lado del jugador vs del lado del servidor

Meta	Mejor método
Eliminar la retícula predeterminada de GTA para todos	Usa un recurso cliente pequeño con HideHudComponentThisFrame(14).
Deja que los jugadores elijan	Agrega una configuración de cliente o comando que alterne el bucle.
Eliminar un HUD de armas personalizado	Revisa el recurso de arma/HUD. Puede dibujar su propia mira.
Detener monitores o superposiciones que añadan un punto	Revisa las superposiciones del cliente, funciones del monitor y modificaciones gráficas.

Comando de alternancia opcional

Para un interruptor de jugador, reemplaza el primer ejemplo de client.lua con esta versión completa. No ejecutes ambos bucles:

local crosshairHidden = true

RegisterCommand('crosshair', function()
 crosshairHidden = not crosshairHidden
 print(crosshairHidden and 'Crosshair hidden' or 'Crosshair visible')
end, false)

CreateThread(function()
 while true do
 Wait(0)
 if crosshairHidden then
 HideHudComponentThisFrame(14)
 end
 end
end)

Solución de problemas

• Si la mira aún aparece, otro recurso de HUD o arma puede estar dibujando su propio elemento.
• Si el recurso no se inicia, verifica la Configuración de fxmanifest.lua.
• Si solo un jugador ve un punto, revisa las superposiciones del monitor o herramientas gráficas en ese PC.

Preguntas frecuentes

¿Se puede hacer esto en server.lua?

No. El renderizado de HUD es del lado del cliente. Activa un evento de cliente si necesitas lógica del servidor, pero llama al nativo en el código del cliente.

¿Esto afecta a las miras personalizadas?

Oculta el componente de retícula predeterminado. Los scripts de armas personalizados, miras o superposiciones NUI pueden seguir dibujando su propio UI.

Lista de verificación para implementación en servidor

Antes de agregar esto a un servidor de rol en vivo, pruébalo con las armas y recursos HUD que tus jugadores ya usan. Una retícula predeterminada puede ocultarse mediante el componente 14, pero muchos servidores también ejecutan superposiciones de armas, miras personalizadas o NUI HUDs. Esos scripts pueden dibujar su propia mira y necesitan configuraciones separadas.

1. Crea el recurso en un servidor de prueba.
2. Prueba pistolas, rifles, escopetas, armas cuerpo a cuerpo y movimiento desarmado.
3. Verifica la vista en primera y tercera persona.
4. Abre el inventario, menú radial, reemplazo de la rueda de armas y HUD.
5. Pide a un probador con un cliente limpio y a otro con superposiciones normales que comparen.

Cómo depurar una mira que reaparece

Si el punto vuelve solo al apuntar, es posible que tu código no se esté ejecutando en cada fotograma. Si vuelve solo con un arma o un trabajo, es posible que un recurso de armas o policía dibuje el UI. Si aparece solo para un jugador, verifica las funciones de mira del monitor, superposiciones de ReShade, superposiciones de GPU o herramientas de accesibilidad en ese PC.

Redacción adecuada de las reglas del servidor

Si tu servidor prohíbe las miras externas, escribe la regla claramente: sin mira en el monitor, sin superposición de mira, sin punto de puntería de terceros. Luego hazla cumplir con revisión del personal en lugar de depender solo de un script que oculte la retícula predeterminada HUD.

Documentación de referencia

Cfx.re — nativos