> For the complete documentation index, see [llms.txt](https://ak-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ak-scripts.gitbook.io/docs/akxi-lie/headid/pei-zhi.md).

# 配置

你可以在`config.lua`更改列出功能！

```lua
Config = {}
Config.Framework  = 'auto'              -- 框架支持：| 'qb' | 'esx' | 'auto' （自动检测）
Config.ShowSelf   = true                -- 是否显示玩家自己头顶
Config.Outline    = true                -- 文本是否默认描边
Config.DropShadow = true                -- 文本是否默认阴影
Config.ShowJob    = true                -- 是否默认显示职业
Config.ShowGrade  = true                -- 是否默认显示职位/等级
Config.ShowID     = true                -- 是否默认显示[ID]
Config.ShowName   = true                -- 是否默认显示玩家角色名
Config.UseOxMenu  = true                -- 是否使用 ox_lib 菜单
Config.PersistentTitles  = true         -- 称号是否持久化保存到数据库（需 oxmysql）false 将采用临时保存，重启即清
Config.AutoEquipNewTitle = true         -- 管理员发放新称号时是否自动佩戴
Config.PlayerCanUnequip  = true         -- 玩家是否可“卸下当前称号”
Config.PlayerCanToggleOwnTitle = true   -- 玩家是否可切换自己称号显示/隐藏
Config.BaseScale     = 0.5              -- 字体大小（距离会动态缩放）
Config.DrawDistance  = 15.0             -- 玩家显示距离
Config.HeightOffset  = 1.2              -- 头顶显示高度（ESX请设置成1.4）
Config.ScreenLineGap = 0.03             -- 每行在“屏幕”上的间距（0~1）
Config.ServerRefreshSeconds = 10        -- 玩家同步秒数（玩家多建议建议数值改大，影响性能，默认是10秒）

Config.Commands = {
    player = 'head',                    -- 玩家打开菜单命令
    admin  = 'headadmin'                -- 管理员菜单命令
}

Config.AdminLicenses = {                -- 管理员许可证
    'license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
    -- 你可添加更多管理员
}

Config.ColorIDName = { r = 255, g = 255, b = 255, a = 220 }  -- ID及名称的颜色（默认纯白色）
Config.ColorTitle  = { r = 255, g = 215, b = 0,   a = 230 }  -- 自定义称号颜色（默认金黄色）

Config.JobColors   = {    -- 颜色配置网址：https://www.rapidtables.org/zh-CN/web/color/RGB_Color.html
    ['Default']    = { r = 255, g = 255, b = 255, a = 220 }, -- 未匹配职业时的默认色

    ['police']     = { r = 0,   g = 115, b = 230, a = 220 },
    ['sheriff']    = { r = 200, g = 160, b = 60,  a = 220 },
    ['ambulance']  = { r = 220, g = 50,  b = 50,  a = 220 },
    ['doctor']     = { r = 0,   g = 170, b = 140, a = 220 },
    ['mechanic']   = { r = 255, g = 140, b = 0,   a = 220 },
    ['taxi']       = { r = 255, g = 208, b = 0,   a = 220 },
    ['unemployed'] = { r = 160, g = 160, b = 160, a = 220 },
    -- 你可以添加更多职业及颜色
}
-- RGBA 颜色说明
-- r：红色，0–255
-- g：绿色，0–255
-- b：蓝色，0–255
-- a：透明度，0–255（0=全透明，255=完全不透明）
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ak-scripts.gitbook.io/docs/akxi-lie/headid/pei-zhi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.