Ticket à gratter v3 : installation et configuration
Installer le script Ticket à gratter v3 sur votre serveur FiveM : prérequis, items ox_inventory / QBCore / ESX, configuration des tickets et des lots, commandes admin.
Le script Ticket à gratter permet à vos joueurs d'acheter des tickets chez le buraliste, de les gratter case par case et de tenter le jackpot du serveur. La version 3 apporte une nouvelle interface « Point de vente », un grattage réaliste avec effets et sons, le jackpot en direct et des statistiques par joueur. La grille et le gain sont toujours décidés par le serveur.
Prérequis
- ESX Legacy ou QBCore
- oxmysql
- Optionnel : ox_inventory, ox_target ou qb-target (détectés automatiquement)
- Le compte Cfx.re qui a reçu l'asset doit être celui de la clé de licence du serveur (sv_licenseKey)
1. Récupérer le produit
Après l'achat, le produit est livré automatiquement sur le compte Cfx.re utilisé lors du paiement. Ouvrez le portail Cfx.re (Granted Assets), retrouvez le produit et téléchargez l'archive. Si vous aviez une ancienne version, retéléchargez-la : la v3 remplace entièrement l'ancienne.
2. Installer
- Déposez le dossier du script dans resources (gardez son nom).
- Aucune requête SQL à importer : les tables se créent toutes seules au premier démarrage.
- Ajoutez ensure suivi du nom du dossier dans server.cfg, après votre framework, oxmysql et votre inventaire.
- Redémarrez le serveur.
3. Ajouter les items
Les fichiers d'items sont fournis, prêts à coller, avec les images des 4 tickets :
- ox_inventory : ajoutez les items au fichier data/items.lua et copiez les images dans web/images.
- QBCore : ajoutez les items à qb-core/shared/items.lua et les images dans le dossier d'images de votre inventaire.
- ESX : ajoutez les items à votre base (table items) ou à votre inventaire, avec les images.
Au démarrage, le script vérifie que chaque item existe et affiche un message clair dans la console s'il en manque un.
4. Configurer
- Tickets : ajoutez autant de tickets que vous voulez, avec leur prix et leur gain maximum.
- Lots : argent, banque, objets, armes, ticket gratuit ou jackpot.
- Économie : le taux de redistribution de chaque ticket est affiché dans la console, pour garder une économie saine.
- Logs Discord : webhook à renseigner côté serveur uniquement.
- Langue : français et anglais inclus.
5. Commandes et exports
- /giveticket : donner des tickets à un joueur.
- /setjackpot : régler le montant du jackpot.
- Des exports sont disponibles pour vos autres scripts (voir la documentation livrée).
Côté joueur : achat en espèces ou par carte au point de vente, grattage à la souris ou au tactile, boutons « Tout révéler » et « Ticket suivant ». Le gain est toujours crédité, même après un crash ou une déconnexion.
6. En cas de problème
- Message « item manquant » dans la console : l'item n'a pas été ajouté à votre inventaire, reprenez l'étape 3.
- Erreur au démarrage : vérifiez l'ordre des ensure (framework, oxmysql et inventaire d'abord) et la licence Cfx.re du serveur.
- Images des tickets absentes : copiez les images fournies dans le dossier d'images de votre inventaire.