Advanced QBCore Hunting Script

Create an advanced hunting script for the QBCore framework in FiveM that significantly enhances the basic hunting mechanics by adding realistic animal behaviors, tracking, skinning, harvesting, configurable spawn rates, inventory and crafting integration, and multiplayer synchronization. Key Features and Requirements: - **Realistic Animal AI:** Implement animals that display natural behaviors such as fleeing when threatened, grazing peacefully, and protecting their young. Animals should roam dynamically within defined areas. - **Tracking Mechanics:** Allow players to track animals by detecting and following footprints, blood trails, or other visual/environmental signs. Provide visual cues such as on-screen indicators or minimap markers to assist tracking. - **Skinning and Harvesting:** After an animal is successfully hunted and killed, enable players to skin it and harvest resources (meat, pelts, bones, etc.) which can be used later in crafting. - **Configurable Animal Spawning:** Create configuration files or modules that allow server administrators to set spawn locations, species types, and spawn rates for animals. This configuration should be easily editable and support multiple species with different behaviors. - **QBCore Inventory and Crafting Integration:** Integrate seamlessly with the QBCore inventory system so that harvested materials are correctly added to players’ inventories. Make harvested resources usable in the existing crafting system or extend crafting scripts as needed. - **Multiplayer Synchronization:** Ensure all hunting-related events—including animal movement, tracking cues, hunting success, harvesting, and resource distribution—are properly synchronized across all connected clients to maintain consistency in multiplayer environments. Steps to Implement: 1. **Animal Entity and Behavior Design:** Define animal NPCs with logic for roaming, feeding, fleeing, and family group protection behaviors. 2. **Tracking System:** Develop mechanics for tracking animal signs. Incorporate visual and possibly audio feedback, including minimap blips that update dynamically. 3. **Skinning & Harvesting Interaction:** Script interactions triggered on the death of animals that allow players to skin and gather resources with appropriate animations and item drops. 4. **Configurable Spawn System:** Develop a configuration module/file with clear documentation for adjusting spawn points, spawn rates, and animal types. 5. **QBCore Integration:** Hook into QBCore's inventory and crafting APIs to add harvested items and recipes. 6. **Networking & Sync:** Implement client-server architecture ensuring all events are propagated and consistent between players. Output Format: - Provide full Lua script files with comprehensive inline comments explaining the purpose and function of each part. - Include configuration files for animal spawning and behavior settings with example entries. - Supply clear installation instructions detailing where files go within a QBCore server and any dependencies or setup steps. - Include any required client and server resource files. Example Snippets to Include: - Code defining fleeing behavior when animals detect a player within a certain radius. - Sample configuration block showing animal spawn points, species, and spawn rates. Additional Notes: - The script must be compatible and non-conflicting with standard QBCore resources. - Focus on performance optimization to handle multiple animals and players without degrading server performance. - Structure features modularly; allow server admins to enable/disable key parts like tracking or skinning. Ensure the final output is ready for direct deployment on a FiveM QBCore server with no ambiguity in usage or installation.