Créateur d’arme
Le créateur d’arme permet au staff de fabriquer une arme moddée à partir d’une arme du serveur : accessoires, teinte, camouflage, nom, description, image et réglages de tir. L’arme créée se distribue ensuite de quatre façons : don direct, vitrine de vente posée dans le monde, caisse vendue en boutique ou recette de craft. Les joueurs, eux, reçoivent une arme normale de leur inventaire qui prend toute seule son apparence et ses réglages quand ils la sortent. Ouverture : F1 › Administration › Créateur › Arme, ou la commande /createurarme.
En bref
| Ouvrir | Créateur › Arme, ou /createurarme (à pied, pas en véhicule) |
| Pour qui | Staff ayant createur.arme.menu ; distribution avec createur.arme.donner |
| Ce que reçoit le joueur | L’arme de base (par exemple weapon_pistol_mk2) avec le nom, la description et l’image de la création |
| Ressource | loop-createur-arme |
| Données | Tables MySQL loop_createur_armes et loop_createur_armes_vitrines |
| Dépendances | oxmysql, ox_inventory, loop-permissions ; facultatif : loop-createur-item (caisses), loop-greenscreen (hébergement des images), screenshot-basic (photo de l’aperçu) |
Ce créateur fait partie du menu Créateur décrit sur la page Créateur.
Pour les joueurs
L’arme que vous recevez
Une arme moddée est une arme ordinaire de votre inventaire (même item, mêmes munitions) qui porte en plus une étiquette invisible de la création. Dans l’inventaire, elle s’affiche avec le nom choisi par le staff, sa description au survol et, si le staff en a mis une, son image.
Au moment où vous la sortez, votre jeu lui pose automatiquement :
- les accessoires de la création (chargeur, lunette, silencieux, lampe, poignée, canon, crosse, finition, camouflage) ;
- la teinte et, sur les armes MK II, la couleur du camouflage ;
- les réglages de tir : dégâts, recul et dispersion des balles.
Les réglages sont remis à zéro dès que vous rangez l’arme ou que vous changez d’arme. Les accessoires sont reposés régulièrement tant que l’arme est en main (toutes les deux secondes environ), et restent visibles des autres joueurs.
Ce qui ne change pas
La cadence de tir, le type de munitions et la portée restent ceux de l’arme de base. Les dégâts ne peuvent être que réduits, jamais augmentés au-delà de l’arme d’origine.
Une arme retirée par le staff
Si le staff supprime une création, votre exemplaire redevient visuellement l’arme de base (accessoires et réglages ne sont plus posés). Une création seulement désactivée garde ses accessoires et ses réglages sur les exemplaires existants. Le nom affiché dans l’inventaire, lui, reste celui inscrit au moment où vous l’avez reçue. De même, si le staff change l’image ou le nom d’une création, seuls les exemplaires donnés ou achetés après coup en profitent.
Acheter à une vitrine
Le staff peut poser une vitrine dans le monde : l’arme moddée flotte, montée avec tous ses accessoires, et tourne lentement sur elle-même quand vous approchez. Elle apparaît à moins de 35 mètres.
- Approchez-vous. À moins de 1,6 mètre et à pied, une aide en bas de l’écran affiche « Acheter » suivi du nom de l’arme et de son prix, ou « rupture de stock ».
- Appuyez sur E. Une seule demande toutes les deux secondes et demie.
- Payez. Le terminal de paiement du serveur s’ouvre (espèces ou carte, 60 secondes pour payer). Une vitrine à 0 $ donne l’arme sans paiement.
- Recevez l’arme. Elle arrive dans votre inventaire, la notification « Vous avez acheté » s’affiche et le stock de la vitrine baisse d’un si elle a un stock limité.
L’achat est refusé avant le paiement si votre inventaire ne peut pas porter l’arme ou si le stock est épuisé. Si la vitrine disparaît ou si la livraison échoue pendant le paiement, le serveur vous rembourse automatiquement (espèces rendues ou carte recréditée) et vous prévient ; s’il n’y arrive pas, la notification « Remboursement à vérifier par le staff » s’affiche et l’échec est inscrit dans le journal. L’argent payé à une vitrine est retiré du joueur sans être versé sur aucun compte.
Ouvrir une caisse d’arme
Le staff peut aussi vendre une arme sous forme d’objet « Caisse : nom de l’arme » dans les boutiques du serveur. La caisse se trouve aussi en loot, en craft ou en don d’item.
- Achetez ou recevez la caisse. Elle pèse 2,5 kg et s’empile.
- Ouvrez-la depuis l’inventaire. L’action s’appelle « Ouvrir la caisse » ; votre personnage la manipule pendant 2,5 secondes (annulable).
- Recevez l’arme moddée. La notification « Vous avez reçu » suivie du nom de l’arme s’affiche.
Si l’arme n’existe plus ou si votre inventaire est plein, la caisse vous est rendue avec un message d’erreur : vous ne perdez rien.
Fabriquer l’arme en craft
Quand le staff active la reconnaissance en craft, une recette de craft LOOP qui fabrique l’arme de base avec exactement le nom de la création donne l’arme moddée complète. Pour vous, rien ne change : vous craftez comme d’habitude.
Pour le staff
Ouvrir le créateur

