❓F.A.Q

How do I do it? What is it and what does it do?

🔩 Resmon Values

Client Side

Default 0.00 If you are not in any hunting area.

If you are in a hunting area 0.01 (Constant)

Server Side

It works with a default value of 0.00

When the areas are completely filled with animals and actively hunted, it varies between 0.00 and 0.02. The server was tested under load with 400 real players.

⚙️ Job Center

Job Required / Must be a job

  • For this go to wais-hunting/config.lua.

  • Find the variable [“required”] = false and change it to true.

  • This way, only people with this job will be able to do the job.

Change the Ped Model / Location

  • For this go to wais-hunting/config.lua.

  • ✔️ Change the Ped Model

    • Edit the "model" field and replace it with any ped model name you want.

    • ["model"] = "mp_m_exarmy_01",

  • ✔️ Change the Ped Location

    • Update the "coords" value with the new position (x, y, z, heading).

🔢 Level System

How to Create a New Level?

  • For this go to wais-hunting/config.lua.

  • To create a new level, all you need to do is copy one of the lines from the Config.Levels[“levels”] list, paste it below, and edit the three fields:

  • xp: The total experience points required to reach this level.

  • level: The player's level number.

  • multiplier: This level's special reward multiplier.

What is a Multiplier?

  • The Multiplier applies an additional multiplier to the rewards the player receives upon reaching that level.

  • This multiplier directly affects money, XP, or other rewards.

🧭 Command Configuration

How does it work?

The Config.Commands section defines all the usable commands for the hunting system. Each command has three main properties:

  • command → The actual command players will type in chat.

  • description → A short explanation of what the command does.

  • permission → Who is allowed to use the command.

If permission = nil, anyone can use the command. If permission = "group.admin", only admins (or the group you configured) can use it.

🔪 Knife required for skinning

How do I do it?

  • For this go to wais-hunting/config.lua.

  • Find the [“knife”] table within the Config.Skinning table.

  • Replace the “WEAPON_KNIFE” item within [“name”] with the name of the knife you want.

  • Change the false value of the [“must”] = false variable to true.

📦Giveable Items

How do I add/change?

  • For this go to wais-hunting/config.lua.

  • Go to the Config.StartingItems table. This table type is an Array.

  • Place one comma at the end of the last added item and create a new object.

  • [“name”] = ‘ITEM_NAME’ This variable holds the name of the item to be assigned. Enter the item name where it says “ITEM_NAME”.

  • If [“amount”] = 1, this is the quantity to be given for this item.

  • The selected lines in the example below show the correct syntax and appearance that should be visible when newly added.

🚗 Vehicle / Change Model, Distance or Out Coords

How does the model change?

  • For this go to wais-hunting/config.lua.

  • Find the Config.Vehicle table and go to that section.

  • [“model”] = “mesa3”, This is the default vehicle model. Enter the name of the vehicle model you want to change in the section that says mesa3. Vehicle models

How does Distance Control change?

  • For this go to wais-hunting/config.lua.

  • Find the Config.Vehicle table and go to that section.

  • [“maxDistance”] = 100.0, The default vehicle control distance is 100.0. This control exists to prevent vehicles from multiplying on the server and being abused.

  • 100.0 is the control distance. My recommendation is to enter a distance that is 1.25 or 1.5 times greater than the size of the area. 424.0 is the distance at which an entity will not be rendered by the client.

How does the spawn location change?

  • For this go to wais-hunting/config.lua.

  • Find the Config.Vehicle table and go to that section.

  • Find the [“outcoords”] table and add a comma to the rightmost vec4. There should not be more than one comma.

  • Go to the next line and enter the vec4 position of the vehicle's new location.

  • It should appear as shown in the selected line below.

🟡Zone - Add / Edit

Add New Zone

Step 1: Locate the Configuration File

Open the config.lua file and find the Config.Zones section (around line 115).

Step 2: Understanding Zone Structure

Each hunting zone contains the following properties:

Property
Type
Description

