LOOP Docs
Menu F1GuidesItems
Accueil/Systèmes/Port automatique

Port automatique

Le port automatique fait apparaître un objet dans la main d’un personnage selon ce qu’il transporte : une mallette quand il a beaucoup d’argent liquide sur lui, un petit sac quand il porte beaucoup de drogue. Les joueurs n’ont rien à faire, l’objet vient et repart avec l’inventaire, et tout le monde autour le voit. Le staff crée et règle ces règles dans un atelier ouvert par F1 › Administration › Créateur › Port automatique ou par /portauto.

En bref

Joueurs Automatique, rien à ouvrir
Règles livrées Mallette : argent liquide (money) ≥ 20 000, priorité 20. Petit sac : toutes les drogues ≥ 40, priorité 10
Staff F1 › Administration › Créateur › Port automatique, ou /portauto
Permission portauto.gerer
Données (30 règles au plus)
Ressource loop-port-auto (utilise ox_inventory, loop-permissions, loop-framework)

Pour les joueurs

Ce que vous voyez

Dès que le total des objets comptés par une règle atteint son minimum, votre personnage prend l’objet de la règle en main et joue l’animation de port (par exemple bras le long du corps pour une mallette). Vous pouvez marcher et courir normalement : l’animation ne touche que le haut du corps. Quand vous repassez sous le minimum (vous déposez l’argent, vous vendez la drogue), l’objet et l’animation disparaissent.

  • Mallette : avec au moins 20 000 $ en liquide sur vous. Seul l’argent en poche compte (l’objet money), pas le compte en banque.
  • Petit sac : avec au moins 40 unités de drogue, toutes drogues additionnées (plus d’une centaine d’objets : pochons, briques, sachets, comprimés…).
  • Une seule à la fois : si vous remplissez les deux, c’est la règle de priorité la plus haute qui l’emporte (la mallette, priorité 20, passe avant le petit sac, priorité 10).

C’est visible par les autres joueurs

L’objet est vu par les joueurs autour de vous (jusqu’à 80 m environ). Une mallette en main signale donc à tout le monde que vous transportez beaucoup de liquide : c’est voulu pour le jeu de rôle.

Quand l’objet disparaît de lui-même

L’objet est rangé automatiquement, puis revient tout seul quand la situation redevient normale, si votre personnage :

  • est mort, inconscient, menotté, ou porté par quelqu’un ;
  • est dans un véhicule ou en train d’y monter ;
  • a une arme en main ;
  • nage, tombe, saute en parachute, escalade ;
  • joue une émote ou un scénario, est à couvert, porte quelqu’un ;
  • a l’inventaire ouvert, le téléphone sorti (appareil photo, appel, accueil), la tablette ouverte, un mini-jeu en cours, ou une autre activité qui occupe les mains (carburant, cambriolage, échelle, fauteuil roulant…).

Quand l’objet est rangé chez vous pour une de ces raisons, il est aussi masqué chez les autres joueurs.

L’animation s’interrompt parfois

Si une autre action coupe l’animation de port, le script attend un peu avant de la relancer (2,5 secondes, puis de plus en plus longtemps jusqu’à 30 secondes si elle est coupée en boucle). C’est normal.

Pour le staff

Ouvrir l’atelier

Menu Créateur
Créateur : l’entrée « Port automatique » demande portauto.gerer et la ressource démarrée · toutes les entrées de ce menu
  1. Ouvrir. F1 › Administration › Créateur › Port automatique, ou tapez /portauto. Le serveur vérifie la permission avant d’ouvrir.
  2. Lire la liste. Les règles s’affichent par priorité, avec votre propre état en haut.
  3. Créer ou modifier. Nouvelle règle ou le crayon d’une règle ouvre l’éditeur.
  4. Enregistrer. La règle est vérifiée par le serveur, enregistrée, et appliquée tout de suite à tous les joueurs connectés.

La liste des règles

Liste des règles du port automatique
Liste des règles : en haut, le nombre de règles, de règles actives et de joueurs équipés en ce moment. L’encart « Toi, en ce moment » montre ce que vous tenez et, pour chaque règle active, votre total face au minimum avec une jauge (vert quand le minimum est atteint). Chaque règle affiche son interrupteur, son nom, sa condition (« money ≥ 20000 »), son prop et son modèle, la main, l’animation, la priorité, le nombre de joueurs qui l’ont en main, et les boutons Modifier et Supprimer. Le pied rappelle la règle : une seule à la fois, la priorité la plus haute remplie gagne.
Règle désactivée
Désactiver une règle : l’interrupteur à gauche d’une règle l’active ou la désactive aussitôt (notification « Règle désactivée. »). Une règle désactivée est grisée, n’équipe plus personne et disparaît de votre encart.
Confirmation de suppression d’une règle
Supprimer : la corbeille demande confirmation. Les joueurs qui tenaient cet objet le perdent tout de suite.
Atelier sans aucune règle
Aucune règle : si toutes les règles ont été supprimées, l’atelier propose d’en créer une. Le bouton Exemples (en haut) remet Mallette et Petit sac s’ils manquent, sans toucher aux autres règles.

