> 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/yi-lai/markdown/pei-zhi.md).

# 配置

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

```lua
------------------------------------------------------------------------------------
--                        __                          ___  ____                   
--                       /  \                        |_  ||_  _|                 
--                      / /\ \                         | |_/ /                   
--                     / ____ \                        |  __'.                  
--                    / /    \ \_                     _| |  \ \_ 
--                  |____|  |____|                   |____||____|
--                𝐐𝐐：𝟯𝟯𝟱𝟮𝟭𝟰𝟰𝟱𝟲              𝐐𝐐交流群：𝟳𝟭𝟭𝟭𝟳𝟮𝟮𝟮𝟱
--             𝐚𝐤-𝐬𝐜𝐫𝐢𝐩𝐭𝐬             阿 𝐊             𝐐𝐁/𝐄𝐒𝐗/𝐐𝐛𝐱/𝐎𝐗
------------------------------------------------------------------------------------
--  🌐 官网: https://ak-scripts.com   🛒 商店: https://ak-scripts.tebex.io
--  💬 社区: https://kook.vip/mqXyIJ  📘 文档: https://ak-scripts.gitbook.io/docs 
------------------------------------------------------------------------------------

Config = {}

Config.Locale = 'zh-CN'        -- 语言: 'zh-CN', 'en'

Config.UIStyle = 'solid'       -- UI 风格: 'solid'(实色), 'hybrid'(混合), 'glass'(玻璃)

Config.Debug = {               -- 🛠️ 调试 & 开关
    Enabled = true,            -- 调式开关: false = 禁止所有调试 & 命令
    Print   = true,            -- 是否在控制台输出调试信息
    TestCmd = true             -- 是否启用测试命令
}

Config.TestCommand = {         -- 🧪 测试命令配置
    Notify   = 'ak1',          -- 通知测试命令
    TextUI   = 'ak2',          -- 文本测试命令
    Progress = 'ak3',          -- 进度条测试命令
    Menu     = 'ak4',          -- 菜单测试命令
    Input    = 'ak5',          -- 输入测试命令
    Dialog   = 'ak6',          -- 对话框测试命令
    Skillbar = 'ak7',          -- 技能条测试命令
    Radial   = 'ak8'           -- 径向菜单测试命令
}

Config.Settings = {            -- UI设置
    Enabled = true,            -- 是否启用设置菜单
    Command = 'ak-lib',        -- 打开菜单的命令
    AllowPlayerEdit = true,    -- 允许玩家自定义配置
    SavePreference = true      -- 保存设置到玩家本地
}

--------------------------------------------
-- 所有的位置都将采用九宫格位置，可以自行配置
--     'top-left'        左上角
--     'top-right'       右上角
--     'bottom-left'     左下角
--     'bottom-right'    右下角
--     'top-center'     顶部中间
--     'bottom-center'  底部中间
--     'middle-left'    左边中间
--     'middle-right'   右边中间
--     'middle-center'  屏幕中央
--------------------------------------------
Config.Notify   = {                       -- 💬 通知配置
    Position           = 'top-center',    -- 默认位置顶部中间
    Duration           = 5000,            -- 显示时长 (毫秒)
    Sound              = true,            -- 是否播放音效
    Volume             = 0.5,             -- 音量大小调整 (0.0 ~ 1.0)
}

Config.TextUI   = {                       -- 💬 文本配置
    Position           = 'middle-left',   -- 默认位置左中
    Duration           = 5000,            -- 默认显示时长 (毫秒), 0 = 永不关闭
    Sound              = true,            -- 是否播放音效
    Volume             = 0.2,             -- 音量大小调整 (0.0 ~ 1.0)
}

Config.Progress = {                       -- ⏳ 进度条配置
    Position           = 'bottom-center', -- 默认位置底部中间
    Duration           = 5000,            -- 默认持续时间（毫秒）
    CanCancel          = true,            -- 是否允许取消
    Style              = 'bar',           -- 样式类型: 'bar' = 条形（默认） / 'circle' = 环形（可选）
    CancelKey          = 73,              -- 默认取消键: X 键 (INPUT_VEH_DUCK)
}

Config.Menu     = {                       -- 📜 菜单配置
    Position           = 'middle-right', -- 默认菜单位置屏幕正中间
    UseMouse           = true,            -- 是否启用鼠标操作
    OpenAnimation      = false,           -- 是否启用菜单打开动画（淡入/缩放效果）
    EnableKeyboard     = true,            -- 是否启用方向键/Enter导航
    MaxItems           = 10,              -- 菜单最多显示多少项（超过出现滚动条）
}

Config.Input    = {                       -- ⌨️ 输入配置
    Position           = 'middle-center', -- 默认输入框位置屏幕正中间
    MaxLength          = 128,             -- 默认最大输入长度, 0 = 不限制
    AllowEmpty         = false,           -- 是否允许空输入
    DefaultType        = 'text',          -- 默认类型: 'text'普通文本，'number'数字，'password'密码（遮挡显示），'select'下拉选择，'date'日期选择，'textarea'多行输入，'checkbox'复选框
}

Config.Dialog   = {                       -- ⚙️ 对话框配置
    Position           = 'middle-center', -- 默认位置屏幕正中间
    Timeout            = 15000,           -- 默认超时时间 (毫秒), 0 = 不超时
    Queue              = true,            -- 是否启用队列 (多个对话框排队依次显示)
    UseMouse           = true,            -- 是否启用鼠标操作
    EnableKeyboard     = true,            -- 是否启用键盘操作 (← → 切换, Enter 确认, Esc 关闭)
}

Config.Skillbar = {                       -- ⚙️ 技能条配置
    Position           = 'bottom-center', -- 默认位置底部中间
    DefaultDifficulty  = 'medium',        -- 默认难度: 'easy'普通，'medium'中等，'hard'困难，'veryhard'极难
    DefaultRounds      = 3,               -- 默认几轮
    DefaultSuccessNeed = 2,               -- 默认至少成功几次
    SuccessThreshold   = 0.8,             -- 80% 重叠才算成功
}

Config.Radial   = {                       -- ⚙️ 径向菜单配置
    Position           = 'middle-center', -- 默认位置屏幕正中间
    Queue              = true,            -- 是否启用队列（多个环形菜单依次显示）
    DefaultKey         = 'F1',            -- 字符串，直接写键
    EnableKeyBinding   = false            -- 是否启用按键绑定（默认关闭，需要手动调用 RegisterRadialKey）
}
```


---

# 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/yi-lai/markdown/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.