Installation Guide

Prerequisites

Before installing the CAS Advanced Hunting System, ensure you have the following:

• RedM Server with FXServer

• VORP Core - Latest version

• VORP Inventory - Latest version

• oxmysql - Database resource

• cas_fwlibs - Framework library

---

Step 1: Database Setup

Import the hunting.sql file into your database. This will create:

Tables Created

-- Main XP storage table
CREATE TABLE IF NOT EXISTS cas_hunting_xp (
  charid INT NOT NULL,
  xp INT NOT NULL DEFAULT 0,
  trace INT NOT NULL DEFAULT 0,
  language VARCHAR(10) NOT NULL DEFAULT 'en',
  language_selected TINYINT(1) NOT NULL DEFAULT 0,
  PRIMARY KEY (charid)
);

-- Legacy progress table (optional)
CREATE TABLE IF NOT EXISTS hunter_progress (
  charidentifier VARCHAR(64) NOT NULL,
  level INT UNSIGNED NOT NULL DEFAULT 1,
  xp INT UNSIGNED NOT NULL DEFAULT 0,
  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (charidentifier)
);

Items Added

The SQL file will also add the following bait items to your inventory:

Item Name	Label	Limit
bait_corn	Dried Corn Bait	10
bait_apples	Fresh Apple Bait	10
bait_salt	Salt Lick Block	5
bait_meat	Raw Meat Scraps	10
bait_blood	Blood Trail Lure	5
bait_legendary	Legendary Bait	3
bait_grain	Grain Mix	15
bait_seeds	Premium Seeds	10
bait_exotic	Exotic Pheromone	5

---

Step 2: Add Hunting Map Item

Add the hunting map item to your items table:

INSERT INTO `items` (`item`, `label`, `limit`, `can_remove`, `type`, `usable`)
VALUES ('huntingmap', 'Hunting Contract Map', 1, 1, 'item_standard', 1)
ON DUPLICATE KEY UPDATE `label` = VALUES(`label`);

---

Step 3: Resource Installation

1. Extract the resource folder to your resources directory

2. Rename the folder to cas-hunting (or your preferred name)

3. Ensure the folder structure looks like this:

cas-hunting/
├── client.lua
├── client_bait.lua
├── client_killcam.lua
├── client_tracking.lua
├── config.lua
├── fxmanifest.lua
├── hunting.sql
├── language_client.lua
├── locale_helper.lua
├── locales.lua
├── locales/
│   ├── en.lua
│   ├── tr.lua
│   ├── fr.lua
│   └── de.lua
├── nui/
│   ├── index.html
│   ├── script.js
│   ├── style.css
│   └── assets/
├── server.lua
├── server_bait.lua
├── server_locale.lua
├── server_tracking.lua
└── sv_variables.lua

---

Step 4: Server Configuration

Add the resource to your server.cfg:

# Ensure dependencies are loaded first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure cas_fwlibs

# Start hunting system
ensure cas-hunting

---

Step 5: Verify Installation

1. Start your server

2. Connect to the game

3. Go to a hunting location (default: near Valentine)

4. Press G to open the hunting menu

If you see the hunting menu, the installation was successful!

---

Common Installation Issues

"cas_fwlibs export cannot be fetched"

• Ensure cas_fwlibs is started before cas-hunting

• Check that cas_fwlibs is properly installed

Database errors

• Verify oxmysql is configured correctly

• Check database credentials in server.cfg

• Ensure tables were created successfully

NUI not loading

• Clear browser cache (F8 console: clear)

• Verify nui/ folder exists with all files

• Check for JavaScript errors in F8 console

Items not working

• Run the SQL file again to ensure items exist

• Restart vorp_inventory after adding items

• Check item names match exactly

---