LOOP Docs
Menu F1GuidesItems
Accueil/Systèmes/Boutique en coins, VIP et Tebex

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

Accueil de la boutique en coins
Accueil : en haut votre statut VIP, votre code boutique à 6 chiffres, la récompense du jour (« À réclamer »), le panier, Acheter des coins et votre solde. À gauche les rayons : Boutique du jour, Passe de combat avec votre niveau, VIP, Armes, Véhicules, Packs, Boosts, Propriétés, Animaux. Au centre le carrousel des produits à la une.

Le catalogue affiché est celui que le staff a enregistré dans le panneau d’administration.

Deux directions artistiques : la boutique

Boutique (coins), Global 1 · nouvelle direction artistique
Global 1 · nouvelle direction artistique · Boutique (coins), style 8
Boutique (coins), Global 2 · direction originale
Global 2 · direction originale · Boutique (coins), style 1

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

Rayon Armes
Un rayon (ici Armes) : chaque carte montre l’image, le nom, le type et le prix en coins avec l’équivalent en euros. Cliquez pour acheter.
Rayon Véhicules
Véhicules : le véhicule acheté est ajouté à votre garage, puis livré sur un parking avec un point GPS.
Rayon Packs
Packs : lots de plusieurs avantages, avec la mention de leur contenu.

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

Boutique du jour
Boutique du jour : une sélection qui change chaque nuit à minuit (heure du serveur), avec un bouton Acheter par article.

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

Confirmation d’achat
Confirmer l’achat : le produit, sa description, le total en coins. S’il vous manque des coins, la fenêtre le dit et propose Obtenir des coins.
Achat validé
Achat validé : la notification en bas de l’écran et le solde mis à jour.

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

Obtenir des coins
Obtenir des coins : les packs avec leur prix et le solde que vous aurez après. Un clic ouvre la boutique Tebex dans le navigateur. En bas, votre code boutique.
  1. Notez votre code boutique. Il est en haut de /boutique et dans /coins. Il désigne le personnage que vous jouez.
  2. Payez sur Tebex. Au moment du paiement, Tebex vous demande un champ « code » : tapez-y ce code à 6 chiffres.
  3. Recevez. Les coins arrivent sur ce personnage, même s’il est hors ligne. Un grade VIP arrive sur votre compte.
  4. 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

Menu VIP du F1
F1 › Services et avantages › VIP : Argent du jour (si votre grade en donne, ici 500 $ en exemple), Mes avantages avec votre grade et le temps restant, puis les services réservés : autopilote, numéro de téléphone personnalisé, skins d’armes.
Mes avantages VIP
Mes avantages : en tête votre grade et sa fin (« VIP Rubis · encore 18 jours », ou « sans date de fin »). Chaque ligne est un avantage ; la description en bas dit où il agit. En fin de liste, les droits débloqués puis les commandes utiles. /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

Mes achats
Mes achats : vos 60 derniers achats. Un produit permanent a un bouton Récupérer qui relance la livraison (une fois par minute), utile après la perte d’un objet ; un achat unique affiche « Livré ».

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

Passe de combat
Passe de combat : votre niveau sur 50, l’XP du niveau (1 000 par niveau), le temps restant et les récompenses à réclamer. À droite, le passe VIP, le passe VIP+ et l’achat de niveaux. En bas, la piste VIP et la piste gratuite ; cliquez une récompense débloquée pour la réclamer.
  • 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.
Défis du passe
Défis : 3 défis quotidiens (renouvelés à minuit) et 3 hebdomadaires, avec leur progression. Un défi terminé se réclame avec Valider.

La récompense du jour

Récompense du jour
Récompense du jour : une série de 7 jours (100 $, 200 $, 150 XP de passe, 350 $, 500 $, 300 XP, puis le jackpot de 1 000 $). Le jour en cours est encadré, Réclamer le donne.

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.

Administration : produits
Produits : un onglet par rayon, une recherche, Ajouter un produit. Chaque carte a l’interrupteur En vente, l’ordre, dupliquer, modifier et supprimer. En haut, l’état « Tout est enregistré », Annuler les modifications et Enregistrer et appliquer.

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.

Administration : promotions
Promotions : remises en pourcentage (toute la boutique, une catégorie ou un produit) et bannières d’annonce, actives entre leurs dates.
Administration : packs de coins
Packs de coins : le lien de votre boutique Tebex, la note sous les packs, puis chaque pack (coins, prix affiché, badge, lien propre). Le prix n’est qu’affiché : le paiement se fait sur Tebex.
Administration : historique
Historique : les 10 dernières versions enregistrées, avec Restaurer.

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.

Grades VIP : tableau d’ensemble
Grades VIP, vue d’ensemble : l’Intervalle du revenu VIP (minutes en jeu entre deux versements de l’aide de l’État, 15 sur loop_dev), puis un tableau qui croise chaque avantage et chaque droit avec chaque grade (Saphir, Émeraude, Rubis, Diamant), et la colonne Où il agit. En haut, Ajouter un grade et Enregistrer les grades.
Grades VIP : fiche d’un grade
La fiche d’un grade : identifiant (fixe, il relie les comptes et les paquets Tebex), nom affiché, couleur (pseudo, étoile du gamertag, boutique), prix en coins (0 = pas en vente), durée en jours (0 = sans fin, un rachat prolonge), interrupteur En vente, phrase de présentation. Puis les avantages chiffrés, chacun avec son unité et l’endroit où il agit, et File d’attente prioritaire.
Grades VIP : droits, cadeau, comptes VIP
Droits, cadeau et comptes : un interrupteur par droit débloqué (Tout cocher, Tout décocher), le Cadeau à l’obtention (remis une fois, à la prochaine connexion si le joueur est hors ligne), puis Donner ou prolonger un grade (joueur, grade, jours), la liste des comptes VIP avec leur grade, leur date de fin et la corbeille pour retirer, et l’historique des attributions.
  1. Ouvrir. /boutiqueadmin vip ouvre directement cet onglet.
  2. Régler un grade. Changez couleur, prix, durée, avantages et droits. Mettez 0 dans une case pour retirer l’avantage.
  3. 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.
  4. 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
Onglet Commandes
Commandes : le rappel de toutes les commandes, côté joueurs et côté staff.

Relier Tebex

Onglet Tebex
Tebex : en haut l’état du secret (ici « Secret du webstore absent », en rouge), puis l’adresse du webhook à donner à Tebex et les 4 étapes de mise en place. Paquets reliés : chaque numéro de paquet Tebex et ce qu’il donne (des coins, ou un grade VIP avec ses jours). Dernières transactions avec leur état (Livrée, À traiter, Remboursée) et Livrer à la main. En bas, les coins en attente d’un joueur qui n’a pas donné de code. Les adresses et numéros affichés sont fictifs.
  1. 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.opened et payment.dispute.lost.
  2. 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é ».
  3. 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.
  4. 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.
  5. 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

Onglet Armes permanentes
Armes permanentes : un seul interrupteur pour les trois mécanismes (restitution à la connexion, protection à la mort et contre les saisies et échanges, récupération des achats boutique). Couper ne supprime rien : les armes et leurs marques restent, tout revient quand vous réactivez.
  1. Ouvrir. /boutiqueadmin armes.
  2. 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.
  3. 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.
Menu Arme permanente
Arme permanente : le module Arme permanente du preset : maximum par personnage et rappel de la commande · toutes les entrées de ce menu

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é> retry ou done en 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 boutique des logs, masquable avec f1.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)

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