Le bouton Arme du menu Créateur et la commande /createurarme ouvrent la même interface. La commande vérifie d’abord que votre rang voit la permission createur.arme.menu (sinon « Accès refusé »), puis le serveur la contrôle à nouveau. Descendez de votre véhicule avant : le créateur refuse de s’ouvrir en voiture.
À l’ouverture, une caméra de studio se place 60 mètres au-dessus de vous, dans une boîte gris foncé éclairée, où l’arme en cours d’édition est affichée en 3D. Le HUD et la mini-carte sont masqués, et vos commandes de jeu sont bloquées tant que le créateur est ouvert.

La liste des créations

- Rechercher une création filtre par nom ou par arme de base.
- Nouvelle arme ouvre un brouillon vide sur le Pistolet.
- Importer recrée une arme à partir d’un texte d’export (voir plus bas).
- Cliquer sur une carte la charge dans l’éditeur. Si vous avez des changements non enregistrés, une confirmation vous le rappelle.

La scène
Dans la zone centrale, glissez avec le clic gauche pour faire tourner l’arme et utilisez la molette pour zoomer. Recentrer remet la caméra face à l’arme à la bonne distance. Photographier l’arme prend la photo de l’aperçu pour l’image de la création ; ce bouton reste grisé tant que l’arme n’a jamais été enregistrée. Chaque changement d’accessoire ou de teinte met l’aperçu à jour en une fraction de seconde. Si le modèle de l’arme n’existe pas sur votre jeu, la scène affiche « Modèle de l’arme introuvable sur ce client ».
Onglet Base : l’arme de départ

Changer d’arme de base retire les accessoires déjà choisis (une confirmation le demande), car ils ne sont pas forcément compatibles. La teinte est aussi remise à zéro si la nouvelle arme ne la gère pas.
Onglet Accessoires

- Un seul choix par emplacement, sauf Autres qui en accepte jusqu’à trois. « D’origine » ou « Aucun » retire l’accessoire de l’emplacement.
- Seuls les accessoires que le jeu accepte réellement sur l’arme sont listés. Le nombre d’accessoires choisis apparaît en pastille sur l’onglet ; douze au maximum.
- Les camouflages n’existent que sur les armes MK II (onze motifs, de « Camouflage numérique » à « Patriote »).
Onglet Teinte

Les armes classiques ont 8 teintes (Noir, Vert, Or, Rose, Armée, LSPD, Orange, Platine). Certaines armes n’ont aucune palette : leur couleur vient de leur texture.

La liste des armes sans teinte est fixée dans Config.SansTeintes (pistolet, pistolet de combat, mitraillettes, fusil d’assaut, carabine, fusil à pompe, matraque, armes blanches et objets tenus, entre autres).
Onglet Identité : nom, description, image

