Skip to main content

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 directory
3

Configure

Add ensure spooni_wildHorseManager to your server.cfg
4

Customize

Configure the config.lua file to your preferences (see the configuration section below)

Configuration

The script is configured through the config.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

Shows information about ped slots that might be blocking horse spawns. This is useful for troubleshooting when horses aren’t spawning in expected locations.
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.
Debug mode should only be enabled when troubleshooting. Disable it in production to maintain optimal performance.

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

  • District name: Check if the district name matches exactly (case-sensitive)
  • Horse models: Verify horse model names are correct
  • Spawn points: Use the /findHorse debug command to see spawn points
  • Blacklist: Check if horses are blacklisted
  • 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 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.