SleepyCode
Home
AboutBlogSubscriptionDocs
Cart0
SleepyCode
Cart0
  • πŸ’£Documentation

Scripts

  • Multicharacter
    • Features
    • Installation
    • Framework Setup
    • Core Settings
    • Characters and Slots
    • Identity
    • Spawn Selector
    • Camera and Scene
    • Arrival and Welcome
    • Starting Items
    • Loading Screen
    • Discord
    • Logs
    • Theme and Branding
    • Translations
    • Commands and Permissions
    • Database
    • Integrations
    • Hooks
    • Exports and Events
    • Examples
    • Security
    • Troubleshooting
  • DevTool
  • Fishing
  • πŸ—ƒοΈGarages V2
  • 🚌Bus Job
  • πŸš—Vehicle Shop V1
  • πŸ—ƒοΈGarages V1
  • 🍁Selldrugs
  • πŸŽ…Advent Calendar
  1. Docs
  2. /Multicharacter
  3. /Identity

Multicharacter

Identity

config/identity.lua - character data validation, nationalities and flags, random names, and the citizen id format.

On this page5 sections
  • Character data
  • Nationalities
  • Add a nationality
  • Random names
  • Citizen ID format

All limits are checked on the server. The form only gives hints, the server decides.

Character dataLink copied

Lua
Config.Identity = {    minAge = 18,    maxAge = 90,    nameMinLen = 2,    nameMaxLen = 24,    genders = { 'male', 'female' },    heightMin    = 150,    heightMax    = 210,    randomHeight = false,    weightMin    = 40,    weightMax    = 150,    randomWeight = false,}
OptionDescription
minAge, maxAgeYoungest and oldest allowed character age.
nameMinLen, nameMaxLenFirst and last name length. Digits are never accepted.
gendersAvailable genders.
heightMin, heightMaxHeight range in cm.
randomHeighttrue rolls the height instead of letting players pick.
weightMin, weightMaxWeight range in kg.
randomWeighttrue rolls the weight.

NationalitiesLink copied

Lua
nationalities = {    'American', 'British', 'Polish', 'German',    'Other',},nationalityFlags = {    American = 'US', British = 'GB', Polish = 'PL', German = 'DE',},
  • nationalities is the list in the form, in this order.
  • nationalityFlags maps a nationality to an ISO 3166-1 alpha-2 country code for its flag.
  • A nationality without an entry is shown without a flag.

Over 40 nationalities with flags are included.

Add a nationalityLink copied

Flags are SVG files in web/dist/flags/, named with the lowercase country code, for example pl.svg.

  1. 1

    Add the flagLink copied

    If the flag is missing, get the SVG from flag-icons (opens in a new tab) (MIT, folder flags/4x3/). Save it as web/dist/flags/<code>.svg, for example web/dist/flags/lt.svg.

  2. 2

    Add the nationalityLink copied

    Lua
    nationalities = {    'Lithuanian',},nationalityFlags = {    Lithuanian = 'LT',},
  3. 3

    Restart the resourceLink copied

Flags are files, not emoji, because the FiveM browser does not render color flag emoji correctly.

Random namesLink copied

The random button in the creator picks names from these lists:

Lua
randomNames = {    firstNamesMale   = { 'James', 'John', 'Jakub', 'Piotr' },    firstNamesFemale = { 'Mary', 'Anna', 'Katarzyna', 'Ewa' },    lastNames        = { 'Smith', 'Kowalski', 'Nowak' },},

The selected gender is kept when rolling.

Citizen ID formatLink copied

Lua
Config.CitizenId = {    length = 8,    prefix = '',}
OptionDescription
lengthTotal id length, including the prefix.
prefixText at the start of every id, for example 'SC-'.

The id uses uppercase letters and digits. Uniqueness is checked in the database before saving.

← PreviousCharacters and SlotsMulticharacterNext β†’Spawn SelectorMulticharacter

On this page

  • Character data
  • Nationalities
  • Add a nationality
  • Random names
  • Citizen ID format
↑ Back to top
Ready when you are

Put your server on something that holds up

150+ servers run our resources - ESX, QBCore and standalone. Once the payment clears, the package is waiting in Keymaster.

Browse the catalogueAsk on Discord β†—
  • Delivered instantly
  • Support with no expiry
  • 100+ reviews
  • Payment via Tebex

SleepyCode

FiveM Scripts

Checkout is run by Tebex Limited- they handle payment, invoicing and refunds. Β© 2026

Community

  • Discord
  • YouTube
  • X (Twitter)

Navigation

  • Home
  • All Scripts
  • ESX Scripts
  • QBCore Scripts
  • Free Scripts
  • About
  • Blog
  • Documentation
  • Support

Legal

  • Privacy Policy
  • Tebex Privacy Policy
  • Terms of Service
  • Impressum

Β© 2026 SleepyCode. Not affiliated with Rockstar Games or Take-Two Interactive.

Powered byTebex