Guía del sistema de hitscan, proyectiles, armas y munición de Unreal

Respuesta directa

Modela el arma como datos más una máquina de estado de disparo explícita. Hitscan resuelve un trazo inmediatamente y se ajusta a disparos rápidos y rectos; un proyectil gestiona el tiempo de recorrido, la colisión y la vida útil y se ajusta a disparos esquivables o balísticos. En ambos casos, el arma autorizada valida la cadencia y la munición, deriva el objetivo de una vista controlada, aplica daño una sola vez y envía efectos cosméticos por separado de los resultados del gameplay.

Esta guía posee el disparo, el impacto y la munición. No repite las guías generales de colisión, ciclo de vida de daño, predicción de red, interfaz de inventario o multijugador en Steam. El objetivo práctico es una porción de construcción del juego que otro desarrollador pueda reproducir desde un checkout limpio. Mantén separados el comportamiento del motor, la política del proyecto y la evidencia medida: la documentación de Epic establece conceptos compatibles, el proyecto define propiedad y presupuestos, y solo una ejecución de prueba con nombre demuestra el resultado local.

Lo que ofrece esta guía

• Un modelo de propiedad concreto para sistema de munición de arma hitscan/proyectil de Unreal.
• Un flujo de trabajo de implementación en seis etapas en Blueprint/C++ con un ejemplo real de API o comando.
• Tres escenarios de producción, incluyendo comportamiento normal, de borde y de transferencia.
• Criterios de recuperación de fallos y validación para builds de editor y empaquetadas.
• Una entrega de SEELE acotada que conduce al creador de Unreal sin cambiar la intención técnica de esta página.

Arquitectura del sistema y propiedad

Definición del arma

Almacena el modo de disparo, la cadencia, alcance, dispersión, referencia de daño, clase de proyectil, tamaño de cargador, tiempo de recarga, sockets y referencias de efectos en un Data Asset. El estado en tiempo de ejecución contiene solo munición mutable, cooldown, ráfaga e identidad del propietario.

Revisión de la definición de arma: captura el estado del arma y la marca de tiempo del próximo disparo y muestra cómo la solución de puntería recibe u observa el resultado aceptado sin convertirse en un segundo propietario.

Solución de puntería

Elige la puntería de cámara según la intención del jugador y luego compárala con el cañón para evitar disparar a través de paredes junto al personaje. Registra el trazo de cámara, el trazo de obstrucción del cañón y la dirección final.

Revisión de la solución de puntería: captura el cargador y la reserva antes y después de la confirmación y muestra cómo la máquina de estados de disparo recibe u observa el resultado aceptado sin convertirse en un segundo propietario.

Máquina de estados de disparo

Inactivo, Disparando, Enfriamiento, Recargando, Vacío y Desactivado: las transiciones evitan timers solapados y entradas duplicadas. El fuego automático usa una programación controlada, no una rama de Tick sin restricciones.

Revisión de máquina de estados de disparo: captura objetivo de cámara frente a obstrucción del cañón y muestra cómo gameplay versus cosméticos recibe u observa el resultado aceptado sin convertirse en un segundo propietario.

Gameplay versus cosméticos

El servidor o simulación autorizada resuelve la munición y el daño. Trazadores, destellos de boca, eyección de vainas, cámara vibrante e impact decals observan el resultado y pueden predecirse o reproducirse por multicast dentro de un presupuesto.

Revisión de gameplay versus cosméticos: captura la identidad autorizada del impacto del hit o del proyectil y muestra cómo la definición del arma recibe u observa el resultado aceptado sin convertirse en un segundo propietario.

Flujo de trabajo de implementación

1. Etapa 1: Crea un WeaponDefinition Data Asset y un WeaponComponent o actor que posea estado de disparo mutable, cargador actual, munición de reserva y temporización.
2. Etapa 2: Vincula las acciones StartFire, StopFire y Reload. Valida propietario, estado vital, modo de disparo, tiempo de enfriamiento, munición y estado de recarga antes de consumir cualquier recurso.
3. Etapa 3: Para hitscan, traza desde el punto de vista de puntería, resuelve el punto deseado y luego traza o haz un barrido desde el cañón hacia ese punto para detectar obstrucciones cercanas.
4. Etapa 4: Para proyectiles, genera solo después de una comprobación clara del cañón, inicializa velocidad e instigador, configura colisión y tiempo de vida, y decide explícitamente la autoridad del servidor o del cliente.
5. Etapa 5: Consume una unidad de munición solo cuando el disparo autorizado es aceptado. La recarga transfiere el mínimo entre la capacidad faltante del cargador y la reserva disponible en un punto de commit con nombre.
6. Etapa 6: Prueba baja tasa de fotogramas, pulsación/liberación rápida, interrupción de recarga, cargador vacío, cañón contra pared, objetivos en movimiento, fuego amigo, latencia de paquetes y destrucción del actor durante temporizadores.

Ejemplo concreto de API o comando

