QBCore

QBCore Framework Express Installation

IMPORTANT NOTICE

If you are using any of the listed inventories below click on their setup link and follow those instructions. If you do not see your inventory, then follow the setup below.

Step 1.

  1. qb-core/shared/items.lua - (End of Script)

weapon_huntingrifle = { name = 'weapon_huntingrifle', label = 'Hunting Rifle', weight = 1000, type = 'weapon', ammotype = 'AMMO_HUNTINGRIFLE', image = 'weapon_huntingrifle.png', unique = true, useable = true, description = 'A high-velocity rifle designed for precise, long-range shots at game. Ideal for hunters seeking to take down large prey from a distance.' },
weapon_crossbow = { name = 'weapon_crossbow', label = 'Hunting Crossbow', weight = 1000, type = 'weapon', ammotype = 'AMMO_ARROW', image = 'weapon_crossbow.png', unique = true, useable = true, description = 'A precision weapon favored by skilled hunters. Fires arrows with remarkable accuracy, ideal for hunters who value skill and control over brute force.' },
gg_hunting_arrowammo = { name = 'gg_hunting_arrowammo', label = 'Arrow Ammo', weight = 20, type = 'item', image = 'gg_hunting_arrowammo.png', unique = false, useable = true, shouldClose = true, description = 'Specially crafted arrows designed for use with the hunting crossbow. Built for precision and power, ideal for taking down animals quietly.' },
gg_hunting_rifleammo = { name = 'gg_hunting_rifleammo', label = 'Hunting Rifle Ammo', weight = 200, type = 'item', image = 'gg_hunting_rifleammo.png', unique = false, useable = true, shouldClose = true, description = 'High-powered ammunition for the hunting rifle. Designed for long-range accuracy and the ability to pierce through tough animal hides.' },

gg_hunting_animaltracker = { name = 'gg_hunting_animaltracker', label = 'Advanced Animal Tracker', weight = 1000, type = 'item', image = 'gg_hunting_animaltracker.png', unique = true, useable = true, shouldClose = true, description = 'A sophisticated device used to track animal movements across the terrain, aiding hunters in locating their prey.' },
gg_hunting_animaltrap = { name = 'gg_hunting_animaltrap', label = 'Heavy-Duty Animal Trap', weight = 1000, type = 'item', image = 'gg_hunting_animaltrap.png', unique = false, useable = true, shouldClose = true, description = 'A durable trap designed to capture animals alive for easier transportation or use as bait.' },
gg_hunting_campfire = { name = 'gg_hunting_campfire', label = 'Portable Campfire', weight = 1000, type = 'item', image = 'gg_hunting_campfire.png', unique = false, useable = true, shouldClose = true, description = 'A compact campfire setup for warming up, cooking, and providing light during long hunting expeditions.' },
gg_hunting_meat = { name = 'gg_hunting_meat', label = 'Fresh Animal Meat', weight = 100, type = 'item', image = 'gg_hunting_meat.png', unique = false, useable = false, shouldClose = true, description = 'Freshly harvested meat from a hunt, ideal for cooking or trade.' },
gg_hunting_cookedmeat = { name = 'gg_hunting_cookedmeat', label = 'Cooked Game Meat', weight = 50, type = 'item', image = 'gg_hunting_cookedmeat.png', unique = false, useable = false, shouldClose = true, description = 'Deliciously cooked meat, perfect for a meal during your hunting adventure.' },

gg_hunting_knife_01 = { name = 'gg_hunting_knife_01', label = 'Basic Hunting Knife', weight = 1000, type = 'item', image = 'gg_hunting_knife_01.png', unique = true, useable = true, shouldClose = true, description = 'A reliable, entry-level hunting knife ideal for basic butchering tasks.' },
gg_hunting_knife_02 = { name = 'gg_hunting_knife_02', label = 'Intermediate Hunting Knife', weight = 1000, type = 'item', image = 'gg_hunting_knife_02.png', unique = true, useable = true, shouldClose = true, description = 'A well-crafted hunting knife offering improved precision for more efficient butchering.' },
gg_hunting_knife_03 = { name = 'gg_hunting_knife_03', label = 'Premium Hunting Knife', weight = 1000, type = 'item', image = 'gg_hunting_knife_03.png', unique = true, useable = true, shouldClose = true, description = 'A top-tier hunting knife, designed for expert hunters, providing unmatched sharpness and durability for butchering.' },

gg_deer_hide_01 = { name = 'gg_deer_hide_01', label = 'Rough Deer Hide', weight = 1000, type = 'item', image = 'gg_deer_hide_01.png', unique = true, useable = false, shouldClose = true, description = 'A basic, coarse deer hide with minimal value.' },
gg_deer_hide_02 = { name = 'gg_deer_hide_02', label = 'Sturdy Deer Hide', weight = 1000, type = 'item', image = 'gg_deer_hide_02.png', unique = true, useable = false, shouldClose = true, description = 'A good-quality deer hide, suitable for crafting or trade.' },
gg_deer_hide_03 = { name = 'gg_deer_hide_03', label = 'Pristine Deer Hide', weight = 1000, type = 'item', image = 'gg_deer_hide_03.png', unique = true, useable = false, shouldClose = true, description = 'A high-quality, flawless deer hide highly valued by traders.' },

