📖 古龙精灵 API 参考手册

-- ============================================================
-- 古龙精灵脚本模板
-- ============================================================

-- 加载子模块
dofile("settings_fields.lua")   -- 设置字段定义
dofile("server_api.lua")        -- 服务器通信模块

-- 全局配置
GAMENAME = "我的游戏脚本"
ACCOUNT_ID = "user_001"

-- 主函数（脚本引擎自动调用）
function main()
    log("脚本开始运行")
    
    -- 获取用户设置
    local auto_fight = get_setting("auto_fight", true)
    
    -- 主循环
    while true do
        if auto_fight then
            tap(500, 800)       -- 点击攻击按钮
            sleep(2000)             -- 等待2秒
        end
        sleep(1000)
    end
end

main()

SCRIPT_SETTINGS_FIELDS = {
    {
        key = "section_1",
        label = "战斗设置",
        type = "fold",              -- 折叠面板
        default = true,
        icon = "⚔️",
        fields = {
            {
                type = "tab_container",  -- 选项卡容器
                tabs = {
                    {
                        label = "基础",
                        icon = "❤️",
                        fields = {
                            {key = "auto_fight", label = "自动打怪", type = "bool", default = true, icon = "⚔️"},
                            -- ... 更多控件
                        }
                    },
                }
            }
        },
    },
}

-- 基础开关（默认开启）
{key = "auto_fight", label = "自动打怪", type = "bool", default = true, icon = "⚔️", description = "是否开启自动打怪功能"},

-- 带副标题开关
{key = "auto_pickup", label = "自动拾取", type = "bool", default = true, icon = "📦", description = "是否自动拾取掉落物品"},

-- 默认关闭开关
{key = "auto_sell", label = "自动出售装备", type = "bool", default = false, icon = "💰", description = "是否自动出售背包中的装备"},

-- 通知开关
{key = "enable_notify", label = "启用通知", type = "bool", default = true, icon = "🔔", description = "是否启用任务通知提醒"},

-- 调试模式开关
{key = "debug_mode", label = "调试模式", type = "bool", default = false, icon = "🐛", description = "开启后显示调试信息"},

-- 基础数字（带单位）
{key = "fight_interval", label = "打怪间隔", type = "number", default = 5, min = 1, max = 60, step = 1, unit = "秒", icon = "⏱️"},

-- 百分比数字
{key = "hp_threshold", label = "回血阈值", type = "number", default = 30, min = 10, max = 90, step = 5, unit = "%", icon = "❤️"},

-- 时长数字（分钟）
{key = "max_duration", label = "最大时长", type = "number", default = 120, min = 30, max = 1440, step = 10, unit = "分钟"},

-- 次数数字
{key = "max_attempts", label = "最大尝试次数", type = "number", default = 3, min = 1, max = 99, step = 1, unit = "次"},

-- 浮点数（带小数）
{key = "move_speed", label = "移动速度", type = "number", default = 1.5, min = 0.5, max = 5.0, step = 0.1, unit = "倍"},

-- 基础文本（带占位符）
{key = "target_monster", label = "目标怪物", type = "text", default = "银月贤者", icon = "🎯", placeholder = "输入怪物名称", description = "要自动攻击的怪物名称"},

-- 密码输入
{key = "account_password", label = "账号密码", type = "text", default = "", icon = "🔑", placeholder = "输入密码", password = true, description = "登录密码"},

-- 多行文本
{key = "custom_notice", label = "自定义公告", type = "text", default = "", icon = "📋", multiline = true, placeholder = "输入公告内容..."},

-- 过滤关键词
{key = "filter_keywords", label = "过滤关键词", type = "text", default = "", icon = "🔍", placeholder = "关键词用逗号分隔"},

-- 基础下拉选择
{key = "difficulty", label = "难度选择", type = "select", default = "normal", icon = "🎮",
 options = {{value = "easy", label = "简单"},{value = "normal", label = "普通"},{value = "hard", label = "困难"},{value = "hell", label = "地狱"}},
 description = "选择打怪难度等级"},

-- 地图选择
{key = "target_map", label = "目标地图", type = "select", default = "map1", icon = "🗺️",
 options = {{value = "map1", label = "新手村"},{value = "map2", label = "幽暗森林"},{value = "map3", label = "冰封雪域"},{value = "map4", label = "火焰山"}}},