| Méthode | Comment | Ce qui est envoyé |
|---|---|---|
| Photographier l’aperçu | Le fond de la scène passe au vert, l’interface se masque, la photo est prise puis détourée automatiquement. | Image carrée de 512 px, à confirmer dans une fenêtre « Utiliser cette image ». Demande screenshot-basic. |
| Envoyer un fichier | PNG, WEBP ou JPEG de 8 Mo au plus. | Recadrée en carré de 512 px, à confirmer. |
| Adresse d’une image en ligne | Lien https vers un fichier png, webp, avif, jpg, jpeg ou gif. | Seuls les hébergeurs fivemanage.com (et ses sous-domaines r2. et cdn.), i.imgur.com, cdn.discordapp.com et media.discordapp.net sont acceptés. |
Les deux premières méthodes envoient l’image au serveur, qui la fait héberger par loop-greenscreen (Fivemanage). Si l’hébergeur ne répond pas en 30 secondes, une image de 350 Ko au plus est gardée en base : elle s’affiche dans le créateur mais l’inventaire garde l’image de l’arme de base. Retirer l’image revient à l’image de l’arme de base.

Onglet Réglages

| Réglage | Plage | Effet |
|---|---|---|
| Dégâts infligés | 50 % à 100 % | Multiplicateur de dégâts de l’arme. Le maximum est le plus petit entre la config (100 %) et le plafond damage_modifier lu dans la config de LoopProtect (1,0 sur loop_dev) : au-delà, l’anticheat bannit. |
| Recul | 40 % à 200 % | Secousse de la caméra au tir. |
| Dispersion des balles | 75 % à 150 % | Plus bas, plus précis. |
Si votre jeu ne dispose pas de la fonction correspondante, le curseur est grisé avec la mention « non disponible sur ce client ». Le serveur arrondit et borne de toute façon chaque valeur à l’enregistrement.
Onglet Distribution

- Arme active : désactivée, l’arme ne peut plus être donnée, vendue ni craftée et ses vitrines disparaissent du monde ; les exemplaires déjà distribués gardent leurs accessoires et leurs réglages.
- Reconnaissance en craft : un encart vous donne le code de l’arme de base et le nom exact à utiliser. Dans Crafts, ajoutez à une table de craft l’objet de base avec ce nom affiché : le joueur qui le fabrique reçoit l’arme moddée. La comparaison du nom ignore les majuscules et les espaces autour.
- Donner à un joueur : son ID serveur et une quantité de 1 à 10. Le don s’arrête dès que l’inventaire du joueur est plein ; le joueur reçoit une notification. Les boutons Donner et Placer une vitrine restent grisés tant que des modifications ne sont pas enregistrées.
- Vitrine de vente : prix de 0 à 10 000 000 $ (0 = gratuit) et stock (vide = illimité). Placer une vitrine devant moi la pose à 90 cm devant vous, orientée comme vous. GPS place un point sur la vitrine, Retirer la supprime définitivement.

caisse_arme_7, son prix et ses boutiques.Le bloc caisse n’apparaît que si loop-createur-item est démarré : la caisse est un vrai item créé par le créateur d’item, nommé caisse_arme_ suivi du numéro de la création, rareté Rare, catégorie Autre, avec l’image de la création (ou celle de l’arme de base). Chaque modification enregistrée de l’arme met la caisse à jour ; supprimer l’arme supprime aussi la caisse. Les boutiques proposées sont celles de la table volta_shops marquées actives.


Enregistrer, dupliquer, exporter, supprimer

- Enregistrer envoie la création au serveur, qui la vérifie entièrement (arme de base connue, accessoires compatibles, teintes, limites, adresse d’image). Sans nom, l’éditeur bascule sur l’onglet Identité et le demande.
- Dupliquer crée une copie nommée « (copie) », sans sa caisse.
- Exporter affiche un texte à copier ; Importer (dans la liste) le recrée comme nouvelle création, ici ou sur un autre serveur équipé du créateur.
- Supprimer retire la création, désactive ses vitrines et supprime sa caisse.
- Échap ferme d’abord une fenêtre ouverte, puis le créateur (avec confirmation s’il reste des changements).


loop-createur-arme contient l’arme de base, le nom, la description, les accessoires, la teinte, la couleur du camouflage, les réglages, le craft et l’adresse d’image. Copier le place dans le presse-papiers.