gg_boar_tusk_01 = { name = 'gg_boar_tusk_01', label = 'Rough Boar Tusk', weight = 1000, type = 'item', image = 'gg_boar_tusk_01.png', unique = true, useable = false, shouldClose = true, description = 'A basic, crude boar tusk with minimal value.' },
gg_boar_tusk_02 = { name = 'gg_boar_tusk_02', label = 'Sturdy Boar Tusk', weight = 1000, type = 'item', image = 'gg_boar_tusk_02.png', unique = true, useable = false, shouldClose = true, description = 'A sturdy boar tusk with a moderate value, suitable for crafting or trade.' },
gg_boar_tusk_03 = { name = 'gg_boar_tusk_03', label = 'Pristine Boar Tusk', weight = 1000, type = 'item', image = 'gg_boar_tusk_03.png', unique = true, useable = false, shouldClose = true, description = 'A high-quality boar tusk, highly valued by craftsmen and traders.' },

gg_rabbit_pelt_01 = { name = 'gg_rabbit_pelt_01', label = 'Rough Rabbit Pelt', weight = 1000, type = 'item', image = 'gg_rabbit_pelt_01.png', unique = true, useable = false, shouldClose = true, description = 'A basic rabbit pelt with minimal value.' },
gg_rabbit_pelt_02 = { name = 'gg_rabbit_pelt_02', label = 'Sturdy Rabbit Pelt', weight = 1000, type = 'item', image = 'gg_rabbit_pelt_02.png', unique = true, useable = false, shouldClose = true, description = 'A decent-quality rabbit pelt, suitable for crafting or trade.' },
gg_rabbit_pelt_03 = { name = 'gg_rabbit_pelt_03', label = 'Pristine Rabbit Pelt', weight = 1000, type = 'item', image = 'gg_rabbit_pelt_03.png', unique = true, useable = false, shouldClose = true, description = 'A high-quality rabbit pelt, highly valued by traders and craftsmen.' },

gg_cougar_claw_01 = { name = 'gg_cougar_claw_01', label = 'Rough Cougar Claw', weight = 1000, type = 'item', image = 'gg_cougar_claw_01.png', unique = true, useable = false, shouldClose = true, description = 'A basic cougar claw with minimal value.' },
gg_cougar_claw_02 = { name = 'gg_cougar_claw_02', label = 'Sturdy Cougar Claw', weight = 1000, type = 'item', image = 'gg_cougar_claw_02.png', unique = true, useable = false, shouldClose = true, description = 'A sturdy cougar claw, suitable for crafting or trade.' },
gg_cougar_claw_03 = { name = 'gg_cougar_claw_03', label = 'Pristine Cougar Claw', weight = 1000, type = 'item', image = 'gg_cougar_claw_03.png', unique = true, useable = false, shouldClose = true, description = 'A high-quality cougar claw, highly valued by traders and craftsmen.' },

gg_coyote_fangs_01 = { name = 'gg_coyote_fangs_01', label = 'Rough Coyote Fang', weight = 1000, type = 'item', image = 'gg_coyote_fangs_01.png', unique = true, useable = false, shouldClose = true, description = 'A basic coyote fang with minimal value.' },
gg_coyote_fangs_02 = { name = 'gg_coyote_fangs_02', label = 'Sturdy Coyote Fang', weight = 1000, type = 'item', image = 'gg_coyote_fangs_02.png', unique = true, useable = false, shouldClose = true, description = 'A sturdy coyote fang, suitable for crafting or trade.' },
gg_coyote_fangs_03 = { name = 'gg_coyote_fangs_03', label = 'Pristine Coyote Fang', weight = 1000, type = 'item', image = 'gg_coyote_fangs_03.png', unique = true, useable = false, shouldClose = true, description = 'A high-quality coyote fang, highly valued by traders and craftsmen.' },

gg_salt_block_01 = { name = 'gg_salt_block_01', label = 'Basic Salt Block', weight = 100, type = 'item', image = 'gg_salt_block_01.png', unique = false, useable = true, shouldClose = true, description = 'A simple salt block used to attract animals.' },
gg_salt_block_02 = { name = 'gg_salt_block_02', label = 'Enhanced Salt Block', weight = 100, type = 'item', image = 'gg_salt_block_02.png', unique = false, useable = true, shouldClose = true, description = 'A refined salt block that draws in more animals.' },
gg_salt_block_03 = { name = 'gg_salt_block_03', label = 'Premium Salt Block', weight = 100, type = 'item', image = 'gg_salt_block_03.png', unique = false, useable = true, shouldClose = true, description = 'A high-quality salt block, highly effective at attracting animals.' },