-- 职业选择
{key = "class_type", label = "职业选择", type = "select", default = "warrior",
 options = {{value = "warrior", label = "战士"},{value = "mage", label = "法师"},{value = "archer", label = "弓箭手"},{value = "assassin", label = "刺客"}}},

-- 分辨率选择
{key = "resolution", label = "分辨率", type = "select", default = "720p",
 options = {{value = "720p", label = "720x1280"},{value = "1080p", label = "1080x1920"},{value = "2k", label = "1440x2560"}}},

{
    key = "fight_settings",
    label = "战斗设置",
    type = "fold",
    default = true,
    icon = "⚔️",
    description = "战斗相关设置（可折叠）",
    fields = {
        {
            type = "tab_container",
            tabs = {
                {
                    label = "基础",
                    icon = "⚔️",
                    fields = {
                        {key = "auto_fight", label = "自动打怪", type = "bool", default = true, icon = "⚔️"},
                        {key = "fight_interval", label = "打怪间隔", type = "number", default = 5, min = 1, max = 60, step = 1, unit = "秒"},
                    }
                },
                {
                    label = "高级",
                    icon = "⚙️",
                    fields = {
                        {key = "debug_mode", label = "调试模式", type = "bool", default = false, icon = "🐛"},
                    }
                },
            }
        }
    },
},

-- 颜色选择器
{key = "theme_color", label = "主题颜色", type = "color", default = "#FF5722", icon = "🎨", description = "选择界面主题颜色"},

-- 文字颜色
{key = "text_color", label = "文字颜色", type = "color", default = "#FFFFFF", icon = "✏️"},

-- ============================================================
-- 第一步：加载设置字段定义文件
-- ============================================================
dofile("settings_fields.lua")

