Créateur de drogue
Le créateur de drogue permet au staff de fabriquer une drogue entière depuis une seule interface : ses objets d’inventaire, ses props, sa chaîne de production à des postes posés dans le monde, ses mini-jeux (jusqu’aux gestes 3D à la souris), sa vente aux PNJ et ses effets à la consommation. Les joueurs, eux, ne voient jamais l’interface : ils récoltent, transforment, vendent et consomment le résultat. Ouverture : F1 › Administration › Créateur › Drogue, ou /createur drogue.
En bref
| Ouvrir (staff) | Créateur › Drogue, /createur drogue ou /createurdrogue |
| Permission | createur.drogue (« Créateur : drogue ») |
| Ressource | loop-createur-drogue (dépend de ox_lib) |
| Côté joueur | E à un poste, « Consommer » dans l’inventaire, vente de rue ou option ALT « Vendre » sur un passant |
| Données | , , , , dans la ressource |
| Limites | 60 drogues, 12 étapes par drogue, 400 postes au total, 10 versions gardées, définition de 96 Ko, image de 4 Mo |
| Voir aussi | Le menu Créateur, Filière de drogue complète, Fiches drogues pour les joueurs |

Pour le staff : créer une drogue
La liste des drogues

Les pastilles d’état en haut de la liste se lisent ainsi :
| Pastille | Signification |
|---|---|
| Vente PNJ : loop-illegal | Les drogues actives sont enregistrées dans la vente de rue de loop-illegal (export RegisterCustomDrug). |
| Vente PNJ : mode secours | loop-illegal est arrêté ou refuse l’enregistrement : le créateur ajoute sa propre option ALT « Vendre » sur les passants. |
| N item(s) : redémarrer ox_inventory | Les items ont été écrits dans et ne seront chargés qu’au prochain redémarrage d’ox_inventory. |
| N item(s) : ensure loop-inventory | loop-createur-item attend loop-inventory pour écrire ses items. |
| N item(s) en échec / N item(s) actifs | Résultat de l’enregistrement des items de chaque drogue active. |
| Greenscreen arrêté | loop-greenscreen ne tourne pas : le bouton « Photographier le prop » ne marchera pas. |

_2, _3...).
loop-createur-drogue, version 1), sans l’historique ni les auteurs. Copier, puis Importer sur l’autre serveur.
Dupliquer avant de modifier une drogue en service
Dupliquer crée une copie inactive nommée « (copie) » avec des noms d’items neufs. Vous pouvez la régler tranquillement, puis désactiver l’ancienne et activer la nouvelle.
L’éditeur en 9 étapes
Modifier ou Nouvelle drogue ouvre l’assistant. La colonne de gauche liste les 9 pages ; un badge rouge donne le nombre d’erreurs d’une page après une vérification, un badge orange les avertissements. En bas : Liste (retour, avec confirmation s’il reste des changements), Vérifier (le serveur contrôle la définition sans rien écrire), Précédent, Suivant, Enregistrer. En haut, les pastilles indiquent la version (ou Brouillon), Active ou Inactive, « Modifications non enregistrées » et le nombre d’erreurs.

sel_de_lune) et les noms des quatre items (sel_de_lune_brut, _traite, _pochon, _brique) se génèrent tout seuls. La pastille orange rappelle que rien n’est encore enregistré.
#rrggbb ou pastilles) et la bascule « Drogue active en jeu ». En dessous, Versions précédentes : chaque sauvegarde garde l’ancienne version (10 au plus) ; Restaurer la remet en place sous un nouveau numéro.
_, 3 à 40), libellé, poids en grammes, prop au sol et en main (œil = aperçu 3D, loupe = catalogue), description et image.L’image d’un item se règle de trois façons :
| Bouton | Ce qui se passe |
|---|---|
| Photographier le prop | Lance le studio loop-greenscreen (/gs_objects <modèle>), attend la photo jusqu’à 2 minutes, la copie dans et l’envoie sur le CDN si possible. |
| Envoyer un fichier | PNG, WEBP ou AVIF de 4 Mo au plus, copié dans puis envoyé sur le CDN. |
| Lien | Une adresse https:// d’image déjà hébergée. |






