Calendrier de l'avent : installation et configuration (ESX)
Installer le Calendrier de l'avent v1.2 sur un serveur FiveM ESX : base de données, récompenses des 24 cases, PNJ, logs Discord et mode test.
Le Calendrier de l'avent propose 24 cases animées qui s'ouvrent en 3D (neige, guirlande, confettis et sons), une case 24 dorée pour le grand final, une barre de progression et un compte à rebours jusqu'à la prochaine case. Toutes les vérifications sont faites côté serveur : un cadeau ne peut jamais être réclamé deux fois.
Prérequis
- ESX Legacy
- oxmysql
- Optionnel : ox_inventory et ox_target
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.
Le produit est protégé par l'escrow Cfx.re : il ne fonctionne que sur un serveur dont la clé de licence (sv_licenseKey) appartient au même compte Cfx.re que celui qui a reçu l'asset.
2. Installer
- Déposez le dossier du script dans resources.
- Importez le fichier .sql fourni dans votre base de données (la table se crée aussi automatiquement au premier démarrage).
- Ajoutez ensure suivi du nom du dossier dans server.cfg, après es_extended et oxmysql (et après ox_inventory / ox_target si vous les utilisez).
- Redémarrez le serveur.
3. Configurer
Tout se règle dans config.lua :
- les récompenses de chaque case (argent propre, banque, argent sale, items, armes, autant que vous voulez par case) ainsi que leur titre, couleur et icône ;
- le rattrapage des jours manqués (activé ou non) et le fuseau horaire du serveur ;
- l'emplacement du PNJ et de son blip (touche E ou ox_target) ;
- le webhook Discord des logs (Paramètres du salon › Intégrations › Webhooks › Copier l'URL) et l'expulsion automatique des tentatives suspectes, en option ;
- la langue : français et anglais inclus.
Les joueurs ouvrent le calendrier avec /calendrier ou en allant voir le PNJ, et reçoivent un rappel à la connexion quand des cadeaux les attendent.
4. Tester avant décembre
Activez le mode test pour essayer le calendrier hors saison. Les admins disposent aussi d'une commande pour réinitialiser un joueur ou une case. Les développeurs peuvent brancher leurs scripts grâce aux exports et à l'événement fournis (voir la documentation).
5. En cas de problème
- Erreur SQL : vérifiez que oxmysql démarre avant le script et que la table existe.
- Item non reçu : le script vérifie la place dans l'inventaire avant de remettre le cadeau ; vérifiez le nom de l'item dans config.lua.
- Pas de logs Discord : vérifiez l'URL du webhook dans config.lua.