Armes personnalisées

L'éditeur d'armes (Créer → Armes) crée des armes à balles, de corps à corps, des lance-projectiles et des grenades. Tu importes ton modèle 3D, ou un viewmodel complet avec ses bras et ses animations, puis tu règles le tir, la précision, le recul, les munitions, la visée, les effets et les sons. Les animations humanoïdes en 3e personne (Mixamo, Unreal…) sont adaptées automatiquement au personnage du jeu.

En jeu

Les armes des addons sont dans l'onglet Armes du menu de spawn (le gamemode décide avec GM:PlayerGiveWeapon). Comme les armes du jeu, le tireur voit son tir tout de suite et le serveur vérifie chaque coup : arme possédée, cadence, munitions et visée. C'est aussi le serveur qui calcule les dégâts et la trajectoire des projectiles.

Créer une arme

1. Créer → Armes → Nouveau pack, avec le type de la première arme : arme à balles, corps à corps, lance-projectiles ou grenade. Un pack d'armes est un addon local, publiable sur le Workshop.
2. Un pack, plusieurs armes : la liste à gauche de l'éditeur montre les armes du pack. Nouveau en ajoute une, Dupliquer copie celle sélectionnée avec ses réglages (pratique pour une variante), Supprimer la retire (son fichier part à la corbeille à l'enregistrement). Le nom se change dans les réglages ; à son premier enregistrement, un nouvel élément prend un fichier à son nom (weapons/fusil_2.json).
3. Importer le modèle… (glTF, GLB ou FBX) : il sert pour la 3e personne, l'icône et, en mode « arme seule », la vue 1re personne. La poignée doit être à l'origine et le canon pointer vers -Z. Sinon, corrige dans Modèles (rotation, décalage, échelle ; un modèle exporté en centimètres est mis à l'échelle tout seul).
4. Dans la vue Modèle, place les repères : bouche du canon (orange), éjection des douilles (jaune) et poignée avant (vert, où se pose la main gauche). La main transparente montre la prise en main.
5. Choisis la vue 1re personne (voir plus bas) et associe les animations dans Animations. Le bouton ▶ montre chaque animation dans la vue.
6. Règle le tir, la précision, les munitions, la visée et les sons. La fiche à gauche donne les dégâts par seconde, les coups pour tuer et le temps pour vider le chargeur.
7. Tester : une partie solo démarre avec l'arme en main et des cibles alignées devant toi. Quitter la partie ramène dans l'éditeur. Prends la miniature avec Photo Workshop, puis Publier….

Vue 1re personne

Règle la position dans Modèles (position, rotation et échelle dans la vue) en regardant la vue 1re personne. La position en visée se règle avec le curseur Visée de la barre du haut : les organes de visée doivent être au centre de l'écran.

Animations

Les animations du modèle (ou du viewmodel) sont proposées d'office. Importer des animations… ajoute d'autres fichiers .glb ou .fbx animés sur le même squelette : un fichier par animation, ou plusieurs dans un seul fichier. Les pistes sont rattachées par nom d'os et de pièce. Chaque emplacement a sa vitesse de lecture ; le rechargement est calé sur la durée réglée dans Munitions. Sans viewmodel (le jeu tient le modèle lui-même), un clip prévu pour des bras qui déplace toute l'arme par son os de tête (accroché à la main) n'en garde que les pièces : chargeur, culasse, détente… L'arme reste à la place réglée dans l'onglet Modèles.

Éditeur d'animation (bras du jeu)

En mode Arme + bras du jeu animables (onglet Modèles), l'onglet Animations liste les emplacements 1re personne avec Créer / Modifier. Créer part d'un mouvement type à ajuster : l'arme qui monte pour la sortie, qui descend pour le rangement, qui pivote pour l'inspection, la main gauche qui va chercher un chargeur pour le rechargement. L'édition ouvre une timeline sous la vue 1re personne.

On n'anime pas les os un par un : on place quelques éléments et les bras suivent par IK (épaule, coude, poignet).

Dans la vue, un point de couleur marque chaque élément : blanc l'arme, orange la main droite, vert la main gauche, bleu les coudes, jaune les pièces. Clique sur un point, ou directement sur le modèle (l'arme, une main, une pièce animée), et glisse : l'élément suit la souris (dans le plan de l'écran). Un point sous la souris passe avant les flèches du manipulateur. Le manipulateur de l'élément choisi permet aussi de le déplacer sur un axe ou de le tourner.

Plusieurs à la fois : Maj ou Ctrl + clic sur des points, sur le modèle ou sur des lignes de la timeline les ajoute à la sélection ou les en retire (sans attraper le manipulateur), Ctrl+A les prend tous. Glisser l'un d'eux déplace tout le groupe ; le manipulateur se place au centre du groupe et le tourne autour de ce centre (chaque élément tourne aussi sur lui-même, les coudes ne font que suivre). Une clé est posée sur chaque ligne du groupe. Échap ne garde que l'élément affiché dans le panneau de droite.

Faire une clé : place la tête de lecture (règle en haut de la timeline, glisser), puis bouge l'élément dans la vue. Une clé est créée à cet instant s'il n'y en a pas. Le panneau de droite règle la clé choisie : instant, valeurs exactes, et la transition vers la clé suivante (linéaire, douce, accélère, ralentit, saut). Dans la timeline : clic sur une ligne pour la choisir, clic sur une clé pour la choisir, glisser pour la déplacer dans le temps, double clic pour une clé, clic droit pour la supprimer.