-- ============================================================
-- 第二步：main() 入口函数 - 获取并读取所有控件值
-- ============================================================
function main()
    log("==================================================")
    log("  古龙精灵 - 使用示例")

    -- ===== 获取用户设置 =====
    local settings = get_user_settings()

    -- ===== ☑️ bool（布尔开关）=====
    -- 中文key必须用方括号 settings["key"]
    local auto_fight = false
    if settings["auto_fight_自动打怪"] ~= nil then
        auto_fight = settings["auto_fight_自动打怪"]
    end
    -- 英文key可用点号语法
    local auto_pickup = settings.auto_pickup
    if auto_pickup == nil then auto_pickup = true end

    -- ===== 🔢 number（数字输入）=====
    -- 读取并在脚本中使用，单位由控件定义决定（秒、%、分钟等）
    local fight_interval = settings["fight_interval"] or 5           -- 控件单位：秒
    local hp_threshold = settings.hp_threshold or 30                      -- 控件单位：%
    local max_duration = settings.max_duration or 120                    -- 控件单位：分钟
    local move_speed = settings.move_speed or 1.5                      -- 控件单位：倍（浮点数）
    log("  📊 打怪间隔=" .. fight_interval .. "秒, 回血<" .. hp_threshold .. "%, 最长" .. max_duration .. "分钟, 移速x" .. move_speed)

    -- ===== 📝 text（文本输入）=====
    -- 读取用户输入的文本，常用于匹配目标名称、过滤关键词等
    local target_monster = settings.target_monster or "银月贤者"
    local filter_keywords = settings.filter_keywords or ""
    log("  📝 目标怪物=" .. target_monster .. ", 过滤词=" .. filter_keywords)

    -- ===== 📋 select（下拉选择）=====
    -- 读取用户选择的值，用于条件判断
    local difficulty = settings.difficulty or "normal"
    local target_map = settings.target_map or "map1"
    if difficulty == "hell" then
        log("  ⚠️ 地狱难度已开启！")
    end

    -- ===== 📅 date（日期选择）=====
    local start_date = settings.start_date or "2025-01-01"
    -- 可用于判断当天是否在设定日期之后才执行
    local y, m, d = get_current_time()
    local today = string.format("%d-%02d-%02d", y, m, d)
    if today > start_date then
        log("  📅 日期已到达，开始执行...")
    end

    -- ===== ⏰ time（时间选择）=====
    local start_time = settings.start_time or "08:00"
    -- 解析时间字符串用于判断当前是否在指定时间之后
    local start_hour = tonumber(start_time:sub(1, 2)) or 8
    if h >= start_hour then
        log("  ⏰ 已过" .. start_time .. "，开始执行任务")
    end

    -- ===== 🎚️ slider（滑块）=====
    local volume = settings.volume or 80
    -- 将滑块值（0-100）映射到实际逻辑（如点击速度比例）
    local click_speed = 1.0 + (volume / 100) * 2.0  -- 映射为 1.0~3.0 倍速
    log("  🎚️ 音量=" .. volume .. ", 点击倍速=" .. click_speed)

    -- ===== 📁 file（文件选择）=====
    local script_file = settings.script_file or ""
    if script_file ~= "" then
        log("  📁 用户指定脚本文件: " .. script_file)
        -- 可以 dofile(script_file) 加载用户指定的脚本
    end

    -- ===== ☑️ multi_select（多选列表）=====
    -- 多选列表返回的是 table（数组），包含所有选中的 value
    local target_maps = settings.target_maps or {}
    if #target_maps > 0 then
        log("  🗺️ 多选地图: " .. table.concat(target_maps, ", "))
        -- 遍历每个选中的地图执行逻辑
        for i, map_name in ipairs(target_maps) do
            log("    正在处理地图: " .. map_name)
            -- 跳转到对应地图、执行对应逻辑...
        end
    else
        log("  🗺️ 未选择地图，使用默认地图")
    end

    -- ===== 🏷️ tag（分组标签）=====
    -- 分组标签返回的是 table（数组），包含所有选中的标签 value
    local item_filter = settings.item_filter or {}
    local filter_equip = false
    local filter_potion = false
    for i, tag in ipairs(item_filter) do
        if tag == "equip" then filter_equip = true end
        if tag == "potion" then filter_potion = true end
    end
    log("  🏷️ 物品过滤: 装备=" .. tostring(filter_equip) .. ", 药水=" .. tostring(filter_potion))

    -- ===== 🎨 color（颜色选择）=====
    local theme_color = settings.theme_color or "#FF5722"
    log("  🎨 主题颜色: " .. theme_color)

    -- ===== 主循环：根据控件值控制脚本逻辑 =====
    while true do
        if auto_fight then
            log("⚔️ 自动打怪开始！目标: " .. target_monster .. ", 难度: " .. difficulty)
            -- 调用对应的打怪子程序
        else
            log("⚔️ 自动打怪已关闭")
            log("  [提示] 请在用户控制面板中开启自动打怪")
        end
        sleep(fight_interval * 1000)
    end
end

main()

-- 日期选择
{key = "start_date", label = "开始日期", type = "date", default = "2025-01-01", icon = "📅"},

-- 时间选择
{key = "start_time", label = "开始时间", type = "time", default = "08:00", icon = "⏰"},

-- 滑块
{key = "volume", label = "音量调节", type = "slider", default = 80, min = 0, max = 100, step = 1, icon = "🔊"},

-- 文件选择
{key = "script_file", label = "脚本文件", type = "file", default = "", icon = "📄", placeholder = "选择脚本文件..."},

-- 多选列表
{key = "target_maps", label = "目标地图(多选)", type = "multi_select", default = {}, icon = "🗺️",
 options = {{value = "map1", label = "新手村"},{value = "map2", label = "幽暗森林"},{value = "map3", label = "冰封雪域"}}},

-- 分组标签
{key = "item_filter", label = "物品过滤", type = "tag", default = {}, icon = "🏷️",
 options = {{value = "equip", label = "装备"},{value = "potion", label = "药水"},{value = "material", label = "材料"}}},

while true do
    if user_settings.auto_fight then
        log("自动打怪已开启")
        -- 执行打怪逻辑
    end
    sleep((user_settings.fight_interval or 5) * 1000)
end

local auto_fight = get_setting("auto_fight", true)        -- 获取布尔值，默认 true
local fight_interval = get_setting("fight_interval", 5) -- 获取数字，默认 5
local target = get_setting("target_monster", "银月贤者") -- 获取文本
local difficulty = get_setting("difficulty", "normal") -- 获取下拉选择

