QBESXStandalone
Agency-Multicharacter Configuration

Une sélection et création de personnage cinématique pour FiveM.
v1.0.0Payant5 Pages
01Configuration

Installation rapide · config.lua · Agency-Multicharacter
--[[
    ╔══════════════════════════════════════════════════════════════════════╗
    ║               AGENCY MULTICHARACTER  -  CONFIGURATION                ║
    ║                          (c) Agency Scripts                          ║
    ╚══════════════════════════════════════════════════════════════════════╝

    Works out of the box: drop it in, ensure it after your framework, done.
    Change a value only when you want something different.

    CONTENTS
     1. Core               Framework, language, server name, colour, debug
     2. Slots              Character slots, Tebex slot codes, commands
     3. Creation           Name, age and height rules, nationalities
     4. Delete & Switch    Deleting characters, /logout
     5. After Selecting    Spawn hand-off, first spawn, clothing, starter items
     6. Scenes             Where each job is shown, weather and time
     7. Logging            Discord webhook
     8. Standalone         Settings without a framework
]]

Config = {}


--==============================================================================
--  1 · CORE
--==============================================================================

-- ── Framework ────────────────────────────────────────────────────────────────
-- 'auto'        = detect QBCore, Qbox or ESX, standalone when none is installed
-- 'qbcore' / 'qbox' / 'esx' / 'standalone' = force one
Config.Framework = 'auto'

-- ── Automatic setup ──────────────────────────────────────────────────────────
-- true = on every start the script makes your server ready for itself:
--   · stops other character selections (qb-multicharacter, esx_multicharacter,
--     codem, um, ps, 0r, okok, jg, qs and more), so two never open at once
--   · Qbox: turns on useExternalCharacters in qbx_core/config/client.lua
--   · ESX:  turns on Config.Multichar in es_extended/shared/config/main.lua
-- Changed files are backed up next to the original (.agency-backup).
-- After a file was changed, restart the server once. The console tells you.
Config.AutoSetup = true

-- ── Language ─────────────────────────────────────────────────────────────────
-- Everything players see. 25 languages are included (locales folder):
-- en de fr es it pt nl pl cs hu ro bg hr el ru uk tr sv da fi ar hi ja ko zh
-- 'auto' follows your server language (qb_locale / esx:locale / ox:locale).
Config.Locale = 'en'

-- ── Look ─────────────────────────────────────────────────────────────────────
Config.ServerName = 'auto'                    -- 'auto' = sv_projectName from server.cfg
-- ── Colour ───────────────────────────────────────────────────────────────────
-- 'auto'  = taken from your server logo (gold when there is none)
-- a preset: 'gold' 'blue' 'cyan' 'green' 'red' 'orange' 'pink' 'purple' 'white'
-- or your own R, G, B: { 226, 182, 73 }
Config.Accent = 'auto'

-- ── Avatars ──────────────────────────────────────────────────────────────────
-- 'heads'   = a picture of each character's head, made from its saved look
-- 'letters' = the initials, like "AM"
Config.Avatars = 'heads'

-- Logo for the 'auto' colour: 'auto' = nui/logo.png, else the logo of
-- Agency Loadingscreen or Agency Hud. Or a file name inside this resource.
Config.Logo = 'auto'

-- ── Debug ────────────────────────────────────────────────────────────────────
Config.Debug = false                          -- extra console output, keep false when live


--==============================================================================
--  2 · SLOTS
--==============================================================================

Config.DefaultSlots    = 4                    -- characters every player can have
Config.MaxSlots        = 10                   -- hard limit, bought slots included
Config.ShowLockedSlots = true                 -- show locked slots players can unlock
Config.SlotShopHint    = false                -- text on a locked slot, e.g. 'shop.yourserver.com'

-- ── Commands ─────────────────────────────────────────────────────────────────
-- Console / txAdmin / admins:  addcharslot <license or server id> <amount>
Config.SlotCommand = 'addcharslot'

-- ── Sell slots with Tebex ────────────────────────────────────────────────────
-- Add this game server command to your Tebex package:
--     charslotcode {transaction} 1              (1 = number of slots)
-- The buyer clicks a locked slot in the selection and types the transaction
-- id from the Tebex mail (tbx-...). Works even when they were offline.
Config.TebexCodes  = true
Config.CodeCommand = 'charslotcode'


--==============================================================================
--  3 · CREATION
--==============================================================================

Config.Name = {
    min     = 2,                              -- letters per name
    max     = 16,
    blocked = { 'admin', 'moderator', 'staff', 'nigger', 'hitler', 'fuck' },
    unique  = false,                          -- true = no two characters with the same full name
}

Config.Age    = { min = 18, max = 90 }                      -- years, from the birthdate
Config.Height = { min = 150, max = 210, default = 178 }     -- centimetres

-- Players pick from this list (searchable).
Config.Nationalities = {
    'American', 'Argentinian', 'Australian', 'Austrian', 'Belgian', 'Brazilian', 'British', 'Bulgarian',
    'Canadian', 'Chilean', 'Chinese', 'Colombian', 'Croatian', 'Cuban', 'Czech', 'Danish', 'Dutch',
    'Egyptian', 'Filipino', 'Finnish', 'French', 'German', 'Greek', 'Hungarian', 'Indian', 'Irish',
    'Israeli', 'Italian', 'Jamaican', 'Japanese', 'Korean', 'Lebanese', 'Mexican', 'Moroccan',
    'Nigerian', 'Norwegian', 'Pakistani', 'Polish', 'Portuguese', 'Romanian', 'Russian', 'Scottish',
    'Serbian', 'Slovak', 'Spanish', 'Swedish', 'Swiss', 'Thai', 'Turkish', 'Ukrainian', 'Vietnamese',
}


