Configurations

The Config file in the script contains all the settings you can modify to adjust the character selection experience to your server's needs.

QB Settings

Config.QB = {
    SkipSelection = true,
    apartmentsStarting = true,
}

• SkipSelection : If set to true, players will bypass the spawn selector screen.

• apartmentsStarting : Determines whether players spawn in their apartment by default.

ESX Settings

Config.ESX = {
    PREFIX = "char",
    DefaultSkin = { ... }
}

• PREFIX : Prefix used for character identifiers (e.g., char1, char2).

• DefaultSkin : Defines the default appearance for male (m) and female (f) characters. This includes facial features, clothing, and accessories.

Default Spawn

Config.DefaultSpawn = vector4(7.74, 529.90, 170.62, 207.23)

Weather & Environment

Config.weather = {
    weatherType = "FOGGY",
    time = 8
}

UI Settings

Config.settings = {
    visibleCharacterSlots = 5,

    bannedWords = { "badword1", "badword2", "badword3" },

    minAge = 18,
    maxAge = 99,

    firstNameMaxLength = 20,
    lastNameMaxLength = 30,
    firstNameMinLength = 2,
    lastNameMinLength = 2,

    enablePersonas = true,

    countries = {
        "Afghanistan", "Albania", "Algeria", "American Samoa", "Andorra", "Angola",
        "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia",
        "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas (the)", "Bahrain",
        "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin",
        "Bermuda", "Bhutan", "Bolivia (Plurinational State of)",
        "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana",
        "Bouvet Island", "Brazil", "British Indian Ocean Territory (the)",
        "Brunei Darussalam", "Bulgaria", "Burkina Faso", "Burundi", "Cabo Verde",
        "Cambodia", "Cameroon", "Canada", "Cayman Islands (the)",
        "Central African Republic (the)", "Chad", "Chile", "China",
        "Christmas Island", "Cocos (Keeling) Islands (the)", "Colombia",
        "Comoros (the)", "Congo (the Democratic Republic of the)", "Congo (the)",
        "Cook Islands (the)", "Costa Rica", "Croatia", "Cuba", "Curaçao", "Cyprus",
        "Czechia", "Côte d'Ivoire", "Denmark", "Djibouti", "Dominica",
        "Dominican Republic (the)", "Ecuador", "Egypt", "El Salvador",
        "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia",
        "Falkland Islands (the) [Malvinas]", "Faroe Islands (the)", "Fiji",
        "Finland", "France", "French Guiana", "French Polynesia",
        "French Southern Territories (the)", "Gabon", "Gambia (the)", "Georgia",
        "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada",
        "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau",
        "Guyana", "Haiti", "Heard Island and McDonald Islands", "Holy See (the)",
        "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran",
        "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan",
        "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati",
        "Korea (the Democratic People's Republic of)", "Korea (the Republic of)",
        "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic (the)", "Latvia",
        "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania",
        "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives",
        "Mali", "Malta", "Marshall Islands (the)", "Martinique", "Mauritania",
        "Mauritius", "Mayotte", "Mexico", "Micronesia (Federated States of)",
        "Moldova (the Republic of)", "Monaco", "Mongolia", "Montenegro",
        "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru",
        "Nepal", "Netherlands (the)", "New Caledonia", "New Zealand", "Nicaragua",
        "Niger (the)", "Nigeria", "Niue", "Norfolk Island",
        "Northern Mariana Islands (the)", "Norway", "Oman", "Pakistan", "Palau",
        "Palestine, State of", "Panama", "Papua New Guinea", "Paraguay", "Peru",
        "Philippines (the)", "Pitcairn", "Poland", "Portugal", "Puerto Rico",
        "Qatar", "Republic of North Macedonia", "Romania",
        "Russian Federation (the)", "Rwanda", "Réunion", "Saint Barthélemy",
        "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis",
        "Saint Lucia", "Saint Martin (French part)", "Saint Pierre and Miquelon",
        "Saint Vincent and the Grenadines", "Samoa", "San Marino",
        "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles",
        "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia",
        "Slovenia", "Solomon Islands", "Somalia", "South Africa",
        "South Georgia and the South Sandwich Islands", "South Sudan", "Spain",
        "Sri Lanka", "Sudan (the)", "Suriname", "Svalbard and Jan Mayen", "Sweden",
        "Switzerland", "Syrian Arab Republic", "Taiwan", "Tajikistan",
        "Tanzania, United Republic of", "Thailand", "Timor-Leste", "Togo",
        "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey",
        "Turkmenistan", "Turks and Caicos Islands (the)", "Tuvalu", "Uganda",
        "Ukraine", "United Arab Emirates (the)",
        "United Kingdom of Great Britain and Northern Ireland (the)",
        "United States Minor Outlying Islands (the)", "United States of America (the)",
        "Uruguay", "Uzbekistan", "Vanuatu", "Venezuela (Bolivarian Republic of)",
        "Viet Nam", "Virgin Islands (British)", "Virgin Islands (U.S.)",
        "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe",
        "Åland Islands"
    },

    genders = {
        "Male",
        "Female",
    },

    personas = { "Lawful", "Criminal", "Neutral" }
}

Character Slots

Config.chars = { ... }

Defines the positions, animations, and camera settings for each character slot. You can use either manual or automatic camera configurations.

Manual Camera Example:

{
    coords = vector4(0.0, 0.0, 0.0, 0.0),
    animation = {dict = nil, name = nil},
    camCoords = vector3(0.0, 0.0, 0.0),
    rot = vector3(0.0, 0.0, 0.0)
}

Automatic Camera Example:

{
    coords = vector4(0.0, 0.0, 0.0, 0.0),
    animation = {dict = nil, name = nil},
    camZOffset = 0.0,
    pointZOffset = 0.0
}

Main Camera

Config.mainCam = vector4(-1020.54, 663.94, 156.30, 280)
Config.mainFov = 40.0
Config.fixCam = false
Config.mainCamRotation = vector3(0.0, 0.0, 180.0)

Config.mainCamBefore = vector4(10.71, 528.70, 174.78, 0) 
Config.mainCamRotationBefore = vector3(0.00, 0.00, -126.18)
Config.mainCamTransitionTime = 6

• mainCam : Position and rotation of the main camera.

• mainFov : Field of view for the main camera.

• fixCam : Automatically frame all characters if set to true.

• mainCamRotation : Rotation of the main camera when fixCam is false.

• mainCamBefore : The position of where the camera starts on intro.

• mainCamRotationBefore : The rotation of where the camera starts on intro.

• mainCamTransitionTime : How long it takes (in seconds) for intro camera to transition from "before" state to the main state.

Edit Permissions

Config.permissions = {
    nameChange = true,
    countryChange = true,
    dobChange = true,
    deleteCharacter = true,
}

What players can and can't edit. set all to false for manual permissions or to remove the button completely.

UI Appearance

Config.appearance = {
    colors = {
        primary = "#cde6ff",
        primaryMix = "#677380",
        dark = "#1e2026",
        light = "#cde6ff",
        onPrimary = "#1e2026",
        alert = "#ff0044",
    },

    styles = {
        shape = "rounded", -- options: 'rounded', 'smooth', 'sharp'
        aspect = "wide",   -- options: 'uniform', 'wide'
    },

    loading = {
        mode = "svg", -- options: 'svg', 'png', 'text'
    },

    effects = {
        darkGradient = true,
        vignette = true,
    },
}

• colors : UI Colors

• loading : The type of loading screen you want to use.

  • svg → smooth fill animation

  • png → zoom effect

  • text → expanding loading text

• effects: The full screen visual effects

• styles : The shape of character slots