⚙️Configuration

---

The script offers extensive configuration through config.lua:

Basic Settings

• Language setting (English, Japanese, Korean)

• Framework setting (auto, qbcore, esx)

Main Settings

• Text scale adjustment

• Head position offset

• Height positions for text display

• Maximum distance for name display

• Font configuration

• Label color settings

• Name menu command and key

PVE Mode Settings

• Enable/disable PVE mode

Nickname Settings

• Enable/disable nickname feature

• Maximum number of saved nicknames

Name Label Settings

• Enable/disable name label feature

Custom Marks Settings

• Enable/disable custom marks

• Mark management command

• Single mark mode setting

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 = 'VRFont', -- File name of gfx font file in stream folder
        gfxFontName = 'VRFont', -- 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
    },
    
    -- Nickname system configuration
    ['nickname'] = {
        enabled = true,        -- Enable/disable nickname feature
        max_count = 3,         -- Maximum number of nicknames a player can save (1-3)
    },
    
    -- Name label configuration
    ['namelabel'] = {
        enabled = false,        -- Enable/disable name label feature
    },

    -- 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)
    },
}