Distributeurs · Guide FiveM

Script de distributeurs automatiques FiveM pour QBCore, Qbox et ESX

Les distributeurs automatiques sont petits, mais les joueurs s’en servent sans arrêt : une boisson après le service, un snack à l’hôpital, un café dans la salle de pause du bureau. Quand les machines de votre carte sont des props codés en dur avec des articles fixes, chaque changement implique une modification de config et un redémarrage.

Ce guide présente ce qu’on peut attendre d’un script de distributeurs automatiques FiveM sur QBCore, Qbox et ESX, comment Rarx Vending Machines traite chaque point, ce qu’il faut installer et les questions que se posent les propriétaires avant de l’ajouter.

À vérifier avant d’acheter

Ce que doit faire un bon script de distributeurs automatiques FiveM

Servez-vous de ces points pour comparer les ressources de distributeurs, y compris la nôtre.

  1. Des machines placées en jeu par le staff

    Les admins doivent pouvoir créer et placer des machines là où ils se trouvent. Rarx Vending Machines propose un panneau admin et un éditeur de placement avec une légende à l’écran pour déplacer, faire pivoter et valider chaque prop.

  2. Des catalogues par type de machine

    Les catégories boissons, snacks, café et cigarettes remplissent leurs props automatiquement, et une catégorie personnalisée permet de construire une machine à partir de n’importe quel prop interactif du catalogue.

  3. Des prix et un stock optionnel

    Chaque article a son propre prix et, si vous voulez de la rareté, son propre stock. Les groupes, les articles et les emplacements sont enregistrés en base de données : rien n’est perdu au redémarrage.

  4. Des articles remis via votre inventaire

    Les produits doivent être remis et vérifiés par l’inventaire que vous utilisez déjà. Neuf inventaires sont pris en charge, détectés automatiquement ou fixés dans la config.

  5. Accès et logs

    La gestion doit être réservée au staff. Ici, l’accès est contrôlé par des groupes ACE, et des logs webhook enregistrent chaque groupe, article et machine créé, modifié ou supprimé.

  6. Léger pour le client

    Une distance d’affichage et un rayon d’interaction configurables assurent un streaming efficace des props, et l’invite [E] n’apparaît que lorsqu’un joueur est à portée.

Ressources RARX

Le script de distributeurs automatiques RARX

Une seule ressource pour tous les distributeurs de votre carte.

Rarx Vending Machines — ressource FiveM Scripts
Nouveau

Scripts

Rarx Vending Machines

Distributeurs automatiques placés en jeu avec leurs propres produits, prix et stock pour QBCore, Qbox et ESX.

  • QBCore
  • ESX
  • QBox
Gratuit

Rarx Vending Machines

Rarx Vending Machines remplace les props de distributeurs codés en dur par des machines que votre staff place et approvisionne depuis un panneau en jeu. Les machines sont organisées en groupes qui partagent un catalogue et une liste de produits, et tout est stocké en base de données : aucun fichier de config à modifier, aucun redémarrage. Les tables sont créées automatiquement au premier démarrage.

Fonctionnalités clés

  • Géré en jeu. Créez, modifiez et supprimez des groupes de distributeurs et des articles depuis un panneau admin, sans redémarrage.
  • Éditeur de placement. Posez des props dans le monde, déplacez-les, faites-les pivoter et validez-les grâce à une légende à l’écran.
  • Prix et stock. Prix par article et stock optionnel, enregistrés en base de données.
  • Neuf inventaires. Détecte automatiquement votre inventaire ou vous permet de fixer l’un des systèmes compatibles.

Compatibilité

Frameworks, inventaires et dépendances

Tiré des données du produit et de sa documentation. Le framework se définit dans la config ; l’inventaire peut être détecté.

FonctionnalitéRarx Vending Machines
Nom de la ressourcerarx_vmachines
FrameworksQBCore, Qbox, ESX
Configuration du frameworkDéfinissez Config.Core dans config.lua sur 'qb-core', 'qbx_core' ou 'esx'.
Ressources requisesoxmysql, ox_lib, rarx_lib, Un inventaire compatible
Ressources optionnellesAucune
Inventairesrarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory, core_inventory
Base de donnéesToutes les tables rarx_vmachines_* sont créées automatiquement au premier démarrage. Aucun import SQL n’est nécessaire.
LanguesAnglais, Espagnol
DocumentationSur ce site

Préparation

Organiser les distributeurs de votre serveur

Regroupez les machines par lieu, pas seulement par type. Un hôpital, un commissariat et un bureau peuvent chacun avoir leur propre groupe de café avec des produits et des prix différents, et modifier un groupe met à jour toutes ses machines. Gardez des noms d’articles identiques à ceux de votre inventaire, puisque c’est lui qui remet et vérifie les articles.

Utilisez le stock là où la rareté enrichit le roleplay, et laissez-le de côté là où il ne ferait que frustrer les joueurs. Les machines isolées ou situées dans des zones d’événement se prêtent bien à un stock limité ; les boissons et snacks du quotidien dans les zones fréquentées fonctionnent généralement mieux en illimité. Les logs webhook des groupes, des articles et des machines vous montrent qui a changé un prix ou déplacé une machine.

Installation

Comment installer un script de distributeurs automatiques FiveM

Un résumé de l’installation. La documentation couvre les catégories, les permissions et les logs.

Documentation complète
  1. 01

    Téléchargez depuis le Cfx.re Portal

    Téléchargez la ressource et extrayez rarx_vmachines dans votre dossier resources.

  2. 02

    Lancez-le après ses dépendances

    oxmysql, ox_lib et rarx_lib doivent démarrer avant rarx_vmachines. Les tables sont créées au premier démarrage.

  3. 03

    Définissez framework, inventaire et langue

    Réglez le core sur qb-core, qbx_core ou esx, laissez l’inventaire sur auto ou fixez le vôtre, et choisissez la langue avec la convar rarx-lang.

  4. 04

    Donnez l’accès et placez les machines

    Ajoutez votre compte à l’un des groupes admin ou accordez l’ace personnalisée, puis ouvrez le panneau avec /vmadmin.

Si les articles ne sont pas remis aux joueurs, vérifiez que les noms des articles vendus existent dans votre inventaire. Documentation complète: Rarx Vending Machines

Bon à savoir

FAQ sur le script de distributeurs automatiques

Quels frameworks Rarx Vending Machines prend-il en charge ?
QBCore, Qbox et ESX. Réglez le core dans config.lua selon votre serveur.
Quels inventaires sont pris en charge ?
rarx_inventory, ox_inventory, qb-inventory, qs-inventory, ps-inventory, origen_inventory, codem-inventory, tgiann-inventory et core_inventory.
Dois-je importer du SQL ?
Non. Toutes les tables sont créées automatiquement au premier démarrage.
Puis-je limiter le nombre d’articles d’une machine ?
Oui. Le stock est optionnel pour chaque article. Laissez-le désactivé pour des ventes illimitées ou définissez-le pour créer de la rareté.
Puis-je construire une machine avec mes propres props ?
Oui. La catégorie personnalisée part de zéro et permet à un admin de choisir n’importe quel prop interactif du catalogue.
Pourquoi n’y a-t-il pas d’invite [E] devant une machine ?
Le joueur doit se trouver dans le rayon d’interaction. Si le prop lui-même n’est pas visible, augmentez la distance d’affichage et vérifiez le modèle du prop.

Continuez à explorer

Approvisionnez votre ville en quelques minutes

Rarx Vending Machines tourne sur QBCore, Qbox et ESX avec neuf inventaires. Des questions ? Demandez-nous sur Discord.