- Géré en jeuCréez, modifiez et supprimez des groupes de distributeurs et des articles depuis un panneau admin, sans redémarrage.
- Éditeur de placementPosez des props dans le monde, déplacez-les, faites-les pivoter et validez-les grâce à une légende à l’écran.
- Prix et stockPrix par article et stock optionnel, enregistrés en base de données.
- Neuf inventairesDétecte automatiquement votre inventaire ou vous permet de fixer l’un des systèmes compatibles.
Un script de distributeurs automatiques FiveM géré depuis un panneau admin
Rarx Vending Machines (nom de ressource rarx_vmachines) remplace les props de distributeurs codés en dur par des machines que votre staff place et approvisionne depuis un panneau en jeu. Les groupes, les articles et les emplacements des machines sont stockés en base de données : rien à modifier dans les fichiers de config, aucun redémarrage nécessaire.
Les joueurs s’approchent d’une machine et ne voient l’invite [E] que lorsqu’ils sont à portée, et les produits achetés sont remis et vérifiés via l’inventaire que votre serveur utilise déjà.
Distributeurs de boissons, de snacks, de café et de cigarettes
Les machines sont organisées en groupes qui partagent un catalogue et une liste de produits. Les catégories fixes remplissent leurs props automatiquement, tandis que la catégorie personnalisée part de zéro pour que vous construisiez votre propre machine.
- Boissons : distributeurs de sodas, frigos à boissons et fontaines à eau.
- Snacks : distributeurs de snacks compacts et variantes de textures.
- Café : machines à café et distributeurs de café portables pour les cafés, bureaux et salles de pause.
- Cigarettes : distributeurs de tabac et présentoirs à cigarettes de magasin.
- Personnalisée : choisissez n’importe quel prop interactif du catalogue et garnissez-le comme vous le souhaitez.
Panneau admin en jeu et éditeur de placement
Les admins ouvrent le panneau avec /vmadmin, créent un groupe, choisissent sa catégorie, ajoutent les produits avec un prix et un stock optionnel, puis placent les machines dans le monde. L’éditeur de placement affiche une légende des commandes à l’écran pour déplacer, faire pivoter et valider chaque prop là où vous vous trouvez.
Les changements sont confirmés par des notifications dans le panneau, et chaque groupe, article et machine est enregistré en base de données via oxmysql.
Accès par ACE, logs webhook et réglages de performance
La gestion est réservée à des groupes ACE configurables. Vous pouvez utiliser les groupes intégrés god, admin et superadmin ou accorder votre propre ace personnalisée.
Les logs webhook enregistrent chaque groupe et article créé, modifié ou supprimé, et chaque machine placée, modifiée ou supprimée, avec un canal distinct par event. Une distance d’affichage et un rayon d’interaction configurables assurent un streaming efficace des props.
Tout est inclus
Fonctionnalités
Gestion
- Panneau admin en jeu avec /vmadmin
- Groupes de distributeurs par catégorie
- Catégories boissons, snacks, café, cigarettes et personnalisée
- Éditeur de placement avec déplacement, rotation et validation
- Prix par article et stock optionnel
- Groupes, articles et machines enregistrés en base de données
Serveur
- Détection automatique de l’inventaire ou inventaire fixé
- Accès à la gestion par ACE
- Logs webhook pour neuf events de groupes, d’articles et de machines
- Distance d’affichage et rayon d’interaction configurables
- Tables créées automatiquement
- Traductions anglaise et espagnole incluses
Commandes
| Commande | Ce qu’elle fait | Accès |
|---|---|---|
/vmadmin | Ouvre le panneau admin des distributeurs | Config.AdminGroups ou l’ace personnalisée |
Avant d’installer
Compatibilité
Frameworks
- QBCore
qb-core- Qbox
qbx_core- ESX
es_extended
Définissez Config.Core dans config.lua sur 'qb-core', 'qbx_core' ou 'esx'.
Ressources et base de données
Requises : oxmysql, ox_lib, rarx_lib, Un inventaire compatible
Base de données : Toutes les tables rarx_vmachines_* sont créées automatiquement au premier démarrage. Aucun import SQL n’est nécessaire.
Inventaires
- rarx_inventory
rarx_inventory- ox_inventory
ox_inventory- qb-inventory
qb-inventory- qs-inventory
qs-inventory- ps-inventory
ps-inventory- origen_inventory
origen_inventory- codem-inventory
codem-inventory- tgiann-inventory
tgiann-inventory- core_inventory
core_inventory
Config.InventorySystem = 'auto' le détecte, ou indiquez un inventaire précis.
Intégrations et langues
- Les logs se configurent dans config_server.lua, avec une URL de webhook compatible Discord par event.
- La langue se définit avec la convar rarx-lang.
- Anglais
- Espagnol
Mise en place
Installation
- 01
Téléchargez et extrayez
Téléchargez la ressource depuis votre Cfx.re Portal et extrayez-la dans votre dossier resources.
- 02
Lancez-la 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.
ensure oxmysql ensure ox_lib ensure rarx_lib ensure rarx_vmachines - 03
Définissez le framework et la langue
Réglez Config.Core dans config.lua selon votre framework et choisissez la langue avec la convar rarx-lang.
setr rarx-lang "en" - 04
Donnez l’accès et ouvrez le panneau
Ajoutez votre compte à l’un des Config.AdminGroups ou accordez l’ace personnalisée, puis lancez /vmadmin en jeu.
Ceci est un résumé. La configuration, les exports, les events et le dépannage se trouvent dans la documentation complète.
Bon à savoir
Questions sur Rarx Vending Machines
Votre question n’est pas traitée ici ? Ouvrez un ticket sur notre Discord en indiquant votre framework et l’erreur que vous voyez.
Obtenir de l’aideEn savoir plus sur les scripts de distributeurs automatiques FiveM →Quels frameworks Rarx Vending Machines prend-il en charge ?
QBCore, Qbox et ESX. Réglez Config.Core sur 'qb-core', 'qbx_core' ou 'esx' selon votre serveur.
Que dois-je installer ?
oxmysql, ox_lib, rarx_lib et l’un des inventaires compatibles. Les tables sont créées automatiquement.
/vmadmin ne fait rien. Que dois-je vérifier ?
Votre compte doit figurer dans l’un des Config.AdminGroups, ou vous devez disposer de l’ace personnalisée, par exemple add_ace identifier.xxx vendings.admin allow.
Pourquoi les articles ne sont-ils pas remis aux joueurs ?
Réglez Config.InventorySystem sur votre inventaire ou sur 'auto', et vérifiez que les noms des articles vendus existent dans cet inventaire.
Pourquoi un prop de distributeur est-il invisible, ou pourquoi l’invite [E] n’apparaît-elle pas ?
Augmentez Config.RenderDistance et vérifiez que le modèle du prop est valide. Pour l’invite, placez-vous dans le rayon Config.InteractRadius de la machine.
Puis-je construire un distributeur 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.
Continuez à explorer
Ressources associées
Nouveau-50%