🏳️Config

All configuration is located in shared/config.lua.

---

Gameplay

Config.Gameplay = {
    Weapon           = `WEAPON_PAINTBALL`,  -- Default weapon (hash)
    MaxHitDistance    = 65.0,                -- Max distance to register a hit (units)
    HitCooldownMs    = 1200,                -- Cooldown between hits on the same target (ms)
    SpawnProtectionMs = 3000,               -- Spawn protection duration (ms)
    MaxTeamSize      = 6,                   -- Global max team size
}

Parameter	Type	Description
Weapon	hash	Default weapon hash used in matches
MaxHitDistance	float	Maximum distance for a hit to be validated
HitCooldownMs	int	Minimum time between two hits on the same target (in ms)
SpawnProtectionMs	int	Duration of respawn protection (in ms)
MaxTeamSize	int	Max players per team (can be reduced per arena)

---

Lobby Defaults

Config.Defaults = {
    arena     = "boardwalk",   -- Default arena
    mode      = "TEAM",        -- Game mode (TEAM, ELIM, FFA, GUNGAME)
    weapon    = "paintball",   -- Weapon (key from Config.Weapons)
    teamSize  = 3,             -- Players per team
    target    = 35,            -- Target score to win
    timeLimit = 600,           -- Max duration in seconds (10 min)
    nightMode = false,         -- Night mode
    hardcore  = false,         -- Hardcore mode
    friendly  = false,         -- Friendly fire enabled
    autoStart = true,          -- Auto-start when everyone is ready
}

---

Available Weapons

Config.Weapons = {
    { key = "paintball", hash = `WEAPON_PAINTBALL`,     ammo = 9999, name = "Paintball" },
    { key = "pistol",    hash = `WEAPON_PISTOL`,        ammo = 9999, name = "Pistol" },
    { key = "combat",    hash = `WEAPON_COMBATPISTOL`,  ammo = 9999, name = "Combat Pistol" },
    { key = "smg",       hash = `WEAPON_SMG`,           ammo = 9999, name = "SMG" },
    { key = "ar",        hash = `WEAPON_ASSAULTRIFLE`,  ammo = 9999, name = "Assault Rifle" },
    { key = "carbine",   hash = `WEAPON_CARBINERIFLE`,  ammo = 9999, name = "Carbine Rifle" },
    { key = "shotgun",   hash = `WEAPON_PUMPSHOTGUN`,   ammo = 9999, name = "Pump Shotgun" },
    { key = "sniper",    hash = `WEAPON_SNIPERRIFLE`,   ammo = 9999, name = "Sniper Rifle" },
}

All weapons have infinite ammo (9999). You can add or remove weapons from this list.

---

Gun Game

Weapon progression in Gun Game mode (9 tiers):

Config.GunGame = {
    Weapons = {
        { hash = `WEAPON_KNIFE`,          ammo = 1,  name = "Knife" },
        { hash = `WEAPON_PISTOL`,         ammo = 12, name = "Pistol" },
        { hash = `WEAPON_COMBATPISTOL`,   ammo = 12, name = "Combat Pistol" },
        { hash = `WEAPON_SMG`,            ammo = 30, name = "SMG" },
        { hash = `WEAPON_ASSAULTRIFLE`,   ammo = 30, name = "Assault Rifle" },
        { hash = `WEAPON_CARBINERIFLE`,   ammo = 30, name = "Carbine Rifle" },
        { hash = `WEAPON_SNIPERRIFLE`,    ammo = 5,  name = "Sniper Rifle" },
        { hash = `WEAPON_PUMPSHOTGUN`,    ammo = 8,  name = "Pump Shotgun" },
        { hash = `WEAPON_KNIFE`,          ammo = 1,  name = "Final Knife" },
    },
}

Tier	Weapon	Ammo
1	Knife	1
2	Pistol	12
3	Combat Pistol	12
4	SMG	30
5	Assault Rifle	30
6	Carbine Rifle	30
7	Sniper Rifle	5
8	Pump Shotgun	8
9	Final Knife	1

The first player to complete all 9 tiers wins the match.

---

Wager System

Config.Wager = {
    enabled       = true,    -- Enable/disable wagers
    min           = 100,     -- Minimum bet
    max           = 50000,   -- Maximum bet
    defaultAmount = 500,     -- Default bet amount
}

When enabled, the lobby creator can set a wager amount. Each player who joins pays the wager. Winners split the pot at the end of the match. If the lobby is disbanded, all wagers are refunded.

---

Medal System

Config.Medals = {
    multiKillWindow = 4000,       -- Window for multi-kills (ms)
    streakLevels    = { 3, 5, 7 }, -- Kill streak thresholds
}

Medal	Condition
First Blood	First kill of the match
Double Kill	2 kills within 4 seconds
Triple Kill	3 kills within 4 seconds
Multi Kill	4+ kills within 4 seconds
Killing Spree	3 kills without dying
Rampage	5 kills without dying
Unstoppable	7 kills without dying
Headshot	Kill with a headshot

---

Interaction Point

Config.InteractPoint = vec4(135.006592, -2956.377930, 6.189697, 269.291351)

Coordinates of the point where players interact to open the paintball menu.

---

Map Blip

Config.Blip = {
    enabled    = true,
    coords     = vec3(146.04, -2955.03, 6.19),
    sprite     = 311,        -- Paintball / target sprite
    color      = 27,         -- Purple
    scale      = 0.85,
    name       = "Paintball",
    shortRange = true,
}

Set enabled = false to disable the blip.

---

Target System

Config.TargetPriority = { "ox_target", "qb-target", "Var-Interact", "fallback" }

The script auto-detects the first available target system in priority order. If none is found, it falls back to a 3D marker with the E key.

---

Team Uniforms

Config.TeamUniforms = nil  -- Uses built-in defaults

Set to nil to use the built-in uniforms. You can define your own by replacing this with a table of clothing components for each team (RED, BLUE, FFA) with male/female variants.

---

Discord Webhook

Config.Discord = {
    enabled   = false,
    webhook   = "",         -- Paste your Discord webhook URL here
    botName   = "Paintball",
    avatarUrl = "",         -- Bot avatar URL (optional)
    color     = 3447003,    -- Embed color (blue by default)
}

When enabled, a Discord embed is sent at the end of each match with the results, MVP, and player statistics.

---

Language

The language is auto-detected via the framework. The file shared/lang.lua contains translations for:

• English (en)

• French (fr)

You can add more languages by following the same format in shared/lang.lua.