coords

vector3

Center coordinates of the hunting zone

radius

number

Radius of the hunting zone in meters

maxAnimals

number

Maximum number of animals that can spawn in this zone

removeAnimal

number

Time in milliseconds before dead animals are removed

spawnInterval

number

Time in milliseconds between animal spawns

blips

table

Blip settings for the map marker

animals

table

List of animals that can spawn in this zone

Step 3: Copy the Zone Template

Copy the template below and paste it at the end of the Config.Zones table (before the closing }):

Step 4: Configure Your Zone

Finding Coordinates

  1. Go to your desired location in-game

  2. Use a command or script to get your current coordinates

  3. Replace vector3(0.0, 0.0, 0.0) with your coordinates

Example: vector3(-1234.56, 4567.89, 50.12)

Adjusting the Radius

The radius value determines the size of your hunting zone:

  • Small zone: 40.0 - 60.0 meters

  • Medium zone: 60.0 - 100.0 meters

  • Large zone: 100.0+ meters

Setting Animal Limits

Adjust maxAnimals based on your zone size:

  • Small zone: 10-15 animals

  • Medium zone: 20-25 animals

  • Large zone: 30+ animals

Configuring Spawn Timing

To change these values:

  • 0.5 = 0.5 minutes (30 seconds)

  • 1.0 = 1 minute (60 seconds)

  • 2.5 = 2.5 minutes (150 seconds)

Step 5: Adding Animals to Your Zone

Available Animals

Model Name
Animal Type
Behavior

a_c_deer

Deer

Passive

a_c_boar

Boar

Can attack

a_c_pig

Pig

Passive

a_c_rabbit_01

Rabbit

Passive

a_c_mtlion

Mountain Lion

Can attack

Understanding Rarity

⚠️ Important: The total rarity of all animals in a zone must equal 1.0 (100%)

Example:

Attack Behavior

For aggressive animals, you can set attack probability:

Step 6: Complete Example

Here's a complete example of a new hunting zone:

Step 7: Save and Restart

  1. Save the config.lua file

  2. Restart your resource: restart wais-hunting

  3. The new zone will now be active!

What is maxAnimals?

  • Maximum number of animals that can be present in the zone

  • The number you will enter here is the maximum number of animals allowed for this area.

  • When the maximum number of animals is reached, no new animals will spawn. Animals must be killed to change the animal population inside. Thus, as the number of animals decreases, new animals will spawn.

What is removeAnimal?

The deletion period for animals that have died but for which no action has been taken. If an animal dies and is not skinned, it will be deleted within this period.

  • 0.5 * 60 * 1000 equals 30 seconds. It works as follows: Minute * 60 * 1000

  • If no action is taken for an animal that is killed or dies naturally within the specified period, it will be automatically deleted.

  • The reason for this is to prevent dead animals that have not undergone any processing from creating pollution and causing an unsightly appearance.

What is spawnInterval?

It is a set time cycle for spawning new animals in the area.

  • If the specified number of animals is not present in the area after each specified period, a new animal spawns.

📋Missions Add / Edit

Add Mission

Step 1: Locate the Configuration File

Open the config.lua file and find the Config.Missions section (around line 327).

Step 2: Understanding Mission Structure

Each hunting mission contains the following properties:

Property
Type
Description

label

string

The name of the mission displayed to players

image

string

URL to an image representing the mission

description

string

A brief description of what the mission involves

rewards

table

Contains money and XP rewards for completion

rewards.money

number

Amount of money awarded upon completion

rewards.xp

number

Amount of experience points awarded

animal

string

The model name of the animal to be hunted

requiredLevel

number

Minimum hunting level required to start this mission

animalsToKill

number

Number of animals that must be killed to complete

Step 3: Copy the Mission Template

Copy the template below and paste it at the end of the Config.Missions table (before the closing }):

Step 4: Configure Your Mission

Setting the Mission Name

The label is what players will see in the mission menu:

Best Practices:

  • Keep it short and clear (2-4 words)

  • Include the animal name

  • Add difficulty indicator if needed (I, II, Expert, Master, etc.)

Examples:

  • "Deer Hunting"

  • "Boar Hunt II"

  • "Expert Predator Hunt"

  • "Legendary Mountain Lion"

Adding a Mission Image

The image field requires a direct URL to an image:

Recommended Image Sources:

  • Direct image URLs (must end in .jpg, .png, .webp)

  • Imgur links

  • GitHub user-content URLs

  • Your own CDN/hosting

Image Requirements:

  • Must be a direct link to the image file

  • Recommended size: 800x600 or similar aspect ratio

  • Formats: JPG, PNG, WEBP

Example URLs:

Writing a Description

The description should briefly explain what the mission involves:

Good Descriptions:

  • "Hunt deer in the forest area." ✅

  • "Track and hunt dangerous mountain lions. Be careful!" ✅

  • "An expert-level deer hunting mission." ✅

  • "Hunt multiple predators. Extreme caution required." ✅

Avoid:

  • Too long descriptions (keep under 100 characters)

  • Technical jargon

  • Spoiling rewards in the description

Setting Rewards

Rewards consist of money and experience points:

Reward Balancing Guide:

Mission Level
Money Range
XP Range
Animals to Kill

Beginner (1-2)

$150-$600

150-450

3-8

Intermediate (3-5)

$700-$1500

500-1400

8-15

Advanced (6-8)

$1600-$3000

1500-2500

15-25

Expert (9-10)

$3100-$6000

2600-4000

25-30

Reward Formula:

Important: If Config.SplitMissionRewards = true, these rewards will be divided among group members!

Choosing the Animal

The animal field specifies which animal model to hunt:

Available Animals:

Model Name
Animal
Difficulty
Behavior

a_c_deer

Deer

Easy

Passive, runs away

a_c_rabbit_01

Rabbit

Easy

Passive, fast

a_c_pig

Pig

Easy

Passive, slow

a_c_boar

Boar

Medium

Can attack

a_c_mtlion

Mountain Lion

Hard

Aggressive

Selection Tips:

  • Easy missions: a_c_deer, a_c_rabbit_01, a_c_pig

  • Medium missions: a_c_boar

  • Hard missions: a_c_mtlion

Setting Required Level

The requiredLevel determines when players can access the mission:

Level Progression Guide:

Level
Mission Difficulty
Suggested Animals

1

Beginner

Deer, Rabbit, Pig

2-3

Easy

Deer, Boar

4-5

Intermediate

Boar, Mountain Lion

6-7

Advanced

All animals

8-9

Expert

Mountain Lion, Boar

10

Master/Legendary

Mountain Lion

Best Practices:

  • Level 1: Always have 2-3 missions available

  • Progressive difficulty: Each level should have 1-2 new missions

  • Mix animals: Don't make all missions for one animal type

Setting Animals to Kill

The animalsToKill field determines how many animals must be hunted:

Balancing Guidelines:

Animal Type
Easy (Lv 1-3)
Medium (Lv 4-6)
Hard (Lv 7-10)

Deer

5-10

10-20

20-30

Rabbit

5-12

12-25

25-35

Pig

3-8

8-15

15-25

Boar

5-10

10-20

20-35

Mountain Lion

3-5

5-10

10-20

Considerations:

  • Passive animals (deer, rabbit, pig): Can have higher kill counts

  • Aggressive animals (boar, mountain lion): Lower kill counts

  • Spawn rate: Check your zone's spawnInterval - longer intervals need fewer kills

  • Group play: Higher kill counts work well for groups

💰Rewards

Items given by animals

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.Rewards table.

  • If you want to change the items given by an animal, look up the animal's model name in this table. Example: a_c_boar Result: joaat(“a_c_boar”).

  • The table for the animal you found contains an items table. This items table is of type array. Here, you can create a new item or edit the item name.

  • name = “ITEM_NAME”, amount = 1 - The item name should be entered where it says ITEM_NAME. The amount is the quantity of the item that will be given when this animal's skin is removed.

