Guía 2026-05-07

Guía del sistema de raycasting y targeting en FiveM

TDYSKY

TDYSKY

Fundador y desarrollador principal de Agency Scripts

Sistemas de targeting en FiveM

Los sistemas de targeting ofrecen interacción precisa con objetos y NPCs del mundo en FiveM. En lugar de presionar E genéricamente cerca de algo, el jugador apunta con la retícula y selecciona la entidad específica con la que quiere interactuar. qtarget y ox_target son los dos estándares y han revolucionado la interacción en servidores de rol. Ambos funcionan con raycasting desde la cámara del jugador.

Cómo funciona el raycasting

El raycasting dispara un rayo invisible desde la cámara hacia donde mira el jugador y detecta la primera entidad que intercepta. Se hace en cada frame con la native StartShapeTestRay y proporciona información sobre la entidad impactada, hueso (bone) y posición exacta. Con esta información, el script decide qué opciones de interacción mostrar según el tipo de entidad, el modelo o condiciones específicas.

qtarget vs ox_target

qtarget fue pionero y sigue siendo ampliamente usado. ox_target, de Overextended, es más moderno, mejor documentado y con mejor rendimiento. La API es similar pero ox_target tiene mejor soporte para zonas poligonales complejas, filtrado por trabajo y permisos, y polish visual. Para proyectos nuevos, ox_target es la mejor elección; para proyectos existentes basados en qtarget, migrar suele ser sencillo.

Zonas y modelos

Los targets pueden registrarse por entidad específica (un ped concreto), por modelo (todos los peds de cierto modelo), por hueso (solo la cabeza del ped) o por zona (cualquier entidad dentro de un área definida). Las zonas son útiles para interacciones con props del mapa que no quieres registrar individualmente: coloca una zona box sobre el mostrador de una tienda y añade la opción "Hablar con el dependiente" que cualquier ped dentro active.

Optimización y buenas prácticas

Registra targets solo cuando sean relevantes: no registres targets para ubicaciones distantes que el jugador no va a ver. Limpia los targets en onResourceStop para evitar entidades huérfanas. Usa filtros por trabajo o condición para que los jugadores solo vean opciones aplicables a su rol, reduciendo el clutter visual. Un sistema de targeting bien implementado se siente invisible hasta que lo necesitas, creando interacciones naturales.

Compartir este artículo

¿Listo para mejorar tu servidor?

Echa un vistazo a nuestros scripts premium de FiveM en la tienda de Agency Scripts o únete a nuestra comunidad de Discord para soporte y novedades.