Guide du système Hitscan, Projectile, Weapon et Ammo d’Unreal

Réponse directe

Modélisez l’arme comme des données avec une machine à états de tir explicite. Le hitscan résout une trace immédiatement et convient aux tirs rapides et droits ; un projectile gère le temps de trajet, la collision et la durée de vie et convient aux tirs évitables ou balistiques. Dans les deux cas, l’arme côté serveur valide la cadence de tir et les munitions, dérive la visée depuis une caméra contrôlée, applique les dégâts une seule fois, et envoie séparément les effets cosmétiques des résultats de gameplay.

Ce guide couvre le tir, l’impact et les munitions. Il ne répète pas les guides généraux de collision, de cycle de vie des dégâts, de prédiction réseau, d’interface d’inventaire ou de multijoueur Steam. L’objectif pratique est une tranche orientée jeu que tout autre développeur peut reproduire depuis un checkout propre. Conservez séparés le comportement du moteur, la politique du projet et les preuves mesurées : la documentation Epic définit les concepts pris en charge, le projet définit la propriété et les budgets, et un run de test nommé prouve uniquement le résultat local.

Ce que ce guide apporte

• Un modèle de propriété concret pour système de munitions d’arme hitscan projectile Unreal.
• Un flux de travail de mise en œuvre Blueprint/C++ en six étapes avec un exemple réel d’API ou de commande.
• Trois scénarios de production, incluant comportement normal, limites, et comportement de passation.
• Critères de récupération d’échec et de validation pour les builds éditeur et packagés.
• Un passage de relais SEELE borné qui mène au créateur Unreal sans modifier l’intention technique de cette page.

Architecture système et propriété

Définition de l’arme

Stockez le mode de tir, la cadence, la portée, la dispersion, la référence de dégâts, la classe de projectile, la taille du chargeur, le temps de rechargement, les sockets et les références d’effets dans un Data Asset. L’état runtime ne contient que les munitions mutables, le cooldown, le mode rafale et l’identité du propriétaire.

Revue de définition d’arme : Capturez l’état de l’arme et le horodatage du prochain tir, puis montrez comment la solution de visée reçoit ou observe le résultat accepté sans devenir un second propriétaire.

Solution de visée

Choisissez la visée caméra selon l’intention du joueur, puis rapprochez-la du canon pour éviter de tirer à travers les murs à côté du personnage. Enregistrez la trace caméra, la trace d’obstruction du canon et la direction finale.

Revue de la solution de visée : Capturez le chargeur et la réserve avant et après validation, puis montrez comment la machine à états de tir reçoit ou observe le résultat accepté sans devenir un second propriétaire.

Machine à états de tir

Inactif, Tir, Reprise (Cooldown), Rechargement, Vide et Désactivé empêchent le chevauchement des minuteries et la duplication des entrées. Le tir automatique utilise une planification contrôlée, pas une branche Tick non contrainte.

Revue de la machine à états de tir : Capturez la cible caméra versus l’obstruction du canon et montrez comment le gameplay et les effets cosmétiques reçoivent ou observent le résultat accepté sans devenir un second propriétaire.

Gameplay versus cosmétiques

Le serveur ou la simulation autoritative résout les munitions et les dégâts. Les traceurs, les flashs de bouche, l'éjection d'étuis, le camera shake et les decals d’impact observent le résultat et peuvent être prédits ou diffusés en multicast dans un budget défini.

Revue gameplay versus cosmétique : Capturez l'identité d'impact d'un coup autoritatif ou d'un projectile et montrez comment la définition de l'arme reçoit ou observe le résultat accepté sans devenir un second propriétaire.

Workflow de mise en œuvre

1. Étape 1 : Créez un Data Asset WeaponDefinition et un WeaponComponent ou acteur qui possède l’état de tir mutable, le chargeur actuel, les munitions de réserve et la temporisation.
2. Étape 2 : Liez les actions StartFire, StopFire et Reload. Validez le propriétaire, l’état de vie, le mode de tir, le cooldown, les munitions et l’état de rechargement avant de consommer quoi que ce soit.
3. Étape 3 : Pour le hitscan, tracez depuis le point de visée, déterminez le point voulu, puis tracez ou balayez depuis la bouche jusqu’à ce point pour détecter l’obstruction proche.
4. Étape 4 : Pour les projectiles, n’instanciez qu’après une vérification claire du canon, initialisez la vitesse et l’instigateur, configurez la collision et la durée de vie, et décidez explicitement de l’autorité serveur ou client.
5. Étape 5 : Consommez une seule unité de munitions uniquement lorsque le tir autoritatif est accepté. Le rechargement transfère le minimum entre capacité de chargeur manquante et réserve disponible à un point de commit nommé.
6. Étape 6 : Testez le faible taux de rafraîchissement, l’appui/libération rapide, l’interruption de rechargement, le chargeur vide, le canon contre le mur, les cibles en mouvement, le tir ami, la latence des paquets et la destruction d’un acteur pendant les timers.