L’éditeur de règle

Éditeur de la règle Mallette, haut
Éditeur, partie haute : Règle (nom, 40 caractères au plus ; priorité de −1 000 à 1 000 ; active oui ou non), Déclencheur (items comptés, groupe « Toutes les drogues », quantité minimum), début de Objet en main. En tête, l’état de la règle et son identifiant.

Déclencheur. Les quantités de tous les items choisis sont additionnées, puis comparées à la quantité minimum (de 1 à 100 000 000). Ajoutez des items en tapant leur nom ou leur libellé : la liste propose les items de l’inventaire, ↑ / ↓ pour choisir, Entrée pour ajouter, la croix d’un jeton pour le retirer (40 items par règle au plus). L’interrupteur « Toutes les drogues » ajoute d’un coup toute la famille des drogues, et Voir en affiche la liste.

Suggestions d’items pendant la saisie
Ajouter un item : en tapant « black », l’atelier propose les items dont le nom technique ou le libellé contient ce mot, avec le nom technique à droite. Le rappel sous la case précise que l’argent liquide est l’item money et l’argent sale black_money.
Liste des items du groupe Toutes les drogues
Toutes les drogues : le bouton Voir ouvre la liste complète du groupe, libellé à gauche, nom technique à droite. Le groupe regroupe les drogues déclarées dans ox_inventory, une liste fixe de briques et paquets, et les produits du créateur de drogue (produit traité, pochon, brique), sans la matière brute.

Objet en main. Choisissez un prop dans la liste (mallette noire, mallette de sécurité, attaché-case, mallette à billets, petit sac de courses, sac du casino, petit sac en papier, sac à main, valise, sac de sport) : la main, la position, la rotation et l’animation conseillées pour ce prop sont reprises automatiquement. Choisissez Autre modèle… pour taper n’importe quel nom de modèle, puis Vérifier. La main se choisit parmi Main droite (57005), Main gauche (18905), Main droite prise (28422), Main gauche prise (60309).

Saisie d’un autre modèle de prop
Autre modèle : le modèle est cherché dans la liste des objets de GTA, puis dans les props LOOP, puis dans votre propre jeu. Message vert « Modèle GTA trouvé » ou « Prop LOOP trouvé » ; orange si le modèle n’est présent que dans votre jeu (prop ajouté), ce qui est accepté ; rouge s’il est introuvable.
Éditeur de la règle Mallette, bas
Éditeur, partie basse : Réglage dans la main avec la position X, Y, Z (en mètres, de −1 à 1) et la rotation X, Y, Z (en degrés, de −360 à 360). Chaque axe a un curseur, des boutons − / + et une case. Les boutons Fin, Normal, Gros choisissent le pas (0,002 / 0,01 / 0,05 m et 1 / 5 / 15°). La molette sur une ligne ajuste aussi la valeur. « Réglage conseillé du prop » remet les valeurs d’origine d’un prop de la liste. Puis Animation de port.

Animation de port. Au choix : Aucune (objet seul), Bras le long du corps (mallette, sac), Tenir devant soi, Porter un sac lourd, Porter à deux mains (carton, caisse), ou Personnalisée….

Animation personnalisée vérifiée
Animation personnalisée : saisissez le dictionnaire et le clip, choisissez le mode (49 : boucle, haut du corps ; 51 : boucle figée, haut du corps ; aucun autre n’est accepté pour que le personnage puisse marcher), puis Vérifier l’animation. Vert : déjà utilisée par les émotes du serveur ; orange : absente des émotes mais jouable dans votre jeu, acceptée ; rouge : introuvable.

Essayer sur soi avant d’enregistrer

Aperçu actif sur le personnage
Aperçu sur moi : le bouton du pied met l’objet et l’animation sur votre personnage sans rien enregistrer. Une caméra se place sur la main (vue Main), sur tout le corps (Corps) ou revient à la caméra du jeu (Jeu). Dans la partie droite de l’écran, glissez pour tourner autour du personnage et utilisez la molette pour zoomer. Chaque réglage modifié est montré aussitôt. Cette image est rendue hors du jeu : en jeu, la partie droite montre votre personnage filmé par la caméra.

