FAQ & Troubleshooting

Common questions and solutions.

---

Installation Issues

Q: Resource won't start, "cas_fwlibs export cannot be fetched"

A: Make sure cas_fwlibs starts before cas-hunting in your server.cfg:

ensure cas_fwlibs
ensure cas-hunting

---

Q: Database errors on startup

A: Check these common issues:

1. oxmysql not configured:

   set mysql_connection_string "mysql://user:password@localhost/database"

2. Tables not created:

   • Import hunting.sql manually

   • Check for SQL syntax errors in your database client

3. Character encoding:

   • Ensure database uses utf8mb4

---

Q: NUI not showing / blank screen

A: Try these solutions:

1. Clear NUI cache:

   • Press F8

   • Type clear

   • Restart resource

2. Check file permissions:

   • Ensure nui/ folder is readable

   • All files should be present

3. Check browser console:

   • Press F8

   • Look for JavaScript errors

   • Common: missing files, syntax errors

4. Verify fxmanifest.lua:

   ui_page 'nui/index.html'
   
   files {
       "nui/**/*",
   }

---

Q: Items not appearing in inventory

A:

1. Run SQL again:

   INSERT INTO `items` ...
   ON DUPLICATE KEY UPDATE ...

2. Restart vorp_inventory after adding items

3. Check item names match exactly (case-sensitive)

---

Gameplay Issues

Q: Animals not spawning

A: Check these:

1. Contract accepted?

   • Must accept a contract first

   • Check for error messages

2. At correct location?

   • Go to the marked area on map

   • Within radius of radiusCoords

3. Model valid?

   • Some animal models may not exist

   • Check F8 console for spawn errors

4. Debug mode:

   Config.DebugMode = true

   Check console for spawn messages.

---

Q: Animals spawning underground/in air

A: The system uses PlaceEntityOnGroundProperly(). If issues persist:

1. Location issue:

   • Adjust radiusCoords Z value

   • Choose flatter terrain

2. Radius too large:

   • Animals may spawn on slopes

   • Reduce radius value

---

Q: Kill camera not working

A: Check configuration:

Config.KillCam = {
    Enabled = true,  -- Must be true
    -- ...
}

Also check:

• Must be during active hunt

• Must kill a mission animal

• Cooldown between cams (default 2.5s)

---

Q: Tracking not finding animals

A:

1. Have active contract:

   /tracking

   Only works during hunts.

2. Animals in range:

   • Default range: 200 units

   • Check Config.TrackRadius

3. Tracking enabled:

   Config.TrackingSettings.Enabled = true

4. Debug with:

   /tracktest

---

Q: Bait not attracting animals

A:

1. In hunting area:

   • Must be within active contract radius

2. Animals nearby:

   • Check Config.BaitSystem.AttractionRadius

   • Default: 150 units

3. Bait consumed:

   • Item removed from inventory?

   • Check server console for errors

---

Q: XP not saving

A:

1. Check database connection

2. Force save:

   • XP saves every 60 seconds

   • Also saves on disconnect

   • Also saves on resource stop

3. Check character ID:

   -- Enable debug mode
   Config.DebugMode = true

   Look for "Could not get charid" errors.

4. Manual reload:

   /loadp

---

Q: Language not changing

A:

1. Valid language code:

   • Must exist in Config.Languages

   • Must have locales/xx.lua file

2. Reset and try again:

   /resetlang

3. Check database:

   SELECT * FROM cas_hunting_xp WHERE charid = YOUR_CHARID;

---

Performance Issues

Q: FPS drops during hunts

A:

1. Reduce animal counts:

   animals = {
       { model = "A_C_Deer_01", amount = { min = 1, max = 2 } },  -- Lower max
   }

2. Reduce tracking effects:

   Config.TrackingSettings.TrackTypes.FOOTPRINT.spawnInterval = 15000  -- Less frequent

3. Disable kill cam:

   Config.KillCam.Enabled = false

---

Q: Server performance issues

A:

1. Database optimization:

   • Ensure indexes exist

   • Check for slow queries

2. Reduce save frequency:

   • Default: 60 seconds

   • Located in server.lua CreateThread

3. Clean up on disconnect:

   • The system already cleans up

   • Check for orphaned data

---

Contract Issues

Q: Contract not completing

A:

1. Check requirements:

   • Correct animal type?

   • Perfect pelt required?

   • Required kill count met?

2. Deliver at NPC:

   • Go to hunting NPC

   • Press L to deliver

3. Check what you're carrying:

   • Must hold/have on horse

   • Correct species

---

Q: "Trophies don't match contract"

A:

The delivered animal doesn't match the contract animals.

1. Check contract animals:

   • Look at contract details in menu

   • Kill the correct species

2. Species hash mismatch:

   • Some animals have multiple variants

   • Check config.lua species IDs

---

Q: Perfect pelt requirement failing

A:

Contract requires requirePerfectPelts = true:

1. Hunt 3-star animals

2. Use correct weapon/ammo

3. One clean headshot

If still failing, the quality detection may need adjustment in config.

---

Common Error Messages

"No active contract"

• Accept a contract from the hunting menu first

"Mission not found"

• Invalid contract data

• Check Config.Contracts for errors

"You must be in an active hunting area"

• Go to the marked hunting zone on your map

• Check minimap for the mission area

"This contract requires perfect pelts"

• Only 3-star carcasses accepted

• Use proper hunting technique

"No animals nearby to attract"

• Move closer to spawned animals

• Check if animals exist with /tracktest

---

Debug Tools

Enable Debug Mode

Config.DebugMode = true

Useful Commands

Command	Purpose
/tracktest	Show tracking system status
/toggledebug	Toggle NUI debug overlay
/loadp	Reload player data
/hlset 1000	Set XP for testing
/traceset 500	Set trace XP for testing

Console Output

With DebugMode = true, look for:

• [CAS Debug] - General debug

• [Tracking] - Tracking system

• [cas-hunting] - Server events

---

Getting Help

If your issue isn't covered here:

1. Enable debug mode and collect error messages

2. Check F8 console for errors

3. Check server console for server-side errors

4. Provide:

   • Error messages

   • Steps to reproduce

   • Your configuration changes

   • Server/resource versions

---

Quick Reference

Default Keys

Key	Action
G	Open menu
H	Cancel contract
J	Bait shop
L	Deliver
K	Hunter vision (hold)

Tiers & Levels

Tier	Levels
Simple	1-4
Advanced	3-8
Epic	6+
Legendary	10+

XP System

Action	XP
Kill	1-15 (random)
Death penalty	-25
Track found	5 (base)