Shops

Système de magasins pour l'inventaire standard et ox_inventory : magasins avec panier, armureries, marché noir tournant, offres du jour, vendeurs PNJ et un éditeur de magasins en jeu.

Fonctionnalités

• Trois types de magasins : magasin avec panier, armurerie et marché noir. Le paiement se fait par carte ou en liquide, au marché noir avec de l'argent sale.
• Le serveur vérifie les prix, le total, le poids et la distance. Stock uniquement pour les magasins achetés. Règles par type de magasin, magasin ou objet.
• Magasins à vendre : les joueurs achètent un magasin, fixent les prix, vont chercher la marchandise chez le grossiste et gèrent la caisse.
• Marché noir tournant avec emplacements, assortiment et prix changeants, plus des offres du jour dans les magasins normaux.
• Éditeur de magasins en jeu avec modèle de PNJ, scénario, marqueur avec aperçu en direct et blip personnalisé.
• Logs Discord par achat et statistiques en direct sur Discord.

Installation

1. Place le dossier off_shops dans ton dossier resources.
2. Tous les objets de config/settings/config.items.lua doivent exister dans ton inventaire – ESX : table items, ox_inventory : ox_inventory/data/items.lua. Les armes (weapon_…) n'ont pas besoin d'entrée avec ESX.
3. Dans le server.cfg – après ESX, oxmysql et ton inventaire :

ensure oxmysql
ensure es_extended
ensure ox_inventory
ensure off_shops

Les tables sont créées automatiquement et complétées lors des mises à jour.

Configuration

config/settings/config.lua

Règles (rules) par type de magasin, magasin ou objet : jobs, blockedJobs, minGrade et hours = { from, to } (heure en jeu, 22–5 = 22:00–04:59).

config/settings/config.locations.lua – Emplacements

{ type = 'normal', label = 'LTD Davis', interactionType = 'ped', position = vec4(-47.02, -1758.23, 29.42, 45.05), categories = { 'food', 'drinks', 'tools' } },
{ type = 'blackmarket', interactionType = 'ped', position = vec4(14.2280, -1104.0475, 29.7970, 340.0), categories = { 'weapons', 'illegal' } },

Les emplacements avec type = 'blackmarket' sont des lieux possibles pour le marché noir – activeLocations d'entre eux sont actifs en même temps.

Catégories et objets

food = { label = 'Essen', items = { 'bread', 'kebab', 'wrap' } }, -- catégorie
{ name = 'water', label = 'Wasser', price = 10 },                  -- objet

• Optionnel par objet : max (quantité max propre), image (image propre), rules (règles propres).
• weapon_… est traité comme une arme : achetable à l'unité, avec 42 balles dans l'inventaire ESX, pas en double.
• Images : ESX charge web/dist/assets/items/<name>.png, ox_inventory utilise les siennes. Place les images d'armes manquantes dans web/dist/assets/weapons/<name>.png.

config/functions.lua

Logs Discord

Tu inscris les webhooks dans config/settings/config.server.lua (côté serveur uniquement) : purchases enregistre chaque achat, stats correspond aux statistiques en direct. Une url vide ('') désactive le log.

Langues

Tous les textes se trouvent dans config/locales/<langue>.json. Pour ta propre langue, copie un fichier, traduis-le et définis locale – laisse les placeholders comme %s et {total} en place.

En jeu

Appuie sur E au vendeur ou au marqueur (ou utilise ox_target), choisis les articles et paie. Au magasin, il y a un panier, à l'armurerie et au marché noir, tu choisis un seul article.

Éditeur de magasins (/shopeditor)

• À gauche se trouvent tous les magasins de l'éditeur. Les magasins de la config n'y figurent pas, tu les modifies dans config/settings/config.locations.lua.
• Nouveau crée un magasin à ta position actuelle, Modifier ouvre un magasin existant.
• Tu peux régler le type, le nom, les catégories, PNJ ou marqueur, la position avec orientation et le blip.
• PNJ : Choisis un modèle dans une liste d'images de tous les peds GTA (recherche et catégories), plus scénario et orientation, le tout avec aperçu en direct en jeu. Tu choisis un ped addon via son nom de modèle exact dans la recherche. Par défaut = vendeur de shopTypes.
• Marqueur : Type, taille, distance au sol, rotation, couleur, opacité et mouvement avec aperçu en direct en jeu.
• Blip : activé ou non, en option avec une icône et une couleur propres. Sinon, le blip de shopTypes s'applique.
• Tant que l'éditeur est ouvert, tu te déplaces avec WASD et regardes autour de toi en maintenant le clic droit. Ensuite, appuie sur Prendre la position.
• Après Enregistrer, la modification s'applique immédiatement à tous les joueurs. Un marché noir créé dans l'éditeur reste fixe et vend tous les articles de ses catégories.

Magasins à vendre

Le fait qu'un magasin soit à vendre se règle avec price dans config.locations.lua pour les magasins de la config, et dans l'éditeur pour les magasins de l'éditeur (groupe Propriété : À vendre, Prix d'achat). Le marché noir n'est jamais à vendre. Les magasins sans propriétaire vendent comme avant, sans stock.

En jeu : Dans un magasin à vendre, E ouvre d'abord un choix entre Acheter et Gestion, avec une caméra sur le vendeur s'il y a un PNJ. Si le magasin appartient à quelqu'un d'autre, la boutique s'ouvre directement. Sans propriétaire, Gestion mène à l'offre, en tant que propriétaire à la gestion avec Aperçu (caisse, CA du jour/7 jours/total, graphique, articles presque épuisés), Stock, Prix, Commande et Caisse (retrait/dépôt en liquide ou sur le compte, historique, vente du magasin). Les clients paient dans la caisse et n'achètent que ce qui est en stock.

Livraison : Choisis la marchandise, le coût est payé par la caisse. Tu es téléporté au point vanSpawn et placé dans la camionnette – va chez le grossiste, E dans le marqueur (charger), reviens et gare la camionnette dans le marqueur, puis va voir le vendeur et appuie sur E. C'est seulement là que la marchandise entre en stock. Si la camionnette est détruite, si le temps est écoulé ou si tu quittes le serveur, la marchandise est perdue (remboursement selon refundPercent). Après un redémarrage du serveur, une livraison ouverte est entièrement remboursée.

Log Discord : webhook ownership dans config/settings/config.server.lua (achat, vente, livraisons, retraits/dépôts). Libérer dans l'éditeur rend un magasin à nouveau libre (stock et caisse perdus).

Problèmes fréquents