Oxide Animal Control
Animal control gig job system for FiveM servers with shift management, four job types, crew cooperation, progression, and full payment mechanics.
Oxide Animal Control is a comprehensive gig job system for FiveM servers. Players clock in at an animal control office, receive dispatch calls for animal incidents, and perform services — aggressive animal tranquilization, stray capture, wildlife removal, and deceased pickup. It supports QBCore, QBx (Qbox), ESX, and Standalone frameworks through community_bridge.
Key Features
- Multi-Framework Support — QBCore, QBx, ESX, or Standalone via community_bridge
- Four Job Types — Aggressive animal, stray capture, wildlife removal, and deceased pickup with unique mechanics and AI behaviors
- Shift System — Dispatcher NPC menu with NUI or bridge menu styles, slot limits, and shift state machine
- Call Dispatch — Randomized animal reports from a pool of 55 events with configurable intervals
- Crew System — Two-player co-op with shared vehicle, dispatch calls, and a 15% co-op bonus
- Progression System — 5 levels (Volunteer to Chief Officer) with increasing pay multipliers, tip chances, and daily streaks
- Payment System — Per-job formula with base pay, distance bonus, speed bonus, and end-of-shift payout with deductions
- Tranquilizer System — Dart gun with inventory integration, ammo management, and damage restriction
- Bait System — Placeable bait with ghost preview, scent particles, and animal luring mechanics
- Stealth Detection — Native crouch detection or fallback random chance for custom crouch systems
- Animal AI — Per-type behavior (combat, wander, patrol, dead) with escape detection and state machines
- Animal Loading & Delivery — Load sedated/calmed animals into the truck and deliver to the shelter
- Reporting NPC Behavior — Contextual civilian NPCs with reaction animations
- Safety Zones — Traffic speed zones and scenario blocks around animal scenes
- HUD Overlay — Mission timer, job label, and context-sensitive hints
- Tutorial System — 17 contextual tooltips guiding new players through their first shift
- Admin Builder — In-game tool for creating office locations and job events with 3D markers and Lua export
Requirements
| Resource | Purpose |
|---|---|
| oxmysql | Database operations |
| ox_lib | Utility library, callbacks, progress bars |
| community_bridge | Framework abstraction (available from the Oxide Studios Discord) |
community_bridge handles all framework abstraction, including target interactions, inventory, vehicle keys, phone, and notifications. It supports QBCore, QBx (Qbox), ESX, and standalone servers.
Supported Frameworks
| Framework | Support |
|---|---|
| QBCore | Full |
| QBx (Qbox) | Full |
| ESX | Full |
| Standalone | Via community_bridge |
| Custom | Via community_bridge |
Documentation
- Installation Guide — Set up the resource on your server
- Configuration — Complete configuration reference
- Features — All features and mechanics explained
- Admin Tools — Admin commands and developer utilities
- Troubleshooting — Common issues and solutions