Exemple concret d’API ou de commande

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

Trois scénarios de production

Exemple 1 : Hitscan de fusil

Une trace caméra choisit la cible, une trace canon empêche de tirer à travers une couverture proche, le serveur applique les dégâts de point, et un résultat répliqué pilote la présentation du tracer et de l’impact.

Les preuves pour un hitscan de fusil doivent inclure l'état de l'arme et l'horodatage du prochain tir, l'identité de build propriétaire, et la condition qui ramène ce scénario à son dernier état connu bon.

Exemple 2 : Projectile plasma lent

Un composant de mouvement de projectile répliqué possède la vélocité et la collision. Les clients voient le trajet et peuvent s'esquiver ; l'impact applique une seule fois des dégâts radiaux puis détruit ou renvoie l'acteur dans un pool.

Les preuves pour le projectile plasma lent doivent inclure le chargeur et la réserve avant et après validation, l’identité de build propriétaire, et la condition qui ramène ce scénario à son dernier état connu correct.

Exemple 3 : Motif de fusil à pompe

Générez une graine de dispersion déterministe pour un nombre fixe de pellets, tracez chaque pellet sous un tir accepté, regroupez les dégâts lorsque c’est pertinent, et dépensez une cartouche plutôt qu’une unité de munition par pellet.

Les preuves pour le motif de tir de fusil à pompe doivent inclure la cible caméra versus obstruction du canon, l’identité de build propriétaire, et la condition qui ramène ce scénario à son dernier état connu correct.

Modes de défaillance et reprise

La cadence de tir varie avec le frame rate

Programmez les tirs depuis le temps ou des timers et conservez le prochain temps de tir accepté. Ne confondez pas un Tick avec un tir.

Avant de clore les changements de cadence de tir liés au frame rate, relancez le hitscan du fusil et prouvez que la cible de caméra versus l’obstruction de la bouche retourne à la limite attendue sans étape de réparation non documentée.

La caméra voit la cible mais la bouche est bloquée

Utilisez la solution de visée en deux étapes et exposez les deux traces de débogage. Faites apparaître ou tracez depuis la bouche seulement après que le résultat de l’obstruction soit connu.

Avant de clôturer que la caméra peut voir la cible mais le canon est bloqué, relancez le projectile plasma lent et démontrez que l’identité d’impact autorisé ou de projectile impact revient à la limite attendue sans étape de réparation non documentée.

Les munitions deviennent négatives ou le rechargement se duplique

Engagez les munitions sur un seul chemin autoritaire, protégez les transitions d’état, et annulez ou terminez le rechargement à un point d’animation/événement explicite.

Avant de clôturer que les munitions ne deviennent négatives ou que le rechargement ne se duplique, relancez le motif de fusil à pompe et démontrez que le nombre d’événements cosmétiques et le nettoyage des objets en pool reviennent à la limite attendue sans étape de réparation non documentée.

Le projectile inflige des dégâts deux fois

Rendez l’impact idempotent, désactivez la collision avant d’appliquer le résultat, et assurez-vous que les rappels de rebond, chevauchement, impact et durée de vie ne puissent pas chacun valider les dégâts.

Avant de clôturer que le projectile inflige des dégâts deux fois, relancez le hitscan de fusil et démontrez que l’état de l’arme et le horodatage du prochain tir reviennent à la limite attendue sans étape de réparation non documentée.

Matrice de validation

• État de l’arme et horodatage du prochain tir : Inspectez-la à côté de la définition de l’arme ; validez uniquement lorsque la variation du taux de tir avec la fréquence d’images ne se reproduit pas pendant le hitscan de fusil, et que les preuves indiquent la build exacte.
• Le chargeur et la réserve avant et après validation : Inspectez-la à côté de la solution de visée ; validez uniquement lorsque la caméra peut voir la cible mais le canon est bloqué, sans que cela se reproduise pendant le projectile plasma lent, et que les preuves mentionnent la build exacte.
• cible caméra versus obstruction du canon : inspectez-le à côté de la machine à états de tir ; validez uniquement lorsque le stock devient négatif ou que les rechargements en double ne se reproduisent plus pendant le motif de fusil à pompe et que les preuves mentionnent le build exact.
• identité d’impact autorisé ou d’impact projectile : Inspectez-les à côté du gameplay versus l’esthétique ; ne validez que lorsque les dégâts des projectiles ne se produisent pas deux fois pendant le hitscan du fusil et que les preuves indiquent exactement le build utilisé.
• nombre d’événements cosmétiques et nettoyage des objets poolés : Inspectez-la à côté de la définition de l’arme ; validez uniquement lorsque la variation du taux de tir avec la fréquence d’images ne se reproduit pas pendant le projectile plasma lent et que les preuves indiquent la build exacte.

Inspectez-le à côté de la présentation et de l’autorité ; validez uniquement lorsque plusieurs interactions déclenchées par une pression ne se reproduisent pas lors d’une porte avec état de verrouillage et que les preuves mentionnent le build exact.

