Santafe Scripts
⚠️ SF Combat Logs
Configuration

Configuration

All configuration is done inside config.lua.

Framework

Config.Framework = 'auto'

Options: 'auto', 'esx', 'qbcore'

Auto-detection is recommended. Only change if detection fails.

Discord Webhook

Config.Webhook = ""

Paste your Discord webhook URL here. Leave empty to disable Discord logging.

Distances

Config.PedDrawDistance = 100.0    -- Distance to see body/smoke
Config.InteractDistance = 3.5     -- Distance to see UI and press E

Recommendations:

  • Small servers: 100.0 draw distance
  • Large servers: 50.0 for better performance

Timeout

Config.GlobalTimeout = 120  -- seconds

Time before combat log is deleted automatically for everyone.

Examples:

  • 60 = 1 minute
  • 120 = 2 minutes (default)
  • 300 = 5 minutes

Ped Settings

Config.Ped = {
    Opacity = 220,      -- 0-255 (0=invisible, 255=solid)
    ZOffset = 0.0,      -- Height adjustment
    UIHeight = 1.8,     -- UI height above ground
    ShowPed = true,     -- Show ghost body
}

Opacity recommendations:

  • 200-220 = Ghost effect (default)
  • 230-255 = More visible
  • 150-200 = More transparent

Particle Effects

Config.Particles = {
    Enabled = true,
    Scale = 1.5,
    Color = { r = 176, g = 245, b = 39 },  -- Santafe green
}

Set Enabled = false to disable smoke for better performance.

Information Display

Config.DisplayInfo = {
    ShowDiscord = true,
    ShowFivemID = true,
    ShowSteamID = true,
}

Control which IDs show in the 3D UI.

Note: Player Name, Server ID, and License are always logged. License never shows in UI, only in Discord webhook.

Sound Settings

Config.Sounds = {
    OnOpen = {
        Enabled = true,
        Name = "CONFIRM_BEEP",
        Set = "HUD_MINI_GAME_SOUNDSET"
    },
    OnClose = {
        Enabled = false,
    }
}

String Customization

Config.Strings = {
    MarkerRemoved = "Combat log removed",
    InfoCopied = "Combat log info copied to clipboard!",
    Disconnected = "Player Disconnected",
    UnknownReason = "Unknown Reason",
    UnknownPlayer = "Unknown Player"
}

Customize these for your language.

Example Setups

High Performance:

Config.PedDrawDistance = 50.0
Config.GlobalTimeout = 60
Config.Particles.Enabled = false

Maximum Visibility:

Config.PedDrawDistance = 150.0
Config.GlobalTimeout = 300
Config.Particles.Scale = 2.0
Config.Ped.Opacity = 240
InstallationUsage Guide