Les trois mini-jeux possibles :
| Type | Ce que vit le joueur | Réglages |
|---|---|---|
| Barre de progression | Une barre ox_lib de la durée de l’étape, annulable, avec l’animation choisie. |
Durée |
| Réflexe (skill check) | La barre, puis un skill check ox_lib sur la touche E. Facile = 1 zone facile, Moyen = facile + moyenne, Difficile = moyenne, moyenne, difficile, répété autant de fois que de manches (1 à 5). Raté = étape ratée. |
Difficulté, manches |
| Gestes 3D | Une paillasse 3D apparaît au poste et le joueur enchaîne des gestes à la souris. La durée de l’étape est ignorée : chaque geste a sa durée minimale. | Liste de gestes, règles de qualité |


| Geste | Le joueur doit | Réglages (bornes) |
|---|---|---|
| Verser | Amener le récipient au-dessus du bol et l’incliner jusqu’au niveau visé sans déborder. | Durée 2 à 60 s, niveau 20 à 95 %, tolérance 2 à 30 % |
| Touiller | Clic maintenu dans le bol et cercles réguliers. | Durée, tours 1 à 20 |
| Chauffer | Régler la plaque et garder l’aiguille dans la plage en touillant. | Maintien 5 à 60 s, plage de 30 à 195 °C (8 °C d’écart au moins) |
| Couper | Tracer chaque ligne de coupe à la souris en suivant le guide. | Durée, lignes 1 à 8 |
| Écraser / piler | Cliquer quand l’anneau se referme sur le mortier. | Durée, coups 3 à 30 |
| Peser | Clic maintenu pour verser, clic droit pour retirer, puis valider sur la balance. | Durée, poids 1 à 500 g, tolérance 0,1 à 50 g (plus petite que le poids) |
| Ensacher | Glisser une dose dans chaque sachet puis le fermer. | Durée, sachets 1 à 6 |
| Mélanger | Verser le second produit puis touiller dans un sens, puis dans l’autre. | Durée, tours 2 à 20 |
| Filtrer | Garder le débit dans la zone verte jusqu’à la fin. | Temps 3 à 40 s |
Le test des gestes ne donne rien
« Tester sur moi » cache l’interface et lance la scène avec une note calculée en local. À la fin, une bulle donne l’état (réussi, partiel, raté), la qualité et la note de chaque geste. Aucun item n’est donné ni retiré : les produits ne se gagnent qu’à un vrai poste, drogue activée. Retour deux fois abandonne le test.


- Enregistrer la drogue. Les postes s’accrochent aux étapes enregistrées ; s’il reste des changements non enregistrés, ce sont les réglages de la dernière version enregistrée qui s’appliquent.
- Aller sur place. Le poste doit être à 60 m au plus de votre personnage, sinon le serveur répond « Place le poste près de toi (60 m maximum) ».
- Placer un poste. L’interface se cache et un fantôme du prop apparaît. Avec le gizmo (
loop-contextmenuouloop-f1) : flèches à la souris, Entrée pour valider, Retour pour annuler. Sans gizmo, placement simple : visez, molette pour tourner, flèches haut et bas pour monter ou descendre, clic gauche pour valider. - Vérifier. La bulle « Poste enregistré » s’affiche et le poste apparaît chez tous les joueurs proches (si la drogue est active).

loop-illegal (export RegisterCustomDrug) ; en mode secours il est orange. Réglages : item vendu, prix minimum et maximum par unité, paiement (argent propre ou sale), quantité maximum par vente (1 à 50), chance que le PNJ accepte, chance d’alerte police, et « Toutes les zones ».
loop-illegal s’affiche (ici les trois territoires de loop_dev), avec le groupe propriétaire s’il y en a un. Il faut en cocher au moins un.
| Bloc | Réglage | Effet en jeu |
|---|---|---|
| Overdose | Doses (0 = jamais) sur une période (minutes) | Si le joueur atteint ce nombre de doses de cette drogue dans la période : dégâts, vertige 8 s, chute au sol pendant le temps réglé, « Overdose : ton corps lâche ». La vie ne descend jamais sous 101. |
| Dépendance | Points par dose, baisse par heure, seuil de manque, dégâts du manque | Suivie par personnage et sauvegardée. Au-dessus de 70 points : « Tu deviens dépendant à ... ». Toutes les 10 min, si le niveau dépasse le seuil et que la dernière dose date de plus de 30 min : tremblements, vertige, dégâts. |