Permissions
| Permission | Libellé | Ce qu’elle ouvre |
|---|---|---|
createur.arme.menu |
Créateur d’arme : créer et modifier | Ouvrir le créateur (F1 et /createurarme), créer, modifier, dupliquer, supprimer, exporter, importer, photographier, et lancer /createurarme_recharger. |
createur.arme.donner |
Créateur d’arme : donner et mettre en vente | Donner une arme à un joueur, placer ou retirer une vitrine, créer, mettre à jour ou retirer une caisse en boutique. |
Commandes
| Commande | Côté | Effet |
|---|---|---|
/createurarme |
Client | Ouvre le créateur (nom réglé par Config.Commande). |
/createurarme_recharger |
Serveur | Relit le plafond de dégâts de l’anticheat, reconstruit le catalogue des armes, réinstalle la reconnaissance en craft et republie les créations et vitrines. Depuis la console, ou en jeu avec createur.arme.menu et le droit ACE de la commande (elle est déclarée restreinte). |
Réglages de la ressource
| Réglage | Valeur sur loop_dev | Rôle |
|---|---|---|
Config.Limites.Creations |
500 | Nombre maximum de créations. |
Config.Limites.Composants |
12 | Accessoires par arme. |
Config.Limites.DonQuantite |
10 | Exemplaires par don. |
Config.Limites.ActionsParMinute |
90 | Actions d’un même membre du staff par minute (au-delà : « Trop d’actions, patientez un instant »). |
Config.Stats |
voir Réglages | Bornes et pas des trois curseurs. |
Config.HotesImages |
6 hôtes | Hébergeurs d’images acceptés. |
Config.Vitrines |
actives, 35 m, 1,6 m, touche E, 10 000 000 $ max, 60 s de paiement | Comportement des vitrines ( les retire toutes et masque le bloc). |
Config.ReconnaissanceCraft |
true |
Active la reconnaissance en craft. |
Config.ArmesExclues, Config.CategoriesExclues |
menottes, sacs, mallettes, parachute, extincteur... | Armes absentes de l’onglet Base. |
Config.SansTeintes, Config.Teintes, Config.Camouflages |
listes | Teintes et camouflages proposés. |
Pour les autres ressources
Journal
Chaque action est inscrite dans le journal du serveur (logEvent de loop-framework, catégorie createur_arme) : création, modification, duplication, suppression, import, image, don, vitrine posée ou retirée, achat en vitrine, échec d’achat avec l’état du remboursement, caisse créée, ouverte ou retirée.
Bon fonctionnement
Le catalogue des armes
Où sont les données
| Donnée | Emplacement |
|---|---|
| Créations | Table loop_createur_armes : la création en JSON (donnees), l’image gardée en base si besoin (image_locale), la version, l’auteur, les dates. Une suppression ne fait que cocher . |
| Vitrines | Table loop_createur_armes_vitrines : arme, position et orientation, prix, stock (-1 = illimité), active, auteur. Retirer une vitrine efface la ligne. |
| Caisses | Items du créateur d’item (caisse_arme_N), la référence est gardée dans la création. |
| Exemplaires des joueurs | Métadonnées de l’arme dans ox_inventory : label, description, imageurl et . |
Les deux tables sont créées automatiquement au premier démarrage.
Comment l’arme prend son apparence
Le serveur publie à tous les joueurs, dans l’état global loopCreateurArmes, une fiche courte par création active : arme de base, accessoires, teinte, couleur du camouflage, dégâts, recul, dispersion et version. Quand un joueur sort une arme (événement ox_inventory:currentWeapon), son jeu lit l’identifiant loopArme de l’exemplaire, retrouve la fiche et pose accessoires, teinte et réglages. Les réglages sont réappliqués toutes les demi-secondes et restaurés à leur valeur d’origine quand l’arme est rangée ou que la ressource s’arrête. Si une création est enregistrée pendant qu’un joueur la tient, sa version change et l’arme est remise à jour en direct. Côté joueur, les dégâts sont en plus plafonnés à 100 % de la valeur actuelle du jeu.
Les vitrines sont publiées dans loopCreateurArmesVitrines ; chaque jeu crée l’objet de l’arme moddée à moins de 35 mètres et le supprime au-delà.
La reconnaissance en craft passe par un crochet createItem d’ox_inventory, limité aux armes de base concernées : quand un objet de ce type est créé avec un nom affiché qui correspond à une création active marquée Craft, le crochet lui ajoute l’étiquette de la création.
Sécurités
- Toutes les actions passent par le serveur, qui contrôle la permission à chaque fois et revalide la création complète ; l’interface n’est jamais crue sur parole.
- Limite de 90 actions par minute et par membre du staff, et 150 ms minimum entre deux clics côté jeu.
- Une seule tentative d’achat à la fois par joueur, distance contrôlée par le serveur, stock et arme revérifiés après le paiement.
- Textes nettoyés (caractères de contrôle, chevrons, tilde, barre oblique inverse et accent grave retirés), images limitées à 1,2 Mo à l’envoi.
- L’ouverture d’une caisse n’est acceptée que si elle vient de
loop-createur-item.
Ce qui casse si...
ox_inventoryest arrêté : le catalogue est vide (onglet Base sans arme, enregistrements refusés avec « Arme de base inconnue »), plus de don ni de vente.- La base est indisponible au démarrage : « Créateur en cours de chargement, réessayez » à chaque action.
loop-permissionsest arrêté : plus personne ne peut ouvrir le créateur, sauf la console.loop-createur-itemest arrêté : le bloc caisse disparaît et les caisses déjà vendues ne s’ouvrent plus.loop-greenscreenest arrêté : les images envoyées restent en base (350 Ko au plus) et ne s’affichent pas dans l’inventaire.screenshot-basicest arrêté : la photo de l’aperçu est impossible, l’envoi de fichier reste possible.
Problèmes courants
| Symptôme | Cause | Solution |
|---|---|---|
| Le bouton Arme est absent du menu Créateur | Ressource loop-createur-arme arrêtée |
Démarrez la ressource. |
| Le bouton Arme est grisé | Permission createur.arme.menu absente |
Donnez-la au rang dans le menu Permissions. |
« Accès refusé » avec /createurarme |
Permission createur.arme.menu absente |
Donnez-la au rang dans le menu Permissions. |
| Rien ne s’ouvre | Vous êtes en véhicule ou le menu pause est ouvert | Descendez du véhicule et réessayez. |
| « Catalogue des armes indisponible » | Le catalogue n’est pas arrivé dans les 8 secondes après la demande d’ouverture | Réessayez ; si l’onglet Base reste vide, vérifiez ox_inventory puis lancez /createurarme_recharger. |
| Une nouvelle arme ajoutée au serveur n’est pas dans l’onglet Base | Catalogue construit avant son ajout | /createurarme_recharger. |
| « Composant inconnu » ou « Arme de base inconnue » à l’enregistrement ou à l’import | L’arme ou l’accessoire n’existe pas dans le catalogue de ce serveur | Choisissez une autre arme ou retirez l’accessoire. |
| Le curseur des dégâts ne dépasse pas 100 % | Plafond de l’anticheat (damage_modifier) |
Normal : on ne peut que réduire les dégâts. |
| L’image ne change pas dans l’inventaire des joueurs | Les exemplaires gardent l’image reçue au don ou à l’achat | Donnez de nouveaux exemplaires ; vérifiez aussi que l’image a bien été hébergée (message « Image hébergée »). |
| « Adresse d’image refusée » | Lien non https, extension non image ou hébergeur non autorisé | Hébergez l’image sur Fivemanage, Imgur ou Discord, ou envoyez le fichier. |
| Le bloc caisse n’apparaît pas | loop-createur-item arrêté ou permission createur.arme.donner absente |
Démarrez la ressource ou donnez la permission. |
| Un joueur dit avoir payé sans recevoir l’arme | Échec de livraison avec remboursement impossible | Cherchez « vitrine_echec » dans le journal : la ligne indique « À VÉRIFIER » quand il faut rembourser à la main. |
| L’arme d’un joueur a perdu ses accessoires | Création supprimée | Recréez l’arme (ou importez son export) et donnez un nouvel exemplaire : l’ancien porte l’identifiant de la création supprimée. |
Commandes, touches et menus
Commandes (1)
| Commande | Aide | Permission |
|---|---|---|
/createurarme_recharger |
LOOP Docs