--==============================================================================
--  4 · DELETE & SWITCH
--==============================================================================

Config.AllowDelete     = true                 -- players may delete their characters
Config.DeleteNeedsName = true                 -- they type the full name to confirm

-- ── /logout ──────────────────────────────────────────────────────────────────
-- Brings a player back to the selection without leaving the server.
Config.LogoutCommand   = 'logout'             -- command name, false = turned off
Config.LogoutAdminOnly = false                -- true = only admins may use it


--==============================================================================
--  5 · AFTER SELECTING
--==============================================================================

-- ── Spawn hand-off ───────────────────────────────────────────────────────────
-- 'auto' = Agency Spawn if running, else qb-spawn / qbx_spawn / apartments,
--          else the last location
-- 'last' = always the last location
Config.Spawn = 'auto'

-- Arrival point for new characters when no spawn selector takes over.
Config.FirstSpawn = vector4(-1037.74, -2738.04, 20.17, 328.0)   -- LSIA arrivals

-- ── Clothing ─────────────────────────────────────────────────────────────────
-- 'auto' = illenium-appearance, fivem-appearance, qb-clothing or esx_skin
Config.Clothing = 'auto'

-- ── Starter items ────────────────────────────────────────────────────────────
-- 'auto' = the framework's own starter items (QBCore Shared.StarterItems)
-- {}     = nothing
-- or a list: { { item = 'phone', amount = 1 }, { item = 'water_bottle', amount = 2 } }
Config.StarterItems = 'auto'


--==============================================================================
--  6 · SCENES
--==============================================================================
-- Each character is shown in the scene of its job, all others use 'default'.
--   ped    : where the character stands (ground height is found automatically)
--   cam    : distance in front, camera height above the feet, field of view, sideways shift
--   props  : vehicles and people around them, only visible to this player
--   anim / scenario : what the character does

Config.Weather = 'EXTRASUNNY'                 -- weather in every scene
Config.Hour    = 19                           -- time of day (19 = golden hour)

Config.Scenes = {
    default = {
        ped = vector4(-813.97, 176.22, 76.74, -7.5),
        interior = vector3(-814.89, 181.95, 76.85),
        cam = { distance = 3.4, height = 1.05, fov = 40.0, side = 0.0 },
        scenario = false,
        anim = { dict = 'anim@amb@nightclub@peds@', name = 'rcmme_amanda1_stand_loop_cop' },
    },
    police = {
        ped = vector4(1161.37, -336.03, 68.54, 192.3),
        cam = { distance = 3.4, height = 1.05, fov = 40.0, side = 0.0 },
        scenario = 'WORLD_HUMAN_COP_IDLES',
        props = {
            { vehicle = 'police2', coords = vector4(1157.03, -332.84, 68.36, 154.4), siren = true },
            { vehicle = 'police2', coords = vector4(1164.41, -332.79, 68.45, 41.2), siren = true },
            { ped = 's_m_y_cop_01', coords = vector4(1155.43, -332.84, 68.75, 200.4), anim = { dict = 'random@arrests', name = 'generic_radio_chatter' } },
        },
    },
    ambulance = {
        ped = vector4(296.48, -586.82, 43.13, 70.0),
        cam = { distance = 3.4, height = 1.05, fov = 40.0, side = 0.0 },
        scenario = 'WORLD_HUMAN_CLIPBOARD',
        props = {
            { vehicle = 'ambulance', coords = vector4(291.73, -590.81, 43.14, 340.0), siren = true },
            { ped = 's_m_m_paramedic_01', coords = vector4(293.36, -583.84, 43.19, 250.0), scenario = 'WORLD_HUMAN_STAND_MOBILE' },
        },
    },
    mechanic = {
        ped = vector4(-337.32, -136.95, 39.01, 70.0),
        cam = { distance = 3.4, height = 1.05, fov = 40.0, side = 0.0 },
        scenario = 'WORLD_HUMAN_CLIPBOARD',
        props = {
            { vehicle = 'sultan', coords = vector4(-334.39, -132.42, 38.62, 160.0), hoodOpen = true },
            { ped = 's_m_y_xmech_02', coords = vector4(-333.0, -134.9, 39.01, 60.0), scenario = 'PROP_HUMAN_BUM_BIN' },
        },
    },
}


-- Same scene for more jobs, e.g. Config.SceneAlias.sheriff = 'police'
Config.SceneAlias = {
    sheriff = 'police', bcso = 'police', lspd = 'police', sasp = 'police', state = 'police', fib = 'police',
    ems = 'ambulance', doctor = 'ambulance', fire = 'ambulance',
    bennys = 'mechanic', lscustoms = 'mechanic', tuner = 'mechanic',
}

Config.CreationScene = 'default'              -- where new characters are created


--==============================================================================
--  7 · LOGGING
--==============================================================================

Config.Webhook = ''                           -- Discord webhook for created / deleted / loaded, '' = off


--==============================================================================
--  8 · STANDALONE
--==============================================================================
-- Without a framework characters are stored in the table agency_characters.
-- Other scripts read them with exports, see README.md.

Config.Standalone = {
    saveInterval = 300,                       -- seconds between position saves
}