Boutique en coins, VIP et Tebex
La boutique premium du serveur. On y dépense des coins, une monnaie achetée sur Tebex ou offerte par le staff, contre un grade VIP, des skins d’armes, des véhicules, des packs et des boosts. Elle contient aussi le passe de combat et une récompense du jour. Les joueurs l’ouvrent avec /boutique. Le staff règle tout, catalogue, grades VIP, liaison Tebex et armes permanentes, depuis un seul panneau : /boutiqueadmin. Rien ne demande de redémarrage.
En bref
| Ouvrir | /boutique, Échap pour fermer |
| Mon solde et mon code | /coins |
| Mon grade VIP | /monvip, ou F1 › Services et avantages › VIP › Mes avantages |
| Monnaie | coins, par personnage |
| Obtenir des coins | Tebex (bouton Acheter des coins), cadeau du staff |
| Staff | /boutiqueadmin (catalogue, grades VIP, Tebex, armes permanentes), /boutiquestaff (fiches joueurs) |
| Permissions | boutique.admin, boutique.staff.menu, boutique.staff.coins, boutique.staff.give, boutique.staff.passe, f1.commande.eco.vip |
| Configuration | une seule ligne pour Tebex : set loop_tebex_secret "xxxx" |
Pour les joueurs
L’accueil

Le catalogue affiché est celui que le staff a enregistré dans le panneau d’administration.
Deux directions artistiques : la boutique


Ce que change Global 1 par rapport à Global 2
- Panneau staff de la boutique : coins en circulation en grand, achats, dépenses, ventes Tebex.
- Produits les plus achetés et derniers mouvements côte à côte, commandes utiles rappelées en bas.
- Global 2 présente les mêmes chiffres dans un panneau en verre plus large à accents violets.
Le staff choisit la direction artistique de tout le serveur (Global 1 ou Global 2) ou un style par interface dans la galerie des styles en jeu ; le changement s’applique aux joueurs sans redémarrage.
Les rayons



Ce que vous recevez vraiment :
| Rayon | Livraison |
|---|---|
| VIP | le grade choisi sur votre compte (tous vos personnages), pour la durée du grade. Racheter le même grade le prolonge. |
| Armes | l’arme ou le skin dans votre inventaire, marqué « Achat (Boutique) ». |
| Véhicules | inscrit à votre garage avec une plaque VB#####, clés remises, livré sur l’un des 7 parkings avec un point GPS pendant 15 minutes. Si la livraison échoue, le véhicule reste à vous et la livraison est retentée toutes les 30 secondes. |
| Packs, boosts, propriétés, animaux | ce que le staff a réglé comme récompense du produit (objet, véhicule, argent, coins, VIP, XP de passe). Un produit sans contenu réel réglé est refusé à l’achat (« Cet article n’a pas de contenu réel ») et vous êtes remboursé. |
Remise VIP
Votre grade peut vous donner une remise sur la boutique (90 % au plus). Elle ne s’applique pas aux grades VIP eux-mêmes, et seule la meilleure remise compte : boutique du jour, promotion ou remise VIP, sans cumul.
Boutique du jour et promotions

Chaque jour, 5 produits sont tirés au hasard pour la une, et chacun a 45 % de chance d’être remisé de 5 à 15 %. Si le staff a choisi lui-même les produits « À la une », sa liste remplace le tirage.
Acheter


Le serveur recalcule le prix avant de débiter. Un panier accepte 20 articles différents, payés en une fois ; ceux qui ne peuvent pas être livrés sont remboursés (« 3/4 livré(s), le reste a été remboursé. »). Si une livraison échoue, vous êtes remboursé automatiquement.
Obtenir des coins avec Tebex

- Notez votre code boutique. Il est en haut de
/boutiqueet dans/coins. Il désigne le personnage que vous jouez. - Payez sur Tebex. Au moment du paiement, Tebex vous demande un champ « code » : tapez-y ce code à 6 chiffres.
- Recevez. Les coins arrivent sur ce personnage, même s’il est hors ligne. Un grade VIP arrive sur votre compte.
- Sans code ? Les coins attendent sur votre compte FiveM. Connectez-vous avec le personnage voulu et tapez
/recevoircoins: tout ce qui attend y est versé.
Un paiement remboursé ou contesté sur Tebex retire ce qu’il avait donné (coins ou grade).
Être VIP