if auto_fight then
    log("自动打怪已开启，间隔: " .. fight_interval .. "秒")
end

set_setting("auto_fight", false)       -- 关闭自动打怪
set_setting("fight_interval", 10)   -- 修改打怪间隔为10秒
set_setting("target_monster", "boss") -- 切换目标怪物

-- 获取设置
local settings = get_user_settings()

-- 读取配置项（中文 key 必须用方括号）
local auto_fight_自动饱食度 = false
if settings["auto_fight_自动饱食度"] ~= nil then
    auto_fight_自动饱食度 = settings["auto_fight_自动饱食度"]
end

auto_fight_自动打怪 = false
auto_fight_自动打怪 = settings["auto_fight_自动打怪"]

-- 控制主循环
if auto_fight_自动打怪 then
    log("⚔️ 自动打怪开始！")
    -- 执行打怪逻辑
else
    log("⚔️ 自动打怪已关闭")
end

-- ⚠️ 重要：包含中文的 key 必须使用方括号语法 settings["key"]
-- 不能用 settings.key 点号语法

function flatten_settings_fields(fields)
    local result = {}
    for _, field in ipairs(fields) do
        if field.type == "tab_container" then
            for _, tab in ipairs(field.tabs or {}) do
                for _, f in ipairs(tab.fields or {}) do
                    table.insert(result, f)
                end
            end
        elseif field.type == "fold" then
            for _, f in ipairs(field.fields or {}) do
                if f.type == "tab_container" then
                    for _, tab in ipairs(f.tabs or {}) do
                        for _, tf in ipairs(tab.fields or {}) do
                            table.insert(result, tf)
                        end
                    end
                else
                    table.insert(result, f)
                end
            end
        else
            table.insert(result, field)
        end
    end
    return result
end

-- 获取所有默认设置
function get_default_settings()
    local settings = {}
    local flat = flatten_settings_fields(SCRIPT_SETTINGS_FIELDS)
    for _, field in ipairs(flat) do
        settings[field.key] = field.default
    end
    return settings
end

-- ============================================================
-- 梦幻逍遥脚本 - 核心逻辑示例
-- 演示：触控、取色、OCR、用户设置获取
-- ============================================================

-- 加载子模块
dofile("settings_fields.lua")
dofile("server_api.lua")

local 打怪调用 = require("子程序_打怪")
local 综合调用 = require("子程序_综合调用")
local 组队调用 = require("子程序_组队")

-- 判断是否正在战斗中（取色方式）
function 判断_人物停止了()
    -- 取色判断：如果画面中某特征颜色不变，说明人物停在原处
    local colorStr = get_color(451, 585)
    local r, g, b = tonumber("0x"..colorStr:sub(1,2)), tonumber("0x"..colorStr:sub(3,4)), tonumber("0x"..colorStr:sub(5,6))
    
    sleep(900)
    
    local colorStr2 = get_color(451, 585)
    local r1, g1, b1 = tonumber("0x"..colorStr2:sub(1,2)), ...
    
    -- 颜色不变 = 人物已停止
    if r == r1 and g == g1 and b == b1 then
        return true
    end
    return false
end

-- 主函数
function main()
    log("==================================================")
    log("  古龙精灵 - 梦幻逍遥")
    
    -- 获取用户设置
    local settings = get_user_settings()
    
    -- ⚠️ 中文key必须用方括号语法
    local auto_fight_自动饱食度 = settings["auto_fight_自动饱食度"]
    local auto_自动巡山 = settings["auto_自动巡山"]
    local auto_自动除妖 = settings["auto_自动除妖"]
    local auto_fight_自动打怪 = settings["auto_fight_自动打怪"]
    
    -- 主循环
    while true do
        综合调用.操作_关闭异常提示弹出()
        
        if auto_自动除妖 then
            log("⚔️ 自动除妖开始！")
            主程序调用.主程序_除妖()
        end
        
        if auto_自动巡山 then
            log("⭐ 自动巡山开始！")
            主程序调用.主程序_巡山()
        end
        
        if auto_fight_自动打怪 then
            log("⚔️ 自动打怪开始！")
            主程序调用.主程序_除妖()
        end
        
        sleep(1000)
    end
end

main()