Item selling price

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.Rewards table.

  • This table shows the selling price of items provided for skinned animals.

  • [“ITEM_NAME”] = 10, works as follows. ITEM_NAME => is the name of the item to be sold. 10 is the selling price of the item.

🗒Stepper Widget / Box on the left side of the screen

How can i disable?

  • For this go to wais-hunting/config.lua.

  • Go to the Config.StepperWidget table

  • Find the variable [“show”] = true. Change the true value to false.

Change Key

  • For this go to wais-hunting/config.lua.

  • Go to the Config.StepperWidget table

  • [“label”] = “B”, indicates the button that will only appear in this box. It is the name that identifies the button on the interface.

  • [“key”] = “B”, This variable is the name of the key that will be detected by the script in Fivem. You can find these keys here

📍Animal Blips

Disable Animal Blips

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.AnimalBlipstable.

  • Find the variable [“enable”] = true. Change the value from true to false. This will disable the animals from appearing as blips on the map.

🧑‍🧒‍🧒 Group / Player Limit / Split Rewards Etc.

Player Limit

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.GroupPlayerLimit variable.

  • Config.GroupPlayerLimit = 4 The number 4 indicates the maximum number of users a group can have.

  • 4 You can lower or raise the writing section. This allows you to adjust the maximum number of people.

Split Rewards

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.SplitMissionsRewards variable.

  • If you set it to true, the total reward from the task is divided by the number of people in the group, and the reward per person is delivered. If you set it to false, the reward is given directly to everyone in the group in the specified amount.

Player Blips

  • For this go to wais-hunting/config.lua.

  • To do this, go to the Config.GroupMemberBlips variable.

  • If you set it to true, group members' blips will be visible on the map. If you set it to false, group members' blips will not be shown.

📛 Weapons / Animals become invisible

  • The reason for this issue is a script that checks for anti-cheat or blacklisted weapons or peds.

  • Find the script that detects anti-cheat or blacklist and remove the blacklisted weapon for weapon_musket.

  • For animal models, if there is a file like Config, remove the animal models or allow animal models if there is an option.

  • Animal ped models:

🛡Protection from cheaters

  • All items and events such as giving money are completely protected from cheats.

  • Some cheaters have been prevented from rounding up animals and illegally killing them all at once.

1 - Animals / Missions / Skinning

  • When the script starts, animals spawn in designated areas with a random rarity value. ( You are not required to be present in the animal area specified in your mission at all times. )

  • You cannot skin animals shot by other people. You can only skin animals shot by you or your group.

  • Animals may be shot freely and skinned; these procedures may be performed without being assigned a mission.

  • For the animal population in the area to change, the existing animals must die.

  • If you kill an animal and do not begin skinning it within 30 seconds by default, it will be automatically deleted.

2 - Vehicle Actions

  • If you move 100 meters (default), away from the vehicle your vehicle will be automatically deleted after 50 seconds. To avoid polluting the environment and prevent certain vehicle issues.

  • When a vehicle is created or deleted, the Config.VehicleAction function will be triggered, and fuel operations will be performed using the vehicle key.

  • After entering the area, you can take your weapon from the vehicle using [TARGET]. The weapon cannot be returned! (The weapon will be automatically deleted when you leave the area.)

3 - Group

  • To create any group, you must enter the Server ID (Source) of the person you are inviting. The group will be created once the other party accepts.

  • The group includes in-game character names, number of animals killed, level, and Steam profile picture.

  • If the group owner leaves the group, one of the remaining users in the group is randomly assigned as the owner.

There are no more available yet, please open a ticket if the topics here are not suitable for what you are looking for.

Who developed it / How can I get help

You can recognise our script developers by the short names of the script. Scripts with short name ‘Wais’ are made by Ayazwai.

You can visit our Discord address to ask questions in your mind / To get support

PreviousInstall Job / ItemsNextOverview

Last updated