QBox Chasse aux œufs de Pâques pour FiveM

ss_easter de ShoeShuffler/Shuffle Shop place des œufs à collecter à des endroits configurés pour les personnages Qbox. Le code utilise qbx_core, ox_lib, oxmysql, ox_inventory et ox_target. La configuration fournie comporte 24 emplacements ; les fichiers de modèles sont requis séparément et ne sont pas automatiquement inclus avec ce script.

Préparer modèles, objets et persistance

Le README renvoie aux modèles ShopFusion et permet de configurer vos propres modèles. Associez chaque clé de Config.EggLocations à un objet d’inventaire et son modèle à un accessoire chargé en streaming. Vérifiez les instructions d’inventaire pour votre version d’ox_inventory plutôt que de copier aveuglément les champs d’exemple.

Au démarrage, le serveur crée une table ss_easter si elle n’existe pas. Les collectes sont stockées en JSON sous un citizenid unique : la limite prévue est une collecte de chaque œuf par personnage. Sauvegardez la base et conservez la table lors des mises à jour ; la vider réinitialise l’historique.

Tester l’inventaire et les récompenses

Le serveur valide un identifiant d’œuf configuré et refuse la collecte au-delà de huit mètres. Il vérifie l’état enregistré, mais l’écrit avant AddItem et ne contrôle pas le succès de l’ajout. Un inventaire plein peut donc laisser un œuf enregistré comme collecté sans livraison. Examinez la gestion des échecs avant d’activer les récompenses.

Lecture des collectes, enregistrement, livraison des objets et primes bancaires ne forment pas une transaction unique et ne sont pas protégés par un verrou de collecte par personnage. Testez les demandes répétées et simultanées, la capacité, la reconnexion, plusieurs personnages et chaque palier configuré. Le client supprime l’œuf local avant la réponse du serveur ; les demandes rejetées nécessitent aussi une récupération.

Source et portée de la vérification

Code source vérifié le 10 septembre 2026 à la révision b1a881576314632512409295b5c221648da70438 ; le manifeste indique la version 1.0.0. Aucun modèle d’œuf n’a été installé et aucun test de base de données, de récompense ou multijoueur n’a été effectué.

Examiner le code de ss_easter