Commands Reference

All available commands for players and administrators.

---

Player Commands

/tracking

Analyze nearby animal tracks during an active hunt.

/tracking

Requirements:

• Active hunting contract

• Tracking system enabled in config

What it does:

1. Activates Hunter Vision

2. Player crouches to inspect tracks

3. Provides information based on trace level:

   • Level 0: Animal species

   • Level 1: + Time since animal passed

   • Level 2: + Direction of travel

   • Level 3: + Distance to animal

   • Level 4: + Animal health/condition

   • Level 5: + Track quality assessment

---

/resetlang

Reset your language preference to the server default.

/resetlang

What it does:

• Resets language to Config.DefaultLanguage

• Shows language selection on next menu open

---

Admin Commands

Hunting XP Commands

/hlreset

Reset player's hunting XP to 0.

/hlreset

/hladd [amount]

Add hunting XP to yourself.

/hladd 100

/hlremove [amount]

Remove hunting XP from yourself.

/hlremove 50

/hlset [amount]

Set hunting XP to a specific value.

/hlset 500

---

Trace XP Commands

/tracereset

Reset your trace XP to 0.

/tracereset

/traceadd [amount]

Add trace XP to yourself.

/traceadd 50

/traceset [amount]

Set trace XP to a specific value.

/traceset 200

---

Debug Commands

/tracktest

Display tracking system debug information.

/tracktest

Output:

=== TRACKING SYSTEM DEBUG ===
isHuntingStarted: true
HunterVisionActive: false
SpawnedAnimals count: 5
ActiveTracks count: 12
Animals:
  #1: ped=12345, model=-541762431, dead=false, pos=(100.5, 200.3, 50.2)
  ...
Tracks:
  #1: type=FOOTPRINT, quality=Good, age=45.2s, pos=(98.1, 198.5, 50.0)
  ...
Vision Key (0x8AAA0AD4) pressed: false
============================

/toggledebug

Toggle the real-time debug overlay in NUI.

/toggledebug

Shows:

• Current weather and modifiers

• Trace level

• Hunter Vision status

• Active track count

• Last spawned track info

---

/loadp

Manually reload player XP data from database.

/loadp

Use case: If XP data didn't load properly on join.

---

Key Bindings

These are the default in-game prompts (not console commands):

Key	Action	When Visible
G	Open Hunting Menu	Near hunting NPC, no active contract
H	Cancel Contract	Near hunting NPC, active contract
L	Deliver Products	Near hunting NPC, active contract
J	Open Bait Shop	Near hunting NPC
K	Hunter Vision	During active hunt (if key toggle enabled)

---

Customizing Commands

Changing Command Names

In server_tracking.lua:

-- Change /tracking to /track
RegisterCommand("track", function()  -- Changed from "tracking"
    -- ...
end)

In config.lua:

Config.TrackingSettings = {
    Command = "track",  -- Changed from "tracking"
    -- ...
}

Adding Admin Checks

-- Example: Restrict XP commands to admins
RegisterCommand("hladd", function(source, args)
    local src = source

    -- Check if player is admin (your admin system)
    if not IsPlayerAdmin(src) then
        TriggerClientEvent("notify", src, "You don't have permission!")
        return
    end

    local amount = tonumber(args[1])
    if not amount then return end
    AddHuntingXp(src, amount)
end)

Adding Permission System

-- Using ace permissions
RegisterCommand("hladd", function(source, args)
    local src = source
    local amount = tonumber(args[1])
    if not amount then return end
    AddHuntingXp(src, amount)
end, true)  -- true = restricted

-- In server.cfg:
-- add_ace group.admin command.hladd allow

---

Command Arguments Reference

Command	Argument	Type	Required	Default
/hladd	amount	number	Yes	-
/hlremove	amount	number	Yes	-
/hlset	amount	number	Yes	-
/traceadd	amount	number	No	10
/traceset	amount	number	No	0

---

Troubleshooting

Command Not Working

1. Check console for errors (F8)

2. Verify resource is started

3. Check if command is registered:

   /help [command_name]

XP Not Saving

1. Use /loadp to reload data

2. Check database connection

3. Verify table exists in database

Tracking Not Working

1. Ensure you have an active hunting contract

2. Use /tracktest to debug

3. Check if Config.TrackingSettings.Enabled = true

---