/monvip ouvre directement cet écran.Les avantages sont des avantages de confort, choisis par le staff grade par grade :
| Avantage | Où il agit |
|---|---|
| Emplacements de personnage | écran de choix du personnage (8 au total au maximum) |
| Bonus de salaire | votre paye en service ; le bonus est versé par l’État, pas par votre entreprise |
| Aide de l’État | une somme versée en banque à chaque intervalle passé en jeu (15 minutes sur loop_dev) |
| Limite de farm | la limite quotidienne du farm légal (jamais le farm illégal) ; 1000 % veut dire illimité |
| Plafond bancaire | plafonds de dépôt, retrait et virement du compte personnel |
| Poids d’inventaire | kilos en plus, appliqués à la connexion |
| Argent liquide du jour | à prendre une fois par jour dans F1 › VIP › Argent du jour |
| Remise boutique | sur les articles payés en coins, hors grades VIP |
| Coins chaque mois | crédités tous les 30 jours au personnage connecté |
| File d’attente prioritaire | vous passez devant les joueurs sans grade à la connexion |
S’y ajoutent des droits : autopilote, numéro personnalisé, skins d’armes, items collector, emotes passives et emotes du monde, freecam (F7), vêtements et visages réservés, presets de tuning, animaux et objets réservés, création de groupe, animations d’arme avancées, éditeur de HUD, et le pseudo aux couleurs du grade.
L’étoile VIP. Au-dessus de votre tête, une petite étoile de la couleur de votre grade s’affiche devant votre nom. (Pas de capture : cette étiquette n’existe qu’en jeu.)
Argent du jour. Une fois par jour calendaire et par compte (tous personnages confondus). Un jour non pris est perdu, il ne se cumule pas. Une fois pris, la ligne affiche « Pris » jusqu’au lendemain.
Fin du grade. Trois jours avant la fin, un message vous prévient à la connexion (« Ton grade … se termine dans N jours »). À la date de fin, le grade est retiré automatiquement. Un grade « sans date de fin » ne s’arrête jamais.
Mes achats et historique

L’historique affiche les achats de la session ; il se vide à la déconnexion.
Armes permanentes
Quand le serveur les active, une arme marquée permanente (achetée en permanent dans la boutique, ou donnée par le staff) :
- n’est pas lâchée à la mort ;
- ne peut être ni saisie, ni échangée ;
- est rendue à la connexion si vous l’avez perdue ;
- se récupère depuis Mes achats si elle a été achetée en boutique.
Le passe de combat

- Gagner de l’XP : 60 XP toutes les 5 minutes de jeu, et les défis.
- Récompenses : la piste gratuite donne de l’argent à chaque niveau, la piste VIP davantage, avec des véhicules exclusifs aux niveaux 25 et 50.

La récompense du jour

Elle redevient disponible 24 heures après la dernière réclamation. Manquer des jours ne fait pas perdre la série.
Pour le staff
Le panneau d’administration
/boutiqueadmin (boutique.admin) ouvre la boutique puis son administration, dans le style des menus LOOP. Un bouton Administration apparaît aussi en haut de la boutique pour le staff autorisé. Tout ce qui est enregistré s’applique tout de suite à tous les joueurs.
Onglets : Produits, Catégories, À la une, Promotions, Packs de coins, Grades VIP, Tebex, Commandes, Armes permanentes, Réglages, Historique.

Fiche d’un produit : nom, description, prix, étiquette, rareté, image (un lien https ou une image du jeu ; une image collée est refusée), masqué, populaire. Type de récompense : automatique, objet, arme, véhicule, liquide, banque, argent sale, coins, XP, VIP ou rien. Conditions : stock global, maximum par joueur, réservé aux VIP, annonce dans le chat, permanent (récupérable dans Mes achats), dates de début et de fin. Le rayon VIP n’a plus de produits à lui : il affiche les grades réglés dans l’onglet Grades VIP.



Régler les grades VIP
Les grades sont réglés à un seul endroit : l’onglet Grades VIP. Le rayon VIP de la boutique, le menu F1, les étiquettes au-dessus des têtes, les magasins, la file d’attente et les permissions lisent tous ce réglage.