Ces étapes ciblent la surface de documentation Unreal Engine 5 actuelle au 2026-07-26. Les valeurs par défaut du moteur, le statut expérimental, le packaging des plugins, les signatures API et la prise en charge des plateformes peuvent changer. Sélectionnez la version de la documentation qui correspond au projet, testez le patch exact et la cible, et conservez une révision de rollback. La documentation publique ne remplace pas les exigences NDA de plateforme, la revue en store, la certification console ou les preuves de performance spécifiques au projet.

Sources officielles

• Utiliser un trace sur une seule ligne — preuve source de la définition d’arme dans ce flux de travail système d’armes hitscan et projectile Unreal ; vérifiez la version de la documentation par rapport à la branche de production.
• Composant de mouvement de projectile — preuve source de la solution de visée dans ce flux de travail système d’armes hitscan et projectile Unreal ; vérifiez la version de la documentation par rapport à la branche de production.
• Data Assets — preuve source de la machine à états de tir dans ce flux de travail système d’armes hitscan et projectile Unreal ; vérifiez la version de la documentation par rapport à la branche de production.

Unreal Engine est une marque déposée d'Epic Games. SEELE AI est indépendant et cet article n'implique pas l'approbation d'Epic Games ou de Valve.

Du plan technique au jeu Unreal de SEELE

Utilisez cette page pour définir le système, les tests d'acceptation et les limites de défaillance ; puis transmettez ce cahier des charges précis dans [le créateur de jeu Unreal de SEELE](/features/create/unreal-game). SEELE peut générer un jeu natif Unreal 5, fournir un aperçu dans le navigateur, prendre en charge l'optimisation et le packaging dans SEELE, et vous permettre de télécharger le projet ou la sortie packagée pour une publication externe ou de le publier en tant que jeu SEELE gratuit ou payant.

Ce transfert ne modifie pas la responsabilité de production native décrite ci-dessus. L'approbation du magasin, les ventes, les revenus, la certification, la compatibilité des plugins tiers et la conformité de la plateforme ne sont pas garanties. Gardez le jeu Unreal source, les journaux de compilation, les preuves de test et les décisions de publication externes sous le contrôle de votre équipe.

FAQ

Quelle est la bonne architecture pour le système de munitions d’arme projeciles hitscan d’Unreal ?

Modélisez l’arme comme des données avec une machine d’états de tir explicite. Les hitscan résout une trace immédiatement et convient aux tirs rapides et rectilignes ; un projectile gère le temps de vol, la collision et la durée de vie et convient aux tirs esquivables ou balistiques. Dans les deux cas, l’arme autoritaire valide le rythme de tir et les munitions, déduit la visée depuis un point de vue contrôlé, applique les dégâts une seule fois, et envoie les effets cosmétiques séparément des résultats de gameplay. Commencez par la définition de l’arme et la solution de visée, puis gardez la présentation en observateur de l’état de gameplay validé.

Le système de munitions d’arme hitscan projectile Unreal doit-il être construit en Blueprint ou en C++ ?

Les deux sont possibles. Blueprint est efficace pour une logique de jeu rapide et l’itération des designers ; C++ est utile pour des contrats réutilisables, des durées de vie complexes, des boucles sensibles aux performances et des tests automatisés. Conservez les mêmes limites de propriété, de validation, d’échec et de récupération dans les deux cas.

Comment tester le système d’armes munitions projectile hitscan Unreal ?

Testez un cas normal, une saisie invalide, une interruption ou démontage, un redémarrage propre, et la parité de build packagé. Capturez l’état de l’arme et l’horodatage du prochain tir, le chargeur et la réserve avant et après engagement, la cible caméra versus l’obstruction du canon avec un identifiant de build et des critères de succès explicites.

Quelle est la défaillance la plus dangereuse dans le système d’armes hitscan projectile Unreal ?

La variation du taux de tir avec la fréquence d’images est un signal d’alerte précoce : planifiez les tirs depuis le temps ou des timers et conservez le prochain temps de tir accepté. Ne confondez pas une Tick avec un tir. Vérifiez également le nettoyage et la relance pour que la correction apparente ne laisse pas d’état obsolète.

Quelle version d’Unreal ce guide sur le système de munitions d’arme hitscan projectile devrait-il cibler ?

Il utilise la surface de documentation Unreal Engine 5 disponible le 2026-07-26. Vérifiez le sélecteur de version, la signature API, l’état du plugin, la chaîne d’outils de plateforme et le comportement packagé dans le patch moteur exact qui sera livré.

Que peut faire SEELE une fois que ce plan de système de munitions d’arme hitscan projectile Unreal est prêt ?

SEELE peut générer un jeu natif Unreal 5, fournir une prévisualisation navigateur, prendre en charge l'optimisation et l'empaquetage, et fournir des téléchargements de projet ou d'application empaquetée pour une publication externe ou une sortie SEELE gratuite ou payante. Il ne garantit pas l'approbation par des magasins tiers, la compatibilité, les ventes ou les revenus.