Boutique de script Costello

📋 Description

costello-harvest-creator est un système de récolte entièrement dynamique pour serveur RedM sous RSG-Core. Il permet à un administrateur de créer, configurer et gérer des zones de récolte directement en jeu via une interface NUI, sans toucher à aucun fichier de configuration. Les joueurs peuvent ensuite récolter des ressources dans ces zones avec animations, progressbar et notifications.

⚙️ Fonctionnalités

Interface administrateur (/harvestcreator)

• Menu NUI complet accessible uniquement aux CitizenIDs autorisés dans config.lua
• Création de zones en temps réel sans redémarrage du script
• Liste de toutes les zones existantes chargées depuis la base de données à chaque ouverture
• Édition et suppression de zones existantes avec confirmation en 2 clics
• Bouton "📍 Ma position actuelle" pour remplir les coordonnées automatiquement
• Bouton "🎯 Entité la plus proche" pour récupérer le hash d'un animal ou objet automatiquement

Types de zones

• Coordonnées XYZ — zone circulaire avec rayon configurable, blip visible sur la map
• Entité — lié à un modèle d'animal ou d'objet (hash du modèle), déclenche la récolte à proximité de n'importe quelle entité du même modèle

Configuration par zone

• Nom de la zone affiché dans le prompt et les notifications
• Animation de récolte choisie parmi une liste configurable
• Durée de récolte réglable via slider (1 à 30 secondes)
• Couleur du blip sur la map (10 couleurs disponibles)
• Ajout d'autant d'items récoltables que souhaité avec pour chacun : item, label, quantité min/max, pourcentage de chance

Expérience joueur

• Prompt natif RDR2 affiché en bas de l'écran (touche E) à l'approche d'une zone
• Personnage figé pendant la récolte (pas de déplacement)
• Progressbar ox_lib annulable
• Notification ox_lib avec le nom et la quantité récoltée
• Item ajouté directement dans l'inventaire rsg-inventory

Technique

• Sauvegarde complète en MySQL via oxmysql (persistance après redémarrage)
• Synchronisation en temps réel pour tous les joueurs connectés (création/modification/suppression)
• Blips créés automatiquement au chargement avec sprite personnalisé
• Double vérification des accès admin côté client ET serveur
• Mode debug dans config.lua pour bypasser le check admin en développement

🔧 Dépendances

📦 Installation

1. Copier le dossier dans resources/
2. Importer sql/harvest.sql dans la base de données
3. Ajouter 'ensure costello-harvest-creator' dans server.cfg
4. Configurer Config.AdminCitizenIDs dans config.lua
5. Redémarrer le serveur