Enregistrer et corriger

Nouvelle règle vierge
Nouvelle règle : elle part du premier prop de la liste (mallette noire, main droite), active, priorité 0, minimum 1, sans item.
Erreurs renvoyées à l’enregistrement
À corriger avant d’enregistrer : le serveur renvoie la liste de ce qui ne va pas, affichée en haut de l’éditeur. Ici une règle sans nom et sans aucun item ni groupe.

Messages possibles : nom obligatoire ou trop long, priorité hors limites, item au nom invalide ou inconnu d’ox_inventory, trop d’items, aucun item ni groupe, quantité minimum hors limites, modèle obligatoire ou introuvable, main absente de la liste, position ou rotation hors limites, animation inconnue ou introuvable, mode d’animation non autorisé, « Maximum 30 règles ». Si vous quittez l’éditeur (Retour, Annuler, Échap, la croix) avec des changements, une fenêtre demande de confirmer l’abandon.

Permission, commande et journal

  • /portauto : ouvre l’atelier. Tapée dans la console du serveur, elle affiche le nombre de règles et de joueurs équipés.
  • /portauto_fermer : ferme l’atelier de force si l’interface reste bloquée.
  • Journal (catégorie port_auto) : règle créée, modifiée, activée, désactivée, supprimée, exemples remis, avec l’auteur et le résumé de la règle.

Effet immédiat sur tout le serveur

Chaque enregistrement est appliqué à tous les joueurs connectés dans la foulée. Une règle avec un minimum trop bas (par exemple money ≥ 1) mettrait un objet dans la main de presque tout le monde.

Bon fonctionnement

Calcul côté serveur. Le serveur lit l’inventaire ox_inventory de chaque joueur, additionne pour chaque règle active les quantités de ses items, puis prend la première règle remplie dans l’ordre des priorités (à priorité égale, l’ordre de la liste). Le recalcul a lieu 600 ms après chaque changement d’inventaire signalé par le client, 2,5 secondes après la connexion d’un personnage, après chaque modification de règle, et de toute façon toutes les 15 secondes pour tous les joueurs. La liste des drogues est reconstruite toutes les 20 passes (environ 5 minutes) et quand ox_inventory, loop-createur-drogue ou loop-createur-item redémarrent.

Diffusion aux autres joueurs. Le résultat est posé dans l’état réseau du joueur (loopPortAuto : modèle, os, position, rotation, animation). Chaque client crée alors l’objet sur les joueurs proches : affiché jusqu’à 80 m, retiré au-delà de 90 m, 48 objets au plus en même temps. Le client du porteur publie aussi loopPortAutoMasque quand il range l’objet pour une raison locale (inventaire, téléphone…), pour que les autres le masquent aussi.

Sécurités. Toutes les actions passent par un seul événement serveur vérifié (loop-port-auto:rpc) : permission à chaque appel, 120 ms minimum entre deux requêtes, 90 modifications par minute au plus, règle entièrement revalidée par le serveur avant d’être enregistrée. Seuls les modes d’animation 49 et 51 (haut du corps) sont acceptés.

Problèmes courants

Symptôme Cause Solution
Un joueur a 20 000 $ mais pas de mallette Argent sur le compte en banque, pas en liquide ; ou une raison de masquage (véhicule, arme en main, émote…) Seul l’item money compte ; vérifier la situation du personnage.
Il tient le petit sac alors qu’il a aussi la somme pour la mallette La règle Mallette est désactivée ou sa priorité a été baissée sous celle du petit sac Vérifier l’interrupteur et les priorités dans la liste.
« Permission requise : Port automatique : gérer les règles (portauto.gerer) » Permission absente L’ajouter au rang dans F1 › Permissions.
« Le port automatique démarre, réessaie dans quelques secondes. » La ressource attend encore ox_inventory au démarrage Patienter.
« Modèle … introuvable » Nom de modèle inconnu du serveur et absent de votre jeu Vérifier l’orthographe, ou que le prop est bien diffusé par le serveur.
« Item … inconnu d’ox_inventory » Nom technique erroné Choisir l’item dans les suggestions.
« Trop de requêtes, réessaie. » ou « Trop de modifications en une minute. » Limite anti-abus atteinte Attendre quelques secondes.
Les règles sont revenues aux exemples illisible au démarrage Récupérer le contenu dans .
L’interface reste à l’écran Blocage de l’interface /portauto_fermer.

Commandes, touches et menus

Commandes (1)

CommandeAidePermission
/portauto_fermer
LOOP Studios · documentation générée depuis le serveur loop_dev le 22/10/2026 · accueil · Raccourci : Ctrl K