Kayz Boutique & Tebex.
Tes joueurs paient sur ta boutique Tebex. Tebex envoie une commande à la console de ton serveur, et la base crédite le compte du joueur en coins ou en jours de VIP. Il ne te faut qu'une ligne dans server.cfg et une commande par pack.
1.Relier Tebex au serveur
Crée une boutique de type FiveM
Sur tebex.io, à la création de la boutique, choisis le jeu FiveM. Tes clients se connecteront avec leur compte Cfx.re.
Integrations › Game Servers › Connect Game Server
Choisis l'option Plugin (rien à télécharger pour FiveM), donne un nom au serveur, puis copie la clé secrète affichée.
Colle-la dans ton fichier de secrets
Une ligne, puis redémarre. Dans Tebex, l'état passe à « Connected » en quelques secondes.
# secrets.cfg
sv_tebexSecret "ta-cle-secrete-tebex"Cette clé donne accès à ta boutique : ne la publie jamais. Si elle fuit, régénère-la dans Tebex.
2.Un pack de coins = une commande
Crée un pack par offre (par exemple « 1 000 coins »). Dans l'onglet Game Server Commands du pack, ajoute cette commande, à exécuter même si le joueur est hors ligne :
kz_tebex_coins fivem:{id} 1000 {transaction}
| Morceau | Ce qu'il faut y mettre |
|---|---|
kz_tebex_coins | La commande de la base. Elle ne marche que depuis la console : un joueur ne peut pas la lancer. |
fivem:{id} | Le compte Cfx.re de l'acheteur. Tebex remplace {id} par son numéro ; garde bien fivem: devant. Le joueur doit s'être déjà connecté une fois au serveur. |
1000 | Le nombre de coins livrés. |
{transaction} | La référence unique du paiement : un même achat n'est jamais crédité deux fois, même si Tebex rejoue la commande. |
Désactive la quantité sur chaque pack (option « Disable quantity » de Tebex) : une même transaction n'est créditée qu'une fois.
3.Vendre le VIP
kz_tebex_vip fivem:{id} 30 {transaction}
| Morceau | Ce qu'il faut y mettre |
|---|---|
30 | La durée en jours (de 1 à 3650). Les jours s'ajoutent à ceux qui restent si le joueur est déjà VIP. |
retirer | À la place de la durée, retire le VIP : kz_tebex_vip fivem:123456 retirer. |
4.Le lien dans le jeu
Dans F9 › Variables › Boutique, colle l'adresse de ta boutique Tebex dans Lien « Acheter des coins ». Le bouton apparaît dans la boutique (F10) et ouvre ta page Tebex dans le navigateur du joueur. Le catalogue (ce qu'on achète avec les coins) se règle dans F9 › Boutique.
5.Tester sans payer
Dans Tebex, fais un paiement manuel sur ton propre compte. La commande arrive en général en une à trois minutes. Dans la console :
| Ligne en console | Ce que ça veut dire |
|---|---|
[tebex] fivem:… crédité de 1000 coins | C'est livré. Le joueur reçoit une notification s'il est connecté. |
[tebex] VIP +30 jours pour fivem:… | Le VIP est posé ou prolongé. |
refusé (cible inconnue) | Le joueur ne s'est jamais connecté avec ce compte Cfx.re, ou fivem: manque devant {id}. |
déjà crédité : transaction … | Normal si Tebex rejoue la commande : le joueur n'est pas payé deux fois. |
6.Les autres façons de désigner un joueur
Pour un geste à la main depuis la console (geste commercial, remboursement), les deux commandes acceptent aussi :
| Cible | Exemple |
|---|---|
| ID en jeu (connecté) | kz_tebex_coins 12 500 |
license: | kz_tebex_coins license:abc123… 500 |
discord: | kz_tebex_coins discord:2981147… 500 |
uid: | kz_tebex_coins uid:42 500 (l'ID unique du joueur dans la base) |
Un montant négatif retire des coins. Le staff qui a la permission peut aussi en donner en jeu avec /addCoins <ID unique> <quantité>.