Installation
This guide will walk you through the installation and setup of the Dusa Hunting System.
Prerequisites
Before installing the hunting system, ensure you have the following:
FiveM Server - A running FiveM server (recommended: latest artifacts)
Framework - QBCore, ESX, or QBox
Required Resources:
ox_lib - Required library
dusa_bridge - Framework bridge
Optional Resources:
MugShotBase64 - For hunting license ID cards
Step-by-Step Installation
Step 1: Download the Resource
Download the
dusa_huntingresourceExtract the archive to your server's
resourcesfolderEnsure the folder name is
dusa_hunting(without any version numbers)
Step 2: Install Dependencies
Install ox_lib:
Download from: https://github.com/overextended/ox_lib/releases
Place in your
resourcesfolderAdd to
server.cfg:ensure ox_lib
Install dusa_bridge:
Download from: https://github.com/D-Development-FiveM/dusa_bridge
Place in your
resourcesfolderAdd to
server.cfg:ensure dusa_bridge
(Optional) Install MugShotBase64:
Download from: https://github.com/BaziForYou/MugShotBase64
Place in your
resourcesfolderAdd to
server.cfg:ensure MugShotBase64
Step 3: Database Setup
Import the SQL file to create necessary tables:
-- The script will auto-create tables on first run -- Or manually import the provided SQL fileTables created:
hunting_data- Player hunting progress and levelshunting_quests- Player quest progress
Step 4: Add Items to Your Inventory
Add the following items to your inventory system's item definitions:
Weapons
['WEAPON_DHR31'] = {
label = 'Hunting Rifle',
weight = 5000,
type = 'weapon',
ammotype = 'AMMO_SNIPER',
image = 'WEAPON_DHR31.png',
unique = true,
useable = false,
description = 'A powerful hunting rifle'
}Ammunition
['ammo-heavysniper'] = {
label = 'Heavy Sniper Ammo',
weight = 100,
type = 'item',
image = 'ammo-heavysniper.png',
unique = false,
useable = true,
description = 'Ammunition for hunting rifles'
}Tools & Equipment
['hunting_license'] = {
label = 'Hunting License',
weight = 50,
type = 'item',
image = 'hunting_license.png',
unique = true,
useable = true,
description = 'Official hunting license'
},
['hunting_bait'] = {
label = 'Hunting Bait',
weight = 100,
type = 'item',
image = 'hunting_bait.png',
unique = false,
useable = true,
description = 'Bait to attract animals'
},
['hunting_trap'] = {
label = 'Hunting Trap',
weight = 500,
type = 'item',
image = 'hunting_trap.png',
unique = false,
useable = true,
description = 'Trap for catching animals'
},
['binocular'] = {
label = 'Binoculars',
weight = 200,
type = 'item',
image = 'binocular.png',
unique = false,
useable = true,
description = 'For scouting animals'
},
['hunting_laptop'] = {
label = 'Hunting Laptop',
weight = 1000,
type = 'item',
image = 'hunting_laptop.png',
unique = false,
useable = true,
description = 'Laptop for environmental analysis'
},
['campfire'] = {
label = 'Campfire',
weight = 500,
type = 'item',
image = 'campfire.png',
unique = false,
useable = true,
description = 'Portable campfire'
},
['primitive_grill'] = {
label = 'Primitive Grill',
weight = 800,
type = 'item',
image = 'primitive_grill.png',
unique = false,
useable = true,
description = 'Basic cooking grill'
},
['advanced_grill'] = {
label = 'Advanced Grill',
weight = 1200,
type = 'item',
image = 'advanced_grill.png',
unique = false,
useable = true,
description = 'Advanced cooking grill'
}Animal Meats & Products
Step 5: Server Configuration
Add to your server.cfg:
# Make sure dependencies are started first
ensure ox_lib
ensure dusa_bridge
# Optional
# ensure MugShotBase64
# Start the hunting resource
ensure dusa_huntingImportant: The order matters! Dependencies must be started before dusa_hunting.
Step 6: Configure the Script
Navigate to
resources/dusa_hunting/configurations/Edit the configuration files:
config_shared.lua- Shared configuration (species, shop, quests, etc.)config_client.lua- Client-side configuration (hunting zones, areas, etc.)config_server.lua- Server-side configuration (rewards, levels, etc.)
Configure hunting zones in
config_client.lua:HuntingZones = { ['HuntingZone1'] = { name = 'Deer Zone', type = 'deer', coords = vec3(-575.706, 5460.014, 60.558), range = 250.0, animal = { model = 'a_c_deer', maxCount = 12, xp = 10, canAttack = false, isFleeing = false, } }, -- Add more zones... }Configure shop location in
config_shared.lua:Shared.Shop = { Ped = { model = 'a_m_m_hillbilly_01', coords = vec4(-675.868, 5839.285, 17.320, 134.746), -- ... } }
Step 7: Restart Your Server
Restart your FiveM server
Check the console for any errors
Join the server and test the hunting system
Step 8: Verify Installation
Check for hunting shop NPC at the configured location
Test buying hunting equipment
Visit a hunting zone and verify animals spawn
Hunt an animal to test the complete workflow
Post-Installation
Optional: Customize Localization
Edit locale files in resources/dusa_hunting/locales/:
en.json- English (default)tr.json- Turkish
Change locale in config_shared.lua:
Shared.Locale = 'en' -- or 'tr'Optional: Add Custom Animals
See the Configuration Guide for adding custom animal types.
Optional: Vehicle Keys Integration
The script supports multiple vehicle key systems. If you use one, it will automatically integrate. Supported systems:
dusa_vehiclekeys
wasabi_carlock
qb-vehiclekeys
qs-vehiclekeys
vehicles_keys
ak47_vehiclekeys
Renewed-Vehiclekeys
Troubleshooting
If you encounter issues during installation, see the Common Issues guide.
Next Steps
Review the API Reference for integration with other scripts
Check the Configuration Guide for customization options
Join the support Discord for help and updates
Last updated