Configuration

This showcases and explains the config.lua file within the Name Tags!

Config = {}

-- ============================================
-- DEFAULT SETTINGS
-- ============================================
Config.DefaultSettings = {
    namesVisible = true,      -- Show all nametags by default
    myNameVisible = true,     -- Show own name by default
    showIds = true,           -- Show server IDs by default
    showGender = true,        -- Show gender by default
}

-- ============================================
-- DEFAULT COLORS (RGB values 0-255)
-- ============================================
Config.DefaultColors = {
    nametag = { r = 255, g = 255, b = 255 },      -- Default: white
    speaking = { r = 0, g = 255, b = 0 },         -- Speaking: green
    damage = { r = 255, g = 0, b = 0 },           -- Damaged: red
    enemy = { r = 255, g = 0, b = 0 },            -- Enemy/Marked: red
    affiliate = { r = 0, g = 100, b = 255 },      -- Affiliate: blue
}

-- ============================================
-- CONFIGURABLE COMMANDS
-- ============================================
Config.Commands = {
    -- Main menu commands (all open the nametag menu)
    menu = {
        "nametag",
        "names",
        "nametags",
        "toggleids",
        "tognames",
        "nt",
    },
    
    -- Toggle own name visibility
    toggleMyName = {
        "togmyname",
    },
    
    -- Mark/Enemy commands
    mark = {
        "mark",
    },
    unmark = {
        "unmark",
    },
    
    -- Affiliate commands
    affiliate = {
        "affiliate",
    },
    unaffiliate = {
        "unaffiliate",
    },
}

-- ============================================
-- LOCALES
-- ============================================
Config.Locales = {
    -- Menu
    menu_title = "Nametag Settings",
    menu_show_all = "Show all nametags",
    menu_show_own = "Show my own name",
    menu_show_ids = "Show server IDs",
    menu_show_gender = "Show gender",
    menu_color_default = "Default Color",
    menu_color_speaking = "Speaking Color",
    menu_color_damage = "Damage Color",
    menu_color_enemy = "Enemy Color (Marked)",
    menu_color_affiliate = "Affiliate Color",
    menu_mark_player = "Mark Player (ID)",
    menu_mark_placeholder = "Enter player ID to mark",
    menu_unmark_player = "Unmark Player (ID)",
    menu_unmark_placeholder = "Enter player ID to unmark",
    menu_affiliate_player = "Affiliate Player (ID)",
    menu_affiliate_placeholder = "Enter player ID to affiliate",
    menu_unaffiliate_player = "Unaffiliate Player (ID)",
    menu_unaffiliate_placeholder = "Enter player ID to unaffiliate",
    
    -- Notifications
    notify_title = "Nametags",
    notify_config_updated = "Configuration updated successfully",
    notify_name_visible = "Your name is now visible",
    notify_name_hidden = "Your name is now hidden",
    
    -- Mark/Enemy
    notify_mark_success = "Player %s marked",
    notify_mark_usage = "Usage: /%s [Player ID]",
    notify_unmark_success = "Player %s unmarked",
    notify_unmark_usage = "Usage: /%s [Player ID]",
    
    -- Affiliate
    notify_affiliate_success = "Player %s affiliated",
    notify_affiliate_usage = "Usage: /%s [Player ID]",
    notify_unaffiliate_success = "Player %s unaffiliated",
    notify_unaffiliate_usage = "Usage: /%s [Player ID]",
    
    -- Errors
    notify_invalid_id = "Invalid player ID",
    notify_player_not_found = "Player not found",
    
    -- Mask
    mask_stranger = "Stranger",
}

-- ============================================
-- OTHER SETTINGS
-- ============================================
Config.Settings = {
    -- Nametag display
    maxDistance = 9.5,              -- Maximum distance to show nametags
    nametagScale = 0.15,            -- Base scale for nametags
    nametagOffset = 0.29,           -- Vertical offset above head
    
    -- Damage detection
    damageThreshold = 5,             -- Minimum health drop to trigger damage color
    damageCheckInterval = 50,       -- Damage check interval in ms
    damageColorDuration = 1500,     -- How long damage color shows (ms)
    
    -- Speaking detection
    speakingColorDuration = 1000,   -- How long speaking color shows (ms)
    
    -- Mask detection
    maskComponent = 1,              -- Ped component ID for masks (1 = masks)
    maskDrawableNone = 0,           -- No mask drawable value
    maskDrawableInvalid = -1,       -- Invalid mask drawable value
}