paintball docs›

Paintball

Config

-- 11 code blocks · 3 min read

get var-paintball try it on the test server

All configuration is located in shared/config.lua.

Gameplay

lua

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

lua

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

lua

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):

lua

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

lua

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

lua

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

lua

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

lua

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

lua

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

lua

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

lua

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.

~/docs/paintball/configuration/config