- Ouvrir.
/boutiqueadmin vipouvre directement cet onglet. - Régler un grade. Changez couleur, prix, durée, avantages et droits. Mettez 0 dans une case pour retirer l’avantage.
- Enregistrer. Enregistrer les grades : appliqué tout de suite à tous les joueurs connectés, sans redémarrage. Cet onglet a son propre bouton, distinct de celui du catalogue.
- Donner un grade. Dans Donner ou prolonger un grade, tapez le n° de personnage, le code boutique ou la licence, choisissez le grade et les jours (vide = durée du grade, 0 = sans fin), puis Donner.
Ce qu’on ne peut pas faire
Supprimer un grade encore porté par un compte est refusé : retirez-le d’abord à ces comptes, ou passez-le hors vente. Un compte qui porte un grade inconnu (ancien nom) est ramené au premier grade à sa connexion, sans rien perdre.
Boutique désactivée
Si F1 › Administration › Gestion du monde › Désactiver le bouton Boutique est coché, tous les droits VIP sont ouverts à tout le monde ; ils ne figurent alors plus dans Mes avantages.
Commandes du staff (permission f1.commande.eco.vip ou boutique.admin) :
| Commande | Effet |
|---|---|
/givevip <n° perso> [grade] [jours] |
donne ou prolonge un grade ; sans grade, le premier ; sans jours, la durée du grade ; 0 = sans fin |
/removevip <n° perso> |
retire le grade du compte |

Relier Tebex

- Créer le point d’arrivée sur Tebex. Dans Tebex : Webhooks › Endpoints, ajoutez cette adresse et cochez les quatre événements
payment.completed,payment.refunded,payment.dispute.openedetpayment.dispute.lost. - Poser le secret. Tebex affiche alors un Webhook secret. Copiez-le dans
server.cfg:set loop_tebex_secret "xxxx"
Ne le mettez jamais dans un fichier partagé. Redémarrez ensuite la boutique (ou le serveur) : l’onglet Tebex passe au vert « Secret du webstore posé ». - Ajouter la variable « code ». Sur chaque paquet Tebex, ajoutez une variable nommée
code, de type texte, obligatoire. Le joueur y tape le code boutique affiché dans/boutique. - Relier les paquets. Dans Paquets reliés, Ajouter un paquet : le numéro du paquet Tebex, un nom pour vous, puis ce qu’il donne (Des Coins et le nombre, ou Un grade VIP, le grade et les jours). Enregistrer les paquets.
- Tester. Faites un achat de test : la transaction apparaît « Livrée » dans Dernières transactions.
Ce qui se passe ensuite :
- Chaque paiement n’est livré qu’une fois, même si Tebex renvoie le même message plusieurs fois.
- Avec un code, la livraison va au bon personnage, même hors ligne. Sans code, elle va au compte FiveM de l’acheteur et attend
/recevoircoins. - Paquet non relié : la transaction reste « À traiter ». Reliez le paquet, puis Livrer à la main (code boutique ou identifiant FiveM).
- Remboursement ou contestation : les coins sont retirés (s’ils ont déjà été dépensés, la ligne indique ce qui reste dû) et le grade obtenu par ce paiement est retiré.
Vous pouvez aussi passer par les commandes de paquet de Tebex (Game server commands) au lieu du webhook :
| Commande console | Exemple |
|---|---|
| annule ce que la transaction a donné |
Couper ou rallumer les armes permanentes

- Ouvrir.
/boutiqueadmin armes. - Basculer. L’interrupteur s’applique tout de suite et reste après un redémarrage. Sur loop_dev, il est coupé depuis le 23/10.
- Vérifier la restitution. La restitution à la connexion dépend aussi du module Arme permanente du preset : F1 › Administration › Gestion avancée › Configuration serveur › Preset serveur. C’est là aussi que se règle le maximum par personnage (2 par défaut). Si le module est désactivé, rien n’est restitué même avec l’interrupteur allumé ; l’onglet le signale.

