Animal Control Job

Q: I do not get a vehicle key after spawning the job vehicle

Hook into the gs_animalcontrol:OnJobVehicleSpawned event in bridge/sv_bridge.lua and call your key system export or event there. Check whether your key script runs on the server or client. Server exports go directly in the event handler. Client exports need a client event triggered from the server. With tgiann-hotwire, resolve the vehicle entity from netId first; both arguments may be nil otherwise.

Q: The job vehicle spawns with almost no fuel

Use the same gs_animalcontrol:OnJobVehicleSpawned event in bridge/sv_bridge.lua to set fuel through your fuel script (for example lc_fuel) right after the vehicle spawns.

Resource folder: gs_animalcontrol

View product

Installation Instructions for Animal Control Job

Follow these steps to install and configure gs_animalcontrol on your FiveM server.

Download the Resource
- Go to portal.cfx.re
- Navigate to Assets > Granted Assets > gs_animalcontrol
- Download the resource
Extract the Files
- Open the downloaded .zip file
- Inside, you'll find a folder named gs_animalcontrol
- Move the entire gs_animalcontrol folder into your desired server resources folder (e.g., /resources/[scripts])
Add to Server Configuration
- Open your server.cfg
- Add the following line:
```
ensure gs_animalcontrol
```
Restart the Server
- Restart your FiveM server (Important!)
Configure the Script (Optional)
- Navigate to gs_animalcontrol/config.lua
- Edit the configuration options to fit your server's needs

Does this require ox_target, or can I use qb-target?

Recent Keymaster versions support qb-target out of the box. Download the latest version and test before making manual bridge changes. Older versions may need a custom bridge/cl_bridge.lua if you see type errors or missing interactions.

I do not get a vehicle key after spawning the job vehicle

Hook into the gs_animalcontrol:OnJobVehicleSpawned event in bridge/sv_bridge.lua and call your key system export or event there. Check whether your key script runs on the server or client. Server exports go directly in the event handler. Client exports need a client event triggered from the server. With tgiann-hotwire, resolve the vehicle entity from netId first; both arguments may be nil otherwise.

The job vehicle spawns with almost no fuel

Use the same gs_animalcontrol:OnJobVehicleSpawned event in bridge/sv_bridge.lua to set fuel through your fuel script (for example lc_fuel) right after the vehicle spawns.

Do I need to add bait or cage items to my inventory?

No. Bait and cages are handled internally by the script. It is plug-and-play after installation with no inventory items required.

How do I place bait?

Start the animal control job, stand close to the animal you want to catch, and press E. If you use ox_lib, helper text should appear when bait placement is available.

Nothing happens when I try to catch an animal

Usually a target system issue. Confirm qb-target or ox_target is running and configured correctly. Update to the latest script version. If catching worked before a bridge edit, restore or replace the target bridge code.

Can I add extra catch zones or locations with the encrypted version?

Yes. All locations, NPCs, vehicles, and props are configurable through config.lua. You do not need the open-source version to add extra zones such as Roxwood or custom map areas.

My key or fuel integration still fails after adding the event

Double-check that you are editing the server bridge, that the event name matches exactly, and that your export runs on the correct side (server vs client). Test with a simple print or notification inside the handler to confirm it fires when the job vehicle spawns.