⚙️Configuration

---

config.lua

-- Advanced Name Display Configuration
Config = {
    -- Language setting for UI text (en, ja, kr available)
    language = 'en',
    
    -- Framework setting (qbcore or esx)
    framework = 'auto', -- 'auto', 'qbcore', or 'esx'
    
    -- Main configuration options
    ['main'] = {
        -- Text Scale Settings
        name_textScale = 0.47,
        gang_textScale = 0.38,
        label_textScale = 0.42,

        -- Head Position Offset
        head_position_offset = 0.38,

        -- Height positions for displaying text above players
        nametag_height = 0.14, -- Height for nametag text
        name_height = 0.07,    -- Height for name text
        gang_height = 0.1,     -- Height for gang text (increased from 0.07 to fix overlap when jumping)
        
        -- Maximum distance to display player names (in game units)
        distance = 5.0,
        
        -- Title used in notifications
        title = 'Advanced Name Display',
        
        -- Font configuration settings
        gfxUse = true,         -- Whether to use custom GXT font
        gfxFileName = 'CatsFont', -- File name of gfx font file in stream folder
        gfxFontName = 'CatsFont', -- Font name specified when creating gfx file
        fontId = 0,            -- Font ID to use when gfxUse is false
        
        -- Name menu Command
        name_menu_command = 'name',
        name_menu_key = 'F9',
    },
    
    -- PVE mode configuration (displays special indicator for new/PVE players)
    -- Warning: Enabling PVE mode automatically grants PVE mode to players who log into the server for the first time and disables friendly fires between players.
    ['pvemode'] = {
        enabled = false,        -- Enable/disable PVE mode feature
    },

    -- Character name configuration
    ['character'] = {
        min_length = 2,        -- Minimum length of a character name
        max_length = 20,       -- Maximum length of a character name
    },
    
    -- Nickname system configuration
    ['nickname'] = {
        enabled = true,        -- Enable/disable nickname feature
        max_count = 3,         -- Maximum number of nicknames a player can save (1-3)
        min_length = 2,        -- Minimum length of a nickname
        max_length = 30,       -- Maximum length of a nickname
    },
    
    -- Name label configuration
    ['namelabel'] = {
        enabled = false,        -- Enable/disable name label feature
        max_length = 30,        -- Maximum length of the name label
    },

    -- Custom mark configuration
    ['custommarks'] = {
        enabled = false,        -- Enable/disable custom mark feature
        command = 'marks',    -- Command to open mark management menu
        singleMarkMode = false, -- If true, only one mark can be selected at a time (per category)
    },
}