Configuration Guide

All configuration is done in config.lua. This guide explains every setting.

---

General Settings

Config = {}
Config.DevMode = false        -- Enable development features
Config.DebugMode = false      -- Enable debug prints in console
Config.DefaultLanguage = "en" -- Default language for new players

---

XP & Progression

-- Random XP gained per kill (1-15)
Config.HuntingXpPerKill = math.random(1,15)

-- XP lost when dying during a hunt
Config.HuntingXpDeathPenalty = 25

How Levels Work

• Level Calculation: level = floor(xp / 100) + 1

• Level 1: 0-99 XP

• Level 2: 100-199 XP

• Level 3: 200-299 XP

• And so on...

---

Keybinds

Config.keys = {
    ["G"] = 0x760A9C6F,  -- Open Hunting Menu
    ["H"] = 0x24978A28,  -- Cancel Contract
    ["J"] = 0xF3830D8E,  -- Open Bait Shop
    ["L"] = 0x80F28E95,  -- Deliver Products
}

Common Key Hashes

Key	Hash
E	0xCEFD9220
F	0xB2F377E8
G	0x760A9C6F
H	0x24978A28
J	0xF3830D8E
K	0x8AAA0AD4
L	0x80F28E95

---

Kill Camera

Config.KillCam = {
    Enabled = true,           -- Enable/disable kill cam
    TimeScale = 0.25,         -- Slow motion speed (0.1 = very slow)
    BulletTravelMs = 900,     -- Camera follow duration (ms)
    VictimHoldMs = 1200,      -- Hold on victim duration (ms)
    Fov = 45.0,               -- Field of view
    CooldownMs = 2500,        -- Cooldown between kill cams
    DisableControls = true    -- Disable player controls during cam
}

---

Tracking System

Config.TrackRadius = 200.0      -- Max distance to detect tracks
Config.TrackMinDistance = 3.0   -- Min distance between spawned tracks

Config.TrackingSettings = {
    Enabled = true,
    Command = "tracking",        -- Command to analyze tracks

    HunterVision = {
        Key = 0x8AAA0AD4,        -- K key by default
        UseKeyToggle = false,    -- Hold vs toggle
        MaxRange = 50.0,         -- Vision range
        TimeScale = 0.65,        -- Slow motion amount
        AutoInspectRange = 12.0, -- Auto-inspect nearby tracks
    },

    TrackTypes = {
        FOOTPRINT = {
            enabled = true,
            name = "Footprint",
            prop = "mp005_s_cardt_paw",
            spawnInterval = 10000,     -- Ms between spawns
            lifetime = {180, 300},     -- Seconds (min, max)
            detectRadius = 2.5,        -- Player detection radius
            spawnChance = 0.85,        -- 85% chance to spawn
        }
    },

    Quality = {
        POOR = { score = 1, alpha = 0.4, color = {r=150, g=150, b=150} },
        GOOD = { score = 2, alpha = 0.7, color = {r=200, g=200, b=100} },
        PERFECT = { score = 3, alpha = 1.0, color = {r=255, g=215, b=0} }
    },
}

---

Trace/Tracking Levels

Config.TraceSettings = {
    MaxLevel = 5,
    XpPerLevel = 100,

    XpGain = {
        Success = 5,                -- Base XP per track found
        QualityMultiplier = {
            Poor = 1.0,
            Good = 2.0,
            Perfect = 3.0
        },
    },

    Levels = {
        [0] = { title = "Novice Tracker",    details = {"species"} },
        [1] = { title = "Amateur Tracker",   details = {"species", "time"} },
        [2] = { title = "Skilled Tracker",   details = {"species", "time", "direction"} },
        [3] = { title = "Expert Tracker",    details = {"species", "time", "direction", "distance"} },
        [4] = { title = "Master Tracker",    details = {"species", "time", "direction", "distance", "state"} },
        [5] = { title = "Legendary Scout",   details = {"species", "time", "direction", "distance", "state", "quality"} },
    }
}

---

Weather Effects on Tracking

Config.TrackingSettings.WeatherEffects = {
    rain = { qualityBonus = 1.4, lifetimeMultiplier = 0.6 },
    snow = { qualityBonus = 1.5, lifetimeMultiplier = 1.8 },
    sunny = { qualityBonus = 1.0, lifetimeMultiplier = 1.0 },
    fog = { qualityBonus = 0.8, lifetimeMultiplier = 1.3 },
    -- ... more weather types
}

• qualityBonus: Multiplier for track quality

• lifetimeMultiplier: Multiplier for how long tracks last

---

Predator Animals