gg_pug_bait_01 = { name = 'gg_pug_bait_01', label = 'Basic Pug Bait', weight = 100, type = 'item', image = 'gg_pug_bait_01.png', unique = false, useable = true, shouldClose = true, description = 'A simple and crude bait for attracting pugs.' },
gg_pug_bait_02 = { name = 'gg_pug_bait_02', label = 'Advanced Pug Bait', weight = 100, type = 'item', image = 'gg_pug_bait_02.png', unique = false, useable = true, shouldClose = true, description = 'A more effective bait to lure in pugs, with a stronger scent.' },
gg_pug_bait_03 = { name = 'gg_pug_bait_03', label = 'Specialized Pug Bait', weight = 100, type = 'item', image = 'gg_pug_bait_03.png', unique = false, useable = true, shouldClose = true, description = 'A premium bait crafted to attract the rarest of pugs.' },

gg_captured_rabbit = { name = 'gg_captured_rabbit', label = 'Captured Rabbit', weight = 5000, type = 'item', image = 'gg_captured_rabbit.png', unique = true, useable = true, shouldClose = true, description = 'A captured rabbit, perfect for luring carnivores as high-quality bait.' },
gg_captured_hen = { name = 'gg_captured_hen', label = 'Captured Hen', weight = 5000, type = 'item', image = 'gg_captured_hen.png', unique = true, useable = true, shouldClose = true, description = 'A captured hen, a tempting bait for larger predators seeking prey.' },
gg_captured_chickenhawk = { name = 'gg_captured_chickenhawk', label = 'Captured Chickenhawk', weight = 5000, type = 'item', image = 'gg_captured_chickenhawk.png', unique = true, useable = true, shouldClose = true, description = 'A captured chickenhawk, a rare and enticing bait that attracts powerful predators.' },

Step 2.

Step 3.

  1. qb-core/shared/weapons.lua - (End of Script)

   [`weapon_huntingrifle`] = { name = 'weapon_huntingrifle', label = 'Hunting Rifle', weapontype = 'Sniper Rifle', ammotype = 'AMMO_HUNTINGRIFLE', damagereason = 'Sniped / Picked off / Scoped' },
   [`weapon_crossbow`] = { name = 'weapon_crossbow', label = 'Hunting Crossbow', weapontype = 'Sniper Rifle', ammotype = 'AMMO_ARROW', damagereason = 'Sniped / Picked off / Scoped' },

Step 4.

  1. qb-weapons/config.lua - (Around Line 170) (Inside Config.DurabilityMultiplier)

weapon_huntingrifle = 0.15,
weapon_crossbow = 0.15,

Step 5.

  1. qb-weapons/client/recoil.lua - (Around Line 87) (Inside recoils table)

[`weapon_huntingrifle`] = 0.5,
[`weapon_crossbow`] = 0.05,

Step 6.

There are three unique versions of qb-weapons. To ensure proper setup, you’ll need to determine your version and follow the corresponding steps.

How to Identify Your Version

Follow the instructions below to determine which version you’re using. Once identified, follow the appropriate step for that version.

⚠️ Note: You only need to complete the step that matches your version!


How to Find Your qb-weapons Version

  1. Open qb-weapons/server/main.lua and search for AmmoTypes:

    • If you see a table, follow Step A.

  2. Open qb-weapons/config.lua and search for Config.AmmoTypes:

    • If you see a table, follow Step B.

  3. Open qb-weapons/server/main.lua and search for emp_ammo:

    • If you find a CreateUsableItem function, paste the code from Part C directly beneath it.


Step 6a

File: qb-weapons/server/main.lua Location: Around Line 217 (Inside AmmoTypes Table) Add the following entries:

gg_hunting_arrowammo = { ammoType = 'AMMO_ARROW', amount = 25 },
gg_hunting_rifleammo = { ammoType = 'AMMO_HUNTINGRIFLE', amount = 10 },

Step 6b

File: qb-weapons/config.lua Location: Around Line 12 (Inside Config.AmmoTypes Table) Add the following entries:

gg_hunting_arrowammo = { ammoType = 'AMMO_ARROW', amount = 25 },
gg_hunting_rifleammo = { ammoType = 'AMMO_HUNTINGRIFLE', amount = 10 },

Step 6c

File: qb-weapons/server/main.lua Location: Around Line 232

Paste the following code beneath the CreateUsableItem function:

QBCore.Functions.CreateUseableItem('gg_hunting_arrowammo', function(source, item)
    TriggerClientEvent('qb-weapons:client:AddAmmo', source, 'AMMO_ARROW', 25, item)
end)

QBCore.Functions.CreateUseableItem('gg_hunting_rifleammo', function(source, item)
    TriggerClientEvent('qb-weapons:client:AddAmmo', source, 'AMMO_HUNTINGRIFLE', 10, item)
end)

Last updated