GetDrugTest et le state bag loopDrogue sont prêts.
Ce que le serveur refuse
La vérification et l’enregistrement passent par le même contrôle serveur. Les messages les plus fréquents :
| Message | Correction |
|---|---|
| « L’item ... existe déjà dans l’inventaire du serveur, choisis un autre nom. » | Un item de même nom existe hors du créateur : renommez l’item. |
| « L’item ... appartient déjà à la drogue ... » | Chaque item n’appartient qu’à une drogue. |
| « Étape N : ... doit être produit par une étape précédente. » | Un ingrédient de la drogue (brut, traité...) n’est produit par aucune étape avant celle-ci : réordonnez. |
| « Étape N : choisis le prop du poste. » | Chaque étape a besoin d’un prop. |
| « Étape N : l’item ... n’existe pas sur le serveur. » | Ingrédient ou outil externe inconnu d’ox_inventory. |
| « ... n’est produit par aucune étape. » | L’item vendu n’est jamais fabriqué. |
| « Choisis au moins une zone de vente ou coche « toutes les zones ». » | Vente limitée sans territoire coché. |
| « L’étape ... a encore des postes placés : supprime-les d’abord. » | Vous retirez une étape qui a des postes. |
| « Le prop ... est introuvable dans le catalogue. » | Simple avertissement : le modèle n’est ni dans le catalogue GTA ni dans les props LOOP. |
Activer et faire apparaître les items
Activer (dans la liste ou la bascule de l’Identité) revérifie la définition puis crée les items. Le créateur essaie, dans l’ordre :
- Via
loop-createur-items’il est démarré : les items y sont enregistrés comme des items du créateur d’items, avec l’action « Consommer », l’animation du geste et le prop en main. - Directement dans
ox_inventory(exportUpsertOxItemJsonEntry) : l’item est actif tout de suite.
Un redémarrage peut être nécessaire
Si la liste affiche « redémarrer ox_inventory », les joueurs ne peuvent pas encore produire : le poste répond « Les items de cette drogue ne sont pas encore actifs sur le serveur ». Demandez le redémarrage à la personne qui gère le serveur (sur loop_dev, il se fait par txAdmin).
Pour les joueurs : produire, vendre, consommer
Les écrans joueurs du créateur de drogue ne passent pas par son interface web : la barre et le skill check sont ceux d’ox_lib, les aides et bulles celles de loop-contextmenu, et les gestes 3D sont dessinés directement dans le monde du jeu. Ils ne peuvent donc pas être capturés hors du jeu ; voici ce qu’ils montrent.
Produire à un poste
- Trouver le poste. Les props des postes d’une drogue active apparaissent à 90 m (ils disparaissent au-delà de 110 m). Ils sont figés et indestructibles.
- S’approcher. À la distance d’interaction de l’étape (2,2 m par défaut), l’aide affiche le nom de la drogue et de l’étape, « Nécessite : 2x Précurseurs chimiques » et l’outil requis, avec E suivi du verbe (Récolter, Traiter, Couper, Conditionner). Impossible en véhicule.
- Appuyer sur E. Le serveur vérifie la distance, les délais, l’outil et les ingrédients. S’il manque quelque chose : « Il te manque des ingrédients (1x ...) », « Outil requis : ... », « Patiente encore N s. » ou « Ce poste se recharge : encore N s. ».
- Jouer le mini-jeu. Barre (annulable), skill check sur E ou scène de gestes 3D : une note s’affiche après chaque geste (vert à partir de 75 %, orange à partir de 40 %) et la qualité finale à la fin.
- Recevoir le résultat. En vert : « Traiter : 1x Cristal bleu brut » (avec « qualité N % » pour les gestes, « rendement réduit » si partiel, « bonus » si parfait). En rouge : « Raté : ... , ingrédients perdus » si l’étape échoue et que la perte est activée. D’autres bulles : « Ton outil s’est cassé », « Inventaire plein : une partie est perdue ».
Une étape peut prévenir la police : alerte 10-66 « Activité suspecte, odeur chimique et allées et venues signalées » à votre position, selon la chance réglée.
Vendre
| Mode | Comment vendre |
|---|---|
loop-illegal démarré (cas normal) |
La drogue rejoint la vente de rue habituelle, avec ses territoires : voir Filière de drogue complète. |
| Mode secours | Menu ALT sur un passant à 4 m au plus, option « Vendre ... » (seulement si vous en avez sur vous). Le passant prend 1 à la quantité maximum, à un prix tiré au hasard entre le minimum et le maximum par unité. |
En mode secours : un passant déjà sollicité refuse pendant 20 minutes (« Cette personne a déjà été sollicitée »), il faut 2,5 s entre deux ventes, un refus le fait fuir, et la vente hors des territoires choisis répond « Personne n’achète ça ici : va dans une zone de vente ». Vente ou refus peuvent déclencher l’alerte 10-66 « Trafic de stupéfiants ». La réussite affiche « Vendu 3x Pochon de cristal bleu pour 720 $ ».
Consommer
Dans l’inventaire, l’item consommable a l’action Consommer. L’inventaire se ferme, le personnage joue le geste (sniffer, fumer, avaler, boire) avec l’objet en main, puis l’effet démarre : filtre d’écran, effet visuel, démarche, secousses, vie, armure, course, endurance. Il s’arrête à la fin de la durée ou si vous tombez. Reprendre la même drogue prolonge l’effet de la moitié de sa durée (jamais plus du double). Il faut 3 s entre deux consommations (« Doucement. »). Voir le tableau Overdose et Dépendance plus haut pour les risques.
Bon fonctionnement
Client et serveur
| Élément | Où | Rôle |
|---|---|---|
| Interface staff | web/ (ui_page), |
Ouverte par l’événement serveur loop-createur-drogue:autorise. Messages NUI : ouvrir (catalogues), fermer, reponse, cacher, montrer, placement, gestesResultat. |
| Appels staff | loop-createur-drogue:rpc → loop-createur-drogue:reponse |
Opérations etat, charger, valider, enregistrer, basculer, dupliquer, supprimer, exporter, importer, restaurer, props, items, territoires, station_ajouter, station_deplacer, station_supprimer, image_capture, image_envoi, image_apercu. Chaque appel revérifie createur.drogue ; 120 ms minimum entre deux appels. |
| Production | , rappels loop-createur-drogue:debut, :fin, :geste, événement :annuler |
Sessions côté serveur : distance (portée de l’étape + 1,5 m), délais, outil, ingrédients au début et à la fin, durée minimale (tolérance 0,9 s), ordre et durée de chaque geste. Un geste hors séquence ou trop rapide annule l’action. |
| Diffusion | loop-createur-drogue:runtime (latent) |
Drogues actives et postes envoyés à tous les clients à chaque changement et à la connexion (:demanderRuntime). |
| Consommation | rappel loop-createur-drogue:consommer, ou loop-createur-item:utilise |
Retrait de l’item, doses, dépendance, détection, puis effet côté client (:effet). Manque envoyé par :manque toutes les 10 min. |
| Vente secours | rappel loop-createur-drogue:vendre, menu ALT (RegisterContextMenuData sur les PNJ) |
Contrôles PNJ (vivant, pas joueur, même instance, 4 m), territoire, prix, paiement, alerte. |
Données enregistrées
| Fichier (dans la ressource) | Contenu |
|---|---|
| Toutes les définitions (items, props, étapes, vente, effets, légalité, auteur et dates). | |
| Les 10 dernières versions de chaque drogue. | |
| Les postes : drogue, étape, position, rotation, auteur, date. | |
| Niveau de dépendance par personnage et par drogue, écrit toutes les 2 min et à l’arrêt de la ressource. | |
| Trace de l’attribution unique de la permission. | |
| Drogue d’exemple ajoutée une seule fois, désactivée. |
Si un fichier est illisible au démarrage, le créateur garde les valeurs par défaut et refuse ensuite d’y écrire, pour ne rien écraser : corrigez le JSON avant toute modification. Les recharges des postes et des joueurs, les doses et les détections ne sont gardées qu’en mémoire (remises à zéro au redémarrage ou à la déconnexion).
Permission et journal
createur.drogue est déclarée dans loop-permissions (section F1 Administration, sous-section Créateur). Au premier démarrage, elle est donnée une seule fois aux rangs qui ont déjà systeme.permissions.gerer ; sur loop_dev, ce sont _dev et superadmin (17/10/2026). Si vous la retirez ensuite dans les permissions, elle n’est pas remise. Chaque action importante est journalisée par loop-framework (catégorie drogue : enregistrement, activation, suppression, postes, production, ventes, consommations).
Dépendances
| Ressource | Sert à |
|---|---|
ox_lib (obligatoire) |
Rappels serveur, barre de progression, skill check. |
ox_inventory |
Items, comptage, retrait et ajout. |
loop-permissions |
Permission. |
loop-createur-item (facultatif) |
Enregistrement des items et action Consommer. |
loop-illegal (facultatif) |
Vente de rue et territoires ; sinon mode secours. |
loop-greenscreen, loop-image |
Photo des props et stockage des images. |
loop-contextmenu |
Aides, bulles, gizmo, menu ALT. |
loop-framework |
Alertes police et journal. |
loop-pausemenu |
Point GPS et barres de temps des gestes. |
Pour les intégrations, le serveur expose GetSaleInfo, GetSaleList, GetCustomDrugs, GetDefinition, IsCustomDrugItem et GetDrugTest.
Problèmes courants
| Symptôme | Cause | Solution |
|---|---|---|
| « Permission requise : Créateur : drogue (createur.drogue) » | Votre rang n’a pas la permission. | La donner dans les permissions du rang. |
| « Le créateur démarre, réessaie dans quelques secondes. » | La ressource vient de démarrer. | Patienter. |
| Les postes n’apparaissent pas en jeu | Drogue inactive, ou vous êtes à plus de 90 m. | Activer la drogue, s’approcher. |
| « Les items de cette drogue ne sont pas encore actifs sur le serveur » | Items écrits dans en attente d’un redémarrage d’ox_inventory. |
Faire redémarrer ox_inventory. |
| « Corrige la définition avant de l’activer. » | La définition ne passe plus la vérification (item supprimé du serveur, prop vide...). | Ouvrir, Vérifier, corriger les pages en rouge. |
| « Pas d’image après 2 minutes : vérifie /gsdiag. » | Le studio loop-greenscreen n’a pas produit la photo. |
Vérifier le greenscreen, ou envoyer un fichier, ou un lien. |
| « Image copiée dans loop-image/items (visible après « ensure loop-image ») » | L’envoi sur le CDN a échoué. | L’image n’apparaîtra qu’après redémarrage de loop-image, ou utilisez un lien https. |
| « Trop loin du poste. » ou « Tu t’es éloigné du poste. » | Le joueur a bougé pendant l’action. | Rester au poste jusqu’à la fin. |
| « Geste terminé trop tôt. » / « Geste hors séquence. » | Protection anti-triche des gestes 3D. | Rejouer normalement. |
| Les joueurs ne peuvent pas vendre | Vente désactivée, item vendu non produit, hors des territoires choisis, ou réglages de la vente de rue. | Vérifier la page Vente et le guide. |
| « Écriture impossible dans data/drogues.json. » | Fichier illisible au démarrage ou disque en lecture seule. | Corriger le fichier sur le serveur puis redémarrer la ressource. |
Commandes, touches et menus
Commandes (1)
| Commande | Aide | Permission |
|---|---|---|
/createur_fermer |
LOOP Docs