QBESXStandalone
Agency-Multicharacter Yapılandırma

FiveM için sinematik karakter seçimi ve oluşturma.
v1.0.0Ücretli5 Sayfalar
01Yapılandırma

Hızlı Kurulum · 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 = 'auto'               -- locked slots: 'auto' = only when they can be unlocked
                                              -- (Tebex codes or a shop hint), true = always, false = never
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.
-- Off by default: set to true once your Tebex package is set up.
Config.TebexCodes  = false
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 (siren, hoodOpen, color = { primary, secondary }) 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 = {   -- Mission Row police station, in front of the entrance
        ped = vector4(427.60, -981.40, 30.71, 90.0),
        cam = { distance = 3.6, height = 1.1, fov = 50.0, side = 0.0 },
        anim = { dict = 'amb@world_human_cop_idles@male@base', name = 'base' },
        props = {
            { ped = 's_m_y_cop_01', coords = vector4(429.40, -978.20, 30.71, 120.0), anim = { dict = 'random@arrests', name = 'generic_radio_chatter' } },
            { ped = 's_f_y_cop_01', coords = vector4(429.90, -984.70, 30.71, 75.0), scenario = 'WORLD_HUMAN_CLIPBOARD' },
        },
    },
    ambulance = {   -- Pillbox Hill Medical Center, main entrance
        ped = vector4(297.30, -584.50, 43.13, 70.0),
        cam = { distance = 3.8, height = 1.1, fov = 50.0, side = 0.0 },
        anim = { dict = 'amb@world_human_clipboard@male@base', name = 'base' },
        props = {
            { vehicle = 'ambulance', coords = vector4(293.90, -589.20, 43.13, 160.0), siren = true },
            { ped = 's_m_m_paramedic_01', coords = vector4(299.20, -581.60, 43.13, 100.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' },
        },
    },

    -- ── More jobs ──────────────────────────────────────────────────────────
    cardealer = {   -- Premium Deluxe Motorsport, showroom
        ped = vector4(-56.30, -1096.70, 26.42, 340.0),
        cam = { distance = 4.0, height = 1.2, fov = 52.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_c@base', name = 'base' },
    },
    judge = {       -- Rockford Hills city hall
        ped = vector4(-544.80, -204.30, 38.22, 210.0),
        cam = { distance = 3.6, height = 1.05, fov = 42.0, side = 0.0 },
        scenario = 'WORLD_HUMAN_STAND_IMPATIENT',
    },

    -- ── Gangs (used when the job has no scene of its own) ──────────────────
    families = {    -- Grove Street
        ped = vector4(102.40, -1940.20, 20.80, 140.0),
        cam = { distance = 3.8, height = 1.1, fov = 50.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_c@base', name = 'base' },
        props = {
            { vehicle = 'buccaneer2', coords = vector4(101.00, -1936.40, 20.80, 50.0), color = { 53, 53 } },
            { ped = 'g_m_y_famca_01', coords = vector4(104.90, -1941.00, 20.80, 165.0), scenario = 'WORLD_HUMAN_SMOKING' },
        },
    },
    ballas = {      -- Grove Street cul-de-sac, Ballas house
        ped = vector4(95.80, -1950.10, 20.75, 317.0),
        cam = { distance = 4.3, height = 1.2, fov = 52.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_b@base', name = 'base' },
        props = {
            { ped = 'g_m_y_ballaorig_01', coords = vector4(93.20, -1948.90, 20.75, 300.0), scenario = 'WORLD_HUMAN_DRINKING' },
            { ped = 'g_m_y_ballaeast_01', coords = vector4(97.40, -1953.00, 20.75, 330.0), scenario = 'WORLD_HUMAN_SMOKING' },
        },
    },
    vagos = {       -- Rancho projects, Jamestown Street
        ped = vector4(334.80, -2039.90, 21.10, 140.0),
        cam = { distance = 4.3, height = 1.2, fov = 52.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_a@base', name = 'base' },
        props = {
            { vehicle = 'chino2', coords = vector4(333.30, -2036.70, 21.10, 50.0), color = { 89, 89 } },
            { ped = 'g_m_y_mexgoon_01', coords = vector4(337.10, -2040.80, 21.10, 160.0), scenario = 'WORLD_HUMAN_SMOKING' },
            { ped = 'g_m_y_mexgoon_03', coords = vector4(331.60, -2039.40, 21.10, 120.0), scenario = 'WORLD_HUMAN_DRINKING' },
        },
    },
    lostmc = {      -- Lost MC clubhouse, East Vinewood
        ped = vector4(985.80, -110.40, 74.25, 220.0),
        cam = { distance = 3.4, height = 1.15, fov = 55.0, side = -1.4 },
        anim = { dict = 'amb@world_human_hang_out_street@male_c@base', name = 'base' },
        props = {
            { vehicle = 'daemon', coords = vector4(983.80, -111.40, 74.25, 190.0) },
            { vehicle = 'hexer', coords = vector4(987.20, -108.60, 74.25, 250.0) },
            { ped = 'g_m_y_lost_01', coords = vector4(985.80, -108.50, 74.25, 220.0), scenario = 'WORLD_HUMAN_DRINKING' },
        },
    },
    cartel = {      -- Vinewood Hills hacienda
        ped = vector4(1388.40, 1141.80, 114.33, 90.0),
        cam = { distance = 5.0, height = 1.3, fov = 55.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_c@base', name = 'base' },
        props = {
            { vehicle = 'baller2', coords = vector4(1388.60, 1138.20, 114.33, 60.0), color = { 0, 0 } },
            { ped = 'g_m_m_mexboss_01', coords = vector4(1388.70, 1143.40, 114.33, 110.0), scenario = 'WORLD_HUMAN_GUARD_STAND' },
        },
    },
    triads = {      -- Little Seoul, behind the Park Jung restaurant
        ped = vector4(-660.00, -891.60, 24.60, 180.0),
        cam = { distance = 3.4, height = 1.25, fov = 58.0, side = 0.0 },
        anim = { dict = 'amb@world_human_hang_out_street@male_b@base', name = 'base' },
        props = {
            { vehicle = 'fugitive', coords = vector4(-663.20, -891.00, 24.60, 90.0), color = { 0, 0 } },
            { ped = 'g_m_m_chigoon_01', coords = vector4(-658.20, -891.00, 24.60, 200.0), scenario = 'WORLD_HUMAN_SMOKING' },
        },
    },
}


-- 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',
    lawyer = 'judge', doj = 'judge',
    gsf = 'families', grove = 'families', lost = 'lostmc', thelost = 'lostmc', mexican = 'cartel', mafia = 'cartel', triad = 'triads',
}

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
}