const bool bAccepted = State == EWeaponState::Idle && AmmoInMagazine > 0 && Now >= NextFireTime;
if (!bAccepted) return;
--AmmoInMagazine;
NextFireTime = Now + 60.f / Definition->RoundsPerMinute;
ResolveAuthoritativeShot(AimOrigin, AimDirection);
PlayFireCosmetics();

Tres escenarios de producción

Ejemplo 1: Rifle hitscan

Un trazo de cámara elige el objetivo, un trazo del cañón impide disparar a través de cobertura cercana, el servidor aplica daño puntual y un resultado replicado impulsa la presentación de tracer e impacto.

La evidencia de un hitscan de rifle debe incluir el estado del arma y la marca temporal del siguiente disparo, la identidad de compilación propietaria y la condición que devuelve este escenario a su último estado conocido como bueno.

Ejemplo 2: Proyectil de plasma lento

Un componente de movimiento de proyectil replicado posee la velocidad y la colisión. Los clientes ven el trayecto y pueden esquivar; el impacto aplica daño radial una vez y destruye o devuelve el actor a un pool.

La evidencia para el proyectil de plasma lento debe incluir el cargador y la reserva antes y después de la confirmación, la identidad del build propietario y la condición que devuelve este escenario a su último estado conocido válido.

Ejemplo 3: Patrón de escopeta

Genera una semilla de dispersión determinista para una cantidad fija de perdigones, traza cada perdigón dentro de un disparo aceptado, agrega daño cuando corresponda y gasta una cartuchera en lugar de una unidad de munición por perdigón.

La evidencia del patrón de escopeta debe incluir objetivo de cámara versus obstrucción del cañón, la identidad del build propietario y la condición que devuelve este escenario a su último estado conocido válido.

Modos de fallo y recuperación

La cadencia de disparo cambia con la velocidad de fotogramas

Programa los disparos por tiempo o temporizadores y lleva la próxima marca de tiempo de disparo aceptada. No equipares un Tick con un disparo.

Antes de cerrar los cambios de cadencia con la tasa de fotogramas, vuelve a ejecutar el hitscan de rifle y demuestra que el objetivo de la cámara frente a la obstrucción del cañón retorna al límite esperado sin un paso de reparación no documentado.

La cámara puede ver el objetivo pero el cañón está bloqueado

Usa la solución de puntería en dos fases y expón ambos trazados de depuración. Genera o traza desde el cañón solo después de que se conozca el resultado de la obstrucción.

Antes de cerrar que la cámara pueda ver el objetivo pero el cañón esté bloqueado, vuelve a ejecutar el proyectil de plasma lento y demuestra que la identidad de impacto autoritativa o de impacto de proyectil regresa al límite esperado sin un paso de reparación no documentado.

La munición se vuelve negativa o la recarga se duplica

Confirma la munición en una sola ruta de autoridad, protege las transiciones de estado y cancela o finaliza la recarga en un punto explícito de animación/evento.

Antes de finalizar que la munición se vuelva negativa o la recarga se duplique, vuelve a ejecutar el patrón de escopeta y demuestra que el conteo de eventos cosméticos y la limpieza de objetos en pool retorna al límite esperado sin un paso de reparación no documentado.

El proyectil hace daño dos veces

Haz idempotente el impacto, desactiva la colisión antes de aplicar el resultado y garantiza que los callbacks de rebote, superposición, impacto y tiempo de vida no puedan comprometer daño por separado.

Antes de cerrar que el proyectil haga daño dos veces, vuelve a ejecutar rifle hitscan y demuestra que el estado del arma y la marca de tiempo del próximo disparo regresan al límite esperado sin un paso de reparación no documentado.

Matriz de validación

• estado del arma y la marca de tiempo del próximo disparo: revísalo junto con la definición del arma; se aprueba solo cuando el cambio de cadencia de disparo con la tasa de frames no se vuelve a repetir durante rifle hitscan y la evidencia nombra el build exacto.
• cargador y reserva antes y después del commit: revísalo junto con la solución de puntería; se aprueba solo cuando la cámara puede ver el objetivo pero el cañón está bloqueado no se vuelve a repetir durante el proyectil de plasma lento y la evidencia nombra el build exacto.
• objetivo de cámara frente a obstrucción del cañón: revísalo junto con la máquina de estado de disparo; aprueba solo cuando la munición no se vuelva negativa o no se repitan recargas duplicadas durante el patrón de escopeta y los nombres de evidencia identifiquen la compilación exacta.
• identidad de impacto autoritativa o de impacto de proyectil: obsérvalo junto al gameplay frente a los elementos cosméticos; aprueba solo cuando los daños por proyectil no se repitan dos veces durante el hitscan de rifle y la evidencia indique la compilación exacta.
• conteo de eventos cosméticos y limpieza de objetos en pool: revísalo junto con la definición del arma; se aprueba solo cuando el cambio de cadencia de disparo con la tasa de frames no se vuelve a repetir durante el proyectil de plasma lento y la evidencia nombra el build exacto.

Presentación y autoridad: verifica únicamente que múltiples interacciones por pulsación no se dispare más de una vez durante la puerta con estado de bloqueo y que las evidencias indiquen la build exacta.

