config.lua

Preview File Updated: v1.0.1 - 02/22/2026

Config = {}

-- LANGUAGE SETTINGS
Config.Language = 'en'
Config.Translations = {
    ['en'] = {
        ['keybind_handsup'] = 'Hands Up',
        ['keybind_pointing'] = 'Point Finger',
        ['keybind_ragdoll'] = 'Go Ragdoll',
        ['keybind_crouch'] = 'Crouch',
        ['keybind_tackle'] = 'Tackle Player',
    }
}

-- FEATURE TOGGLES
Config.Features = {

    -- UI FEATURES
    ServerLogo = {
        enabled = true,
        autoShow = true  -- automatically show logo on spawn
    },

    -- DISCORD RICH PRESENCE
    DiscordRichPresence = {
        enabled = true,
        appId = 1163549770531492040,
        largeAsset = "logo",
        largeAssetText = "discord.gg/orbitscripts",
        smallAsset = "logo",
        smallAssetText = "Orbit Scripts RP",
        maxPlayers = 100,
        updateInterval = 60000,
        useN4Queue = true,  -- set to false if not using n4_queue
        discordLink = "https://discord.gg/orbitscripts",
        connectLink = "https://discord.gg/orbitscripts"
    },

    -- ANIMATION FEATURES
    HandsUp = {
        enabled = true,
        keybind = 'X',
        mode = 'hold',  -- 'toggle' or 'hold'
        dict = 'missminuteman_1ig_2',
        anim = 'handsup_base'
    },

    FingerPoint = {
        enabled = true,
        control = 29,  -- B key
        mode = 'hold'  -- 'toggle' or 'hold'
    },

    Ragdoll = {
        enabled = true,
        keybind = 'M',
        mode = 'toggle'  -- 'toggle' or 'hold'
    },

    -- MOVEMENT FEATURES
    Crouch = {
        enabled = true,
        keybind = 'LCONTROL',
        mode = 'toggle',  -- 'toggle' or 'hold'
        delay = 500,      -- cooldown between uses (ms)
        blockFPV = true   -- block first person view while crouched
    },

    UnlimitedStamina = {
        enabled = true
    },

    PreventRolling = {
        enabled = true  -- stops ragdoll animation after falling
    },

    AntiSpeedBoost = {
        enabled = true,
        triggerSpeed = 3.0,
        mudMultiplier = 0.85,
        resetWindow = 3700,
        jamWindow = 4840,
        aimBlockTime = 5000,
        strikesForMud = 2,
        strikesForJam = 5,
    },

    -- ANTI-EXPLOIT FEATURES
    JumpLimit = {
        enabled = true,
        maxConsecutive = 3,     -- max jumps before penalty
        penaltyDuration = 3000, -- how long to disable jumping (ms)
        resetDelay = 2000       -- time before counter resets (ms)
    },

    -- COMBAT FEATURES
    WeaponShake = {
        enabled = true,
        strength = 0.1  -- 0.1 = light, 1.0 = heavy
    },

    WeaponSway = {
        enabled = true,
        power = 0.3  -- 0.1 = light sway, 1.0 = heavy drunk-like sway (currently hardcoded to 0.3 in module)
    },

    TackleSystem = {
        enabled = true,
        keybind = 'G',
        delay = 3000,       -- cooldown between tackles (ms)
        distance = 2.0,     -- max tackle distance (meters)
        speedRequired = 2.0 -- minimum sprint speed needed
    },

    RequireAimToPunch = {
        enabled = true  -- must target someone to melee attack
    },

    StunDuration = {
        enabled = true,
        seconds = 5  -- how long taser stuns last
    },

    -- VEHICLE FEATURES
    AutoShuffleDriver = {
        enabled = true,
        delay = 1500  -- time before moving to driver seat (ms)
    },

    -- VISUAL/AUDIO FEATURES
    DefaultCrosshair = {
        enabled = false  -- show default GTA reticle (true = show, false = hide except snipers)
    },

    FlashlightAlwaysOn = {
        enabled = true  -- flashlight stays on while moving
    },

    LimitCameraAngles = {
        enabled = false  -- only allow 1st/3rd person (no cinematic)
    },

    RemoveAmbientSirens = {
        enabled = true  -- removes background police sirens
    },

    PreventClothingDamage = {
        enabled = true  -- hats/glasses stay on when hit
    }
}

-- DEVELOPER OPTIONS
Config.EnableDebug = false  -- console logging for troubleshooting