Caméra : au départ, on voit par les yeux du joueur, l'image cadrée sur les bras dans la partie de l'écran laissée libre par les panneaux et la timeline. Clic droit + glisser fait tourner la caméra autour des bras, clic molette + glisser la déplace, la molette zoome : la case Vue libre se coche toute seule. En vue libre, le clic gauche dans le vide tourne aussi la caméra et F la recadre sur les bras. Décoche Vue libre pour revenir à la vue du joueur.

Événements

Le rangement se joue avant de changer d'arme : l'arme suivante sort une fois l'animation finie. Les animations sont calées comme les autres : le rechargement dure le temps réglé dans Munitions. La visée, le recul, le balancement et la marche restent ceux du jeu. Pas encore de 3e personne : les autres voient la pose du jeu ou tes animations humanoïdes.

Prise des mains au repos (même onglet) corrige où les mains tiennent ce modèle quand rien ne les anime : position (m) et rotation (°) de chaque main, la gauche depuis la poignée avant.

Dans le JSON, les animations sont sous "fp_anims" (un clip par emplacement), en mètres et degrés :

"view_mode": "rig",
"fp_anims": {
	"reload": {
		"length": 1.8,
		"tracks": {
			"weapon": [{"t": 0, "pos": [0, 0, 0], "rot": [0, 0, 0], "ease": "inout"}, {"t": 0.3, "pos": [-0.02, -0.03, 0.02], "rot": [5, 5, 30], "ease": "inout"}],
			"hand_l": [{"t": 0.45, "pos": [0, -0.18, 0.12], "rot": [0, 0, 0], "ease": "inout"}],
			"fingers_l": [{"t": 0.45, "f": [0.55, 0.35, 0.6, 0.7, 0.6, 0], "ease": "inout"}],
			"part:node:Chargeur": [{"t": 0.4, "pos": [0, 0, 0], "rot": [0, 0, 0], "attach": "hand_l", "ease": "step"}]
		},
		"events": [{"t": 0.3, "type": "sound", "value": "mon_arme/chargeur_out.ogg"}, {"t": 1.1, "type": "ammo", "value": ""}]
	}
}

3e personne

Ce que les autres voient. La pose du jeu (pistolet, fusil d'assaut, fusil à pompe, mêlée, une main ou deux mains générique) sert par défaut. Importe des animations humanoïdes (Mixamo, Unreal, profil humanoïde de Godot, Rigify…) pour la tenue, le tir, le rechargement, la sortie, le coup et le lancer. Le jeu reconnaît les os par leur nom et adapte les mouvements au personnage, même si la pose de repos diffère (T-pose ou A-pose). Seuls les bras, les mains et les doigts sont repris : les jambes continuent de suivre la marche. Avec Main gauche sur la poignée avant, la main gauche reste sur la poignée pour les armes à deux mains.

Réglages

Fichiers d'une arme

mon_arme/
├── addon.json
├── preview.png              miniature du Workshop
├── weapons/
│   ├── weapon.json          réglages de la première arme (WeaponConfig)
│   ├── fusil_2.json         une autre arme du pack
│   ├── mon_arme.glb         modèle (FBX et glTF sont convertis en .glb)
│   ├── viewmodel.glb        viewmodel complet (facultatif)
│   ├── recharge.glb         animations importées
│   └── lunette.png          image de lunette (facultatif)
└── sound/mon_arme/          sons importés

Id de l'arme : addon:<clé de l'addon>/weapons/weapon.json (affiché dans l'onglet Arme de l'éditeur). Chaque fichier JSON de weapons/ est une arme (addon:<clé>/weapons/fusil_2.json…), modifiable dans le même éditeur. Les chemins du JSON sont relatifs à son dossier. Les animations y sont notées "fichier.glb::Clip", avec un nom de fichier vide pour le modèle lui-même.

{
	"name": "Fusil d'assaut", "category": "Armes", "kind": "bullet", "slot": 4,
	"model": "fusil.glb", "muzzle": [0, 0.06, -0.45],
	"fire_modes": ["auto", "semi"], "rpm": 700, "damage": 22, "magazine": 30, "reserve": 120, "ammo_type": "5.56",
	"recoil_up": 0.9, "recoil_pattern": [[0, 1], [0.1, 1.1], [-0.2, 1]],
	"fp_clips": {"fire": "::Fire", "reload": "anims.glb::Reload"},
	"tp_pose": "rifle", "tp_files": ["mixamo_rifle.glb"], "tp_clips": {"reload": "mixamo_rifle.glb::mixamo.com"},
	"sounds": {"fire": "physicore/weapons/rifle_fire.wav", "reload": "mon_arme/recharge.ogg"}
}

En Lua

Pour écrire une arme entièrement en Lua (SWEP, avec SWEP.Base qui peut reprendre une arme de cet éditeur), jeter des armes au sol ou créer des outils de toolgun, voir Armes et outils en Lua.

Hooks

-- Pas de lance-roquettes pendant la trêve, et des munitions à chaque apparition.
local ROQUETTE = "addon:local_mon_lance_roquettes/weapons/weapon.json"

hook.Add("PlayerFireWeapon", "treve", function(ply, id)
	if id == ROQUETTE and GetGlobalBool("treve") then
		ply:ChatPrint("Trêve : pas de roquettes.")
		return false
	end
end)

hook.Add("PlayerSpawn", "munitions", function(ply)
	ply:Give(ROQUETTE)
	ply:GiveAmmo(60, "9mm")
end)

-- Mode « gros calibre » : toutes les armes d'addon font deux fois plus mal.
for _, w in ipairs(weapons.GetList()) do
	weapons.Override(w.id, {damage = weapons.Get(w.id).damage * 2})
end

Pour charger les modèles des armes en avance (écran de préchargement), util.GetModelList() les liste avec type = "weapon". Voir Précharger les modèles.