Estos pasos apuntan a la superficie de documentación actual de Unreal Engine 5 al 2026-07-26. Los valores predeterminados del motor, el estado experimental, el empaquetado de plugins, las firmas de API y el soporte de plataforma pueden cambiar. Selecciona la versión de documentación que coincida con el proyecto, prueba el parche exacto y destino objetivo, y conserva una revisión de reversión. La documentación pública no sustituye los requisitos de NDA de plataforma, revisión de tienda, certificación de consola o evidencia de rendimiento específica del proyecto.

Fuentes oficiales

• Usando un trazado de línea única — evidencia fuente para la definición de arma en este flujo de trabajo del sistema de munición de armas hitscan y proyectiles de Unreal; verifica la versión de la documentación contra la rama shipping.
• Projectile Movement Component — evidencia fuente para la solución de puntería en este flujo de trabajo del sistema de munición de armas hitscan y proyectil de Unreal; verifica la versión de la documentación contra la rama shipping.
• Data Assets — evidencia fuente para la máquina de estados de disparo en este flujo de trabajo del sistema de munición de arma hitscan y proyectil de Unreal; verifica la versión de la documentación contra la rama shipping.

Unreal Engine es una marca registrada de Epic Games. SEELE AI es independiente y este artículo no implica respaldo de Epic Games ni de Valve.

Del plan técnico a un juego de Unreal de SEELE

Utiliza esta página para definir el sistema, las pruebas de aceptación y los límites de fallo; luego lleva ese planteamiento preciso al [creador de juegos Unreal de SEELE](/features/create/unreal-game). SEELE puede generar un juego nativo de Unreal 5, proporcionar una vista previa en el navegador, soportar la optimización y empaquetado en SEELE, y permitirte descargar el proyecto o el resultado empaquetado para publicación externa o publicarlo como un juego SEELE gratuito o de pago.

Esa entrega no cambia la responsabilidad de producción nativa descrita anteriormente. La aprobación de la tienda, ventas, ingresos, certificación, compatibilidad con complementos de terceros y cumplimiento de la plataforma no están garantizados. Mantén el juego de Unreal de origen, registros de compilación, evidencia de prueba y decisiones de publicación externa bajo el control de tu equipo.

FAQ

¿Cuál es la arquitectura correcta para el sistema de munición de arma de proyectil y hitscan de Unreal?

Modela el arma como datos más una máquina de estado de disparo explícita. Hitscan resuelve una traza de inmediato y se adapta a disparos rápidos y rectos; un proyectil posee tiempo de viaje, colisión y tiempo de vida, y se adapta a disparos evitables o balísticos. En ambos casos el arma autoritaria valida la cadencia de disparo y la munición, obtiene el objetivo desde una vista controlada, aplica daño una vez y envía efectos cosméticos por separado de los resultados de gameplay. Empieza con la definición del arma y la solución de puntería, y luego mantiene la presentación como observadora del estado de gameplay confirmado.

¿Debe el sistema de munición de arma hitscan/proyectil de Unreal construirse en Blueprint o en C++?

Ambos pueden funcionar. Blueprint es efectivo para lógica de juego rápida y para la iteración de los diseñadores; C++ es útil para contratos reutilizables, ciclos de vida complejos, bucles sensibles al rendimiento y pruebas automatizadas. Mantén los mismos límites de propietario, validación, fallo y recuperación en ambos.

¿Cómo debería probarse el sistema de munición de arma hitscan y proyectil de Unreal?

Prueba un caso normal, una entrada inválida, una interrupción o desmontaje, reinicio limpio y paridad entre compilación empaquetada. Registra el estado del arma y la marca temporal del siguiente disparo, el cargador y la reserva antes y después del compromiso, el objetivo de cámara frente a la obstrucción de la boca y un identificador de compilación y criterios de aprobación explícitos.

¿Cuál es la falla más peligrosa en el sistema de munición de arma hitscan y proyectil de Unreal?

El cambio de la cadencia de disparo con la tasa de frames es una alerta temprana: programa los disparos por tiempo o timers y conserva el siguiente tiempo de disparo aceptado. No equipares un Tick con un disparo. También verifica limpieza y reintento para que la mejora aparente no deje estado obsoleto.

¿A qué versión de Unreal está dirigida esta guía de sistema de munición de arma de disparo hitscan/proyectil?

Utiliza la superficie de documentación de Unreal Engine 5 disponible al 2026-07-26. Confirma el selector de versión, la firma de la API, el estado de los plugins, la toolchain de plataforma y el comportamiento empaquetado en el parche exacto del motor que se enviará.

¿Qué puede hacer SEELE después de que este plan del sistema de munición de arma hitscan/proyectil de Unreal esté listo?

SEELE puede generar un juego nativo de Unreal 5, proporcionar previsualización en el navegador, soportar optimización y empaquetado, y proporcionar descargas del proyecto o empaquetado para publicación externa o un lanzamiento gratuito o de pago de SEELE. No garantiza la aprobación de tiendas de terceros, compatibilidad, ventas o ingresos.