Common Errors

Common Errors — Hunter Job | Quasar Store | Quasar Store

"You don't have the hunter job"

The player's job name is not a key in Config.HunterJob. The match is exact — hunter, not Hunter. On QBCore and Qbox the job must also exist in shared/jobs.lua before /setjob will hand it out — see Installation.

The mission will not start

The server checks every member before it starts and names the rule that failed:

One of the members does not have the level required — somebody is below the mission's levelRequired.
One of the members does not have the hunter job — somebody changed job after joining.
One of the members is already on a mission — they must finish or abandon it first.
Only the group leader can do that — a member pressed Start Mission; only the leader can.

An invitation is refused

Message	Means
The player is too far away	More than `Config.InviteDistance` (20 m) apart. Stand together, or raise it — `0` turns it off.
That player has just been invited, give them a moment	They have an unanswered invitation, or were invited by somebody in the last 10 seconds.
Slow down, you have just sent an invitation

Crew tiles show initials instead of faces

A face can only be photographed when that player is close enough to be drawn by your game. Anyone out of range gets their initials, and F8 says why with no mugshot for …. Nothing is broken — stand closer and reopen the panel.

The animals never appear

They spawn at their hunting ground, not near the employer — follow the circle on the map. If the circle is missing too, F8 explains:

Task 7 wants animal 'pig', which is not in Config.Animals. — a mission names an animal the config does not define. Fix the spelling or add the animal.
Animal model '…' never loaded. — the ped model in Config.Animals is wrong.

"The animal was not taken down with the appropriate weapon"

It was killed by something other than Config.HunterWeapon — another gun, a melee hit, a car, a fall — and the carcass was removed. Use the rifle, or set Config.HunterWeaponNeeded = false to accept any kill.

"You need a hunting tool" or "You don't have enough level to use hatchet"

Config.RequireToolToHarvestAnimal is on and the player carries neither tool — or only the hatchet, below Config.AxeRequiredLevel. A knife from the shop solves both.

"You are too far from the hunting ground"

The server measures from the animal's coords in Config.Animals, allowing Config.SpawnRadius + Config.HarvestZoneMargin (520 m). An animal that fled further than that cannot be claimed — raise the margin if your grounds are wide.

"Your mission does not ask for this animal" or "You have already harvested your share"

Each member may skin only the animals their mission names, and only as many of each as it asks for. The rest of the crew's counter still needs their own animals — the extra carcass is not worth anything.

"This item does not exist: rat_meat"

The drop is configured but your inventory has no such item. The server console names it each time it happens:

bash

[qs-hunter] rat_meat is configured as a drop but no such item exists in the inventory.

The player keeps the experience and the mission progress; only the item is lost. Add the items as shown in Installation and restart the inventory.

"Your inventory is full"

Nothing fitted, so nothing was given and the animal did not count towards the mission. Sell or drop something and skin the next one.

Pressing E over a carcass does nothing

Targeting is on — use the third eye; key prompts are not drawn with Config.Target = true.
The player is not on a mission, or the carcass belongs to a crew mate — each member can only skin the animals their own game spawned.
They pressed again too soon. Harvests are limited to one per animal harvest time.
They are more than 3 m from the body.

"This item does not exist: snp_ammo" when buying

The shop sells an item name your inventory does not use. Nothing was charged for that line, and the console says which one:

bash

[qs-hunter] snp_ammo is on sale in the shop but no such item exists in the inventory.

Almost always the ammo: on ox_inventory change the Ammo entry of Config.BuyItems to ammo-sniper.

"You don't have enough money" with money in the bank

The shop charges cash. To use the bank instead, change the account in the server bridge — Paying into the bank in Integrations shows the three lines.

The rifle has no ammunition

Only ox_inventory loads the rifle on purchase. Everywhere else, buy the Ammo pack beside it.

Mission pay never reaches the player's cash

qs-job-management is running, so the pay was handed to it — that is where to look. Sales and leaderboard prizes still pay cash.

The mountain lion items have no picture

The icons in the download are meat_mtlion.png and hide_mtlion.png. Point lion_meat and lion_hide at those names in your item list.

Key	Means
`NOTIFY_NOT_HUNTER`	No hunter job — or, when harvesting, not on a mission.
`NOTIFY_ALREADY_ON_MISSION` · `MEMBER_ALREADY_ON_MISSION`	The player, or a crew member, already has a hunt running.
`NOT_ENOUGH_LEVEL_MEMBERS` · `NOT_HUNTER_MEMBERS`	A crew member is below the level or without the job.
`NOT_PARTY_LEADER` · `MAX_MEMBERS_IN_PARTY`	Only the leader may do that · the crew is full.
`PLAYER_NOT_FOUND` · `PLAYER_ALREADY_IN_PARTY` · `PLAYER_ALREADY_INVITED`	Invitation refused: offline, in another crew, or invited moments ago.
`INVITE_TOO_SOON` · `NOTIFY_PLAYER_TOO_FAR`	The leader is inviting too fast · the player is out of invite range.
`NOTIFY_NOT_HUNTER_WEAPON`	Killed with the wrong weapon; the carcass is gone.
`NOTIFY_NOT_TOOL` · `NOT_ENOUGH_LEVEL_TO_USE_HATCHET`	A tool is required and the player has none they may use.
`NOTIFY_TOO_FAR_FROM_ANIMAL`	Outside the animal's hunting ground plus the margin.
`NOTIFY_ANIMAL_NOT_IN_MISSION` · `NOTIFY_ANIMAL_LIMIT_REACHED`	The mission does not want that animal · the player's share is done.
`NOTIFY_INVENTORY_FULL` · `NOTIFY_ITEM_DOES_NOT_EXIST`	No room for the item · the inventory has never heard of it.
`NOT_ENOUGH_MONEY`	The basket costs more than the player's cash.

Installation and Startup#

Common Errors

Installation and Startup#

Missions and Crews#

Harvesting#

Shop and Money#

Leaderboard#

Message Keys#