Le panneau staff des joueurs
/boutiquestaff (boutique.staff.menu) : chiffres de la boutique (coins en circulation, ventes du jour, coins Tebex, coins donnés par le staff, meilleurs produits), joueurs en ligne et fiche d’un joueur (mouvements, achats, cadeaux en attente, passe). Depuis la fiche : donner ou retirer des coins, offrir un produit, annuler un cadeau en attente, régler le passe.
La cible des commandes est un id serveur, le code boutique, c<n° de personnage> ou un nom.
| Commande | Effet | Permission |
|---|---|---|
/coins [cible] |
solde et code d’un joueur | boutique.staff.menu pour une autre cible |
/givecoins <cible> <montant> [motif], /removecoins |
donner, retirer (jamais sous 0, même hors ligne) | boutique.staff.coins |
/giveB <cible> <rayon:id> [quantité] |
offrir un produit (livré à la connexion si hors ligne) | boutique.staff.give |
/bproduits [mot] |
chercher l’identifiant d’un produit | boutique.staff.give |
/bpxp, /bplevel, /bpgrant |
XP, niveau, passe VIP | boutique.staff.passe |
Bon fonctionnement
- Coins par personnage, VIP par compte. Les coins appartiennent à un personnage ; le grade VIP, son argent du jour et ses dates appartiennent au compte du joueur.
- Achats sûrs. Un seul achat à la fois par joueur (« Une opération est déjà en cours. »), solde bloqué pendant l’opération, stock réservé avant la livraison, remboursement si la livraison échoue. Une livraison interrompue n’est jamais rejouée toute seule : le staff tranche avec
boutique:resolveclaim <clé> retryoudoneen console. - Objets achetés liés à leur propriétaire : ni don, ni dépôt.
- Grades. Les échéances sont vérifiées chaque minute ; les coins mensuels sont versés au plus une fois tous les 30 jours ; le cadeau d’un grade n’est remis qu’à l’obtention, pas à la prolongation. Chaque attribution, prolongation, retrait et argent du jour est inscrit dans l’historique du panneau et dans les logs.
- Tebex. Le serveur vérifie la signature de chaque message de Tebex avec votre secret ; un message non signé ou mal signé est refusé, et sans secret posé, tout est refusé.
- Saison du passe : 45 jours. Sans date de début fixée par le staff, la fin est recalculée à chaque redémarrage de la boutique.
- Désactivation. La boutique et le passe se coupent par le preset du serveur (« La boutique est désactivée sur ce serveur »). Le passe seul :
set loop_battlepass_enabled 0. - Les achats sont journalisés dans la famille
boutiquedes logs, masquable avecf1.logs.masquer.boutique.
Problèmes courants
| Symptôme | Cause | Solution |
|---|---|---|
| « Crédits insuffisants. » | solde trop bas | acheter des coins |
| « Tu possèdes déjà cet article. » / « Limite de N achats atteinte. » | maximum par joueur | normal |
| « Cet article n’a pas de contenu réel : à configurer dans /boutiqueadmin. » | pack, boost, propriété ou animal sans récompense | staff : régler le type de récompense dans la fiche du produit |
| « Stock épuisé. » | stock global atteint | staff : augmenter le stock |
| Coins Tebex non reçus, transaction « Livrée » | le joueur n’a pas mis de code | il tape /recevoircoins avec le bon personnage |
| Transaction « À traiter » | paquet Tebex non relié | relier le paquet, puis Livrer à la main |
| Aucune transaction n’apparaît | secret absent ou faux, ou événements non cochés sur Tebex | vérifier set loop_tebex_secret, redémarrer, revoir l’étape 2 |
| « Secret du webstore absent » dans l’onglet Tebex | ligne set loop_tebex_secret manquante |
l’ajouter dans server.cfg, redémarrer |
| L’adresse du webhook ne s’affiche pas | le serveur ne connaît pas encore son adresse publique | attendre la fin du démarrage, rouvrir l’onglet |
« Grade inexistant » avec /givevip |
identifiant du grade mal tapé | utiliser l’identifiant (saphir, rubis…), pas le nom affiché |
| « Impossible de supprimer un grade encore porté » | des comptes ont ce grade | le retirer à ces comptes, ou le passer hors vente |
| « Argent du jour déjà récupéré. Reviens demain. » | déjà pris aujourd’hui sur ce compte | normal, un seul par jour et par compte |
| « Ton grade ne donne pas d’argent du jour. » | avantage à 0 pour ce grade | staff : régler Argent liquide du jour |
| Un droit VIP ne marche pas | droit décoché sur le grade | staff : onglet Grades VIP, Droits débloqués |
| Arme permanente perdue et pas rendue | interrupteur coupé, ou module du preset désactivé | onglet Armes permanentes et Preset serveur |
| « Réservation non confirmée. Vérification staff nécessaire. » | réclamation interrompue | staff : boutique:resolveclaim <clé> retry ou done |
| « Les images collées en base64 sont refusées » | image collée | utiliser un lien https |
| « La boutique pèserait N Ko, au-delà de la limite de 256 Ko » | catalogue trop lourd | alléger descriptions et images |
Commandes, touches et menus
Commandes (3)
| Commande | Aide | Permission |
|---|---|---|
/boutique:resolveclaim | ||
/boutiqueadmin | ||
/boutiquestaff |
LOOP Docs