⚙️Configuration

---

Cats Advanced Name 設定オプション

基本設定 / Basic Settings

• 言語設定（英語、日本語、韓国語）

• フレームワーク設定（auto、qbcore、esx）

メイン設定

• テキストサイズ調整

• 頭上表示位置のオフセット

• テキスト表示の高さ位置

• 名前表示の最大距離

• フォント設定

• ラベルの色設定

• 名前メニューのコマンドとキー

PVEモード設定s

• PVEモード機能の有効/無効

ニックネーム設定

• ニックネーム機能の有効/無効

• 保存可能なニックネーム数

名前ラベル設定s

• 名前ラベル機能の有効/無効

カスタムマーク設定

• カスタムマーク機能の有効/無効

• マーク管理コマンド

• 単一マークモード設定

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