Installation
1
Download
Get the latest release from our Tebex store and download it from your Keymaster
2
Extract
Extract the
spooni_wildHorseManager folder to your server’s resources directory3
Configure
Add
ensure spooni_wildHorseManager to your server.cfg4
Customize
Configure the
config.lua file to your preferences (see the configuration section below)Configuration
The script is configured through theconfig.lua file. Here are the main configuration options:
Blacklisting horses
Prevent specific horse models from spawning as wild horses:Replacing horse models
Automatically replace specific horse models with others when they spawn:Defining horse groups
Group horses by breed for easier management:Configuring spawn districts
Define which horse groups spawn in which regions:District names should match the actual region names in your RedM server. You can use the debug commands to help identify the correct district names.
Debugging
Enable debug mode in the config to access debugging features:Available debug commands
/npcSlots
/npcSlots
Shows information about ped slots that might be blocking horse spawns. This is useful for troubleshooting when horses aren’t spawning in expected locations.
/findHorse
/findHorse
Toggles display of scenario points for horse spawning. This visual debug tool helps you see where horses are configured to spawn and verify your district configurations.
Framework integration
The script includes built-in support for multiple frameworks:Performance considerations
The script is optimized for performance, but here are some tips to ensure smooth operation:
- Limit horse groups: Don’t create too many horse groups as this can impact spawn calculations
- Reasonable blacklists: Keep blacklists focused on problematic horses rather than excluding large numbers
- District optimization: Configure districts based on actual player activity areas
- Debug mode: Remember to disable debug mode in production
Troubleshooting
Horses not spawning
Horses not spawning
- District name: Check if the district name matches exactly (case-sensitive)
- Horse models: Verify horse model names are correct
- Spawn points: Use the
/findHorsedebug command to see spawn points - Blacklist: Check if horses are blacklisted
Performance issues
Performance issues
- Debug mode: Disable debug mode in production
- Horse groups: Reduce the number of horse groups
- Group size: Limit the number of horses per group
- Error logs: Check the server console for error messages
Framework compatibility
Framework compatibility
- Framework detection: Ensure your framework is properly detected
- Custom setup: Check frameworkBridge.lua for custom framework setup
- Event verification: Verify framework events are working correctly
Support
If you encounter issues or need assistance:Discord support
Join our Discord community for support and updates.
Documentation
Docs home - installation basics and links to every script.