Config.Predators = {
    [GetHashKey("A_C_BearBlack_01")] = true,
    [GetHashKey("A_C_Bear_01")] = true,
    [GetHashKey("A_C_Cougar_01")] = true,
    [GetHashKey("A_C_Panther_01")] = true,
    [GetHashKey("A_C_Wolf")] = true,
    [GetHashKey("A_C_Alligator_01")] = true,
    -- Add more predators here
}

Predators will attack players instead of fleeing.

---

Languages

Config.Languages = {
    ["en"] = "English",
    ["tr"] = "Turkce",
    ["fr"] = "Francais",
    ["de"] = "Deutsch",
}

To add a new language:

1. Add entry here

2. Create locales/xx.lua file

3. Add flag image to nui/assets/flags/xx.png

---

Cinematic Settings

Config.Cinematic = {
    Total = 9000,      -- Total cinematic duration (ms)
    Fov = 35.0,        -- Camera FOV
    Shots = {
        { dur = 3000, from = { off = vec3(1.5, 0.5, 0.60) }, look = "face" },
        { dur = 3000, from = { off = vec3(-1.25, 1.85, 0.40) }, look = "hand" },
        { dur = 3000, from = { off = vec3(-0.9, 1.15, 0.55) }, look = "torso" }
    }
}

---

Bait System

Config.BaitSystem = {
    PlaceBaitKey = 0xD8F73058,  -- U key
    AttractionRadius = 150.0,   -- How far bait attracts
    BaitDuration = 300000,      -- 5 minutes
}

---

Bait Shop Items

Config.BaitShop = {
    Categories = {
        { id = "herbivore", name = "...", icon = "..." },
        { id = "predator", name = "...", icon = "..." },
        { id = "birds", name = "...", icon = "..." },
        { id = "premium", name = "...", icon = "..." }
    },

    Items = {
        {
            id = "basic_herbivore",
            name = "baitshop_item_basic_herbivore_name",
            category = "herbivore",
            item = "bait_corn",        -- Inventory item name
            price = 5,
            duration = {30, 60},       -- Effectiveness duration
            range = 100,               -- Attraction range
            effectiveness = 60,        -- Percentage
            quality = "basic",
        },
        -- ... more items
    }
}

---

NPC Locations

Config.GetWorkLocations = {
    [1] = {
        pedCoords = vector4(-279.93, 782.39, 119.50, 91.26),
        pedModel = "S_M_M_UNIBUTCHERS_01",
        ped = nil,  -- Auto-populated
    },
    -- Add more locations
}

Adding New Hunting Locations

[2] = {
    pedCoords = vector4(X, Y, Z, HEADING),
    pedModel = "S_M_M_UNIBUTCHERS_01",
    ped = nil,
},

---

Contracts

Config.Contracts = {
    {
        id = "simple_heartlands_smallgame",
        tier = "simple",                    -- simple/advanced/epic/legendary
        label = "Heartlands Small Game",
        minLevel = 1,
        maxLevel = 4,
        rewardBase = 70,
        rewardRandom = { 15, 30 },          -- Random bonus range

        animals = {
            { model = "A_C_Rabbit_01", amount = { min = 2, max = 4 } },
            { model = "A_C_TurkeyWild_01", amount = { min = 1, max = 1 } }
        },

        requiredKills = 1,
        requirePerfectPelts = false,
        difficult = "easy",                 -- easy/normal/hard/extreme

        radiusCoords = { x = -283.51, y = 792.97, z = 118.67 },
        radius = 55.0,

        timeLimit = nil,                    -- nil = no limit, or seconds

        specialRules = {
            onlyAtNight = false,
            foggyWeather = false,
            noDeath = false,
        },

        bonusObjectives = {
            noDamageTaken = false,
            noDeath = false,
        }
    },
}

Contract Tiers

Tier	Level Range	Difficulty
simple	1-4	Easy
advanced	3-8	Normal-Hard
epic	6+	Hard
legendary	10+	Extreme

---

Hunting Map

Config.MapItem = "huntingmap"  -- Inventory item name

Config.HuntingMap = {
    Presentation = "ground",
    FreezePlayer = true,
    Scenario = "WORLD_HUMAN_WRITE_NOTEBOOK",
    Cam = {
        fov = 40.0,
        offset = { x = 0.0, y = 0.95, z = 0.75 },
        transitionMs = 600
    }
}

---

Difficulty Colors (UI)

Config.DifficultyColors = {
    easy = "text-emerald-400",
    normal = "text-amber-300",
    hard = "text-red-400",
    extreme = "text-fuchsia-400",
}

---

Hints (Pro Tips)

Config.Hints = {
    { title = "Perfect Pelt Rule", text = "Only three-star animals..." },
    { title = "One Clean Shot", text = "Use the correct caliber..." },
    -- Add more hints
}

---