tszz-server/meta/userapi/lua/GameHookManager.lua

--- 游戏钩子管理器
--- 集中管理所有游戏触发检测点，方便后期增加自有逻辑
--- Created by AI Assistant
--- DateTime: 2024/12/19

GameHookManager = {}

local this = {}

-- 钩子类型常量
local HookType = {
    -- 玩家相关
    PLAYER_LEVEL_UP = "player_level_up",           -- 玩家升级
    PLAYER_LOGIN = "player_login",                 -- 玩家登录
    PLAYER_LOGOUT = "player_logout",               -- 玩家登出
    PLAYER_CHANGE_NAME = "player_change_name",     -- 玩家改名
    PLAYER_DIE = "player_die",                     -- 玩家死亡
    PLAYER_PK = "player_pk",                       -- 玩家PK
    PLAYER_UNDER_ATTACK = "player_under_attack",   -- 玩家被攻击
    PLAYER_TRANSFER_CAREER = "player_transfer_career", -- 玩家转职
    
    -- 装备相关
    EQUIP_PUT_ON = "equip_put_on",                 -- 穿戴装备
    EQUIP_TAKE_OFF = "equip_take_off",             -- 脱下装备
    EQUIP_STRENGTHEN = "equip_strengthen",         -- 装备强化
    EQUIP_APPEND = "equip_append",                 -- 装备追加
    EQUIP_SYNTHESIS = "equip_synthesis",           -- 装备合成
    EQUIP_RECOVERY = "equip_recovery",             -- 装备回收
    EQUIP_OVERLAY = "equip_overlay",               -- 装备叠加
    EQUIP_REGENERATION = "equip_regeneration",     -- 装备再生
    EQUIP_TRANSFER = "equip_transfer",             -- 装备属性转移
    EQUIP_FASHION = "equip_fashion",               -- 装备幻化
    EQUIP_COLOR = "equip_color",                   -- 装备染色
    EQUIP_TITLE = "equip_title",                   -- 装备称号
    EQUIP_GUARD = "equip_guard",                   -- 装备守护
    EQUIP_GEM = "equip_gem",                       -- 装备宝石
    EQUIP_ORNAMENTS = "equip_ornaments",           -- 装备首饰
    WEAPON_CHANGE = "weapon_change",               -- 武器切换
    
    -- 战斗相关
    MONSTER_KILL = "monster_kill",                 -- 击杀怪物
    MONSTER_FIRST_ATTACK = "monster_first_attack", -- 首刀攻击
    MONSTER_LAST_KILL = "monster_last_kill",       -- 尾刀击杀
    MONSTER_DAMAGE = "monster_damage",             -- 对怪物造成伤害
    MONSTER_ENTER_ATTACK = "monster_enter_attack", -- 怪物进入战斗
    MONSTER_LEAVE_ATTACK = "monster_leave_attack", -- 怪物离开战斗
    MONSTER_ENTER_VIEW = "monster_enter_view",     -- 怪物进入视野
    MONSTER_DIE = "monster_die",                   -- 怪物死亡
    MONSTER_DIE_EXP = "monster_die_exp",           -- 怪物死亡经验
    MONSTER_DIE_DROP = "monster_die_drop",         -- 怪物死亡掉落
    
    -- 副本相关
    DUPLICATE_ENTER = "duplicate_enter",           -- 进入副本
    DUPLICATE_EXIT = "duplicate_exit",             -- 退出副本
    DUPLICATE_FINISH = "duplicate_finish",         -- 完成副本
    DUPLICATE_STATE_CHANGE = "duplicate_state_change", -- 副本状态变化
    DUPLICATE_SECOND_HEART = "duplicate_second_heart", -- 副本心跳
    
    -- 掉落相关
    ITEM_DROP = "item_drop",                       -- 物品掉落
    ITEM_PICKUP = "item_pickup",                   -- 拾取物品
    ITEM_USE = "item_use",                         -- 使用物品
    ITEM_DESTROY = "item_destroy",                 -- 销毁物品
    ITEM_TRADE = "item_trade",                     -- 交易物品
    ITEM_ADD_BAG = "item_add_bag",                 -- 物品进背包
    ITEM_CHANGE = "item_change",                   -- 物品变化
    ITEM_SYNTHESIS = "item_synthesis",             -- 物品合成
    ITEM_RECOVERY = "item_recovery",               -- 物品回收
    ITEM_DECOMPOSITION = "item_decomposition",     -- 物品分解
    
    -- 任务相关
    TASK_ACCEPT = "task_accept",                   -- 接受任务
    TASK_FINISH = "task_finish",                   -- 完成任务
    TASK_SUBMIT = "task_submit",                   -- 提交任务
    TASK_GOAL_UPDATE = "task_goal_update",         -- 任务目标更新
    TASK_PROGRESS_COMPLETE = "task_progress_complete", -- 任务进度完成
    TASK_REFRESH = "task_refresh",                 -- 任务刷新
    
    -- 活动相关
    ACTIVITY_ENTER = "activity_enter",             -- 进入活动
    ACTIVITY_FINISH = "activity_finish",           -- 完成活动
    ACTIVITY_REWARD = "activity_reward",           -- 获得活动奖励
    ACTIVITY_CHANGE = "activity_change",           -- 活动状态变化
    ACTIVITY_COUNT_RESET = "activity_count_reset", -- 活动次数重置
    
    -- 充值消费相关
    RECHARGE = "recharge",                         -- 充值
    CONSUME_DIAMOND = "consume_diamond",           -- 消费钻石
    CONSUME_GOLD = "consume_gold",                 -- 消费金币
    CONSUME_ITEM = "consume_item",                 -- 消费道具
    BUY_MALL_GOODS = "buy_mall_goods",            -- 购买商城商品
    BUY_NPC_SHOP_GOODS = "buy_npc_shop_goods",    -- 购买NPC商店商品
    
    -- 战盟相关
    UNION_JOIN = "union_join",                     -- 加入战盟
    UNION_LEAVE = "union_leave",                   -- 离开战盟
    UNION_DONATE = "union_donate",                 -- 战盟捐献
    UNION_CREATE = "union_create",                 -- 创建战盟
    UNION_CLOSE = "union_close",                   -- 解散战盟
    UNION_ADD_MEMBER = "union_add_member",         -- 战盟添加成员
    UNION_DEL_MEMBER = "union_del_member",         -- 战盟删除成员
    
    -- 地图相关
    MAP_ENTER = "map_enter",                       -- 进入地图
    MAP_LEAVE = "map_leave",                       -- 离开地图
    MAP_LINE_ENTER = "map_line_enter",             -- 进入地图分线
    MAP_CREATE = "map_create",                     -- 创建地图
    MAP_DESTROY = "map_destroy",                   -- 销毁地图
    MAP_MONSTER_DIE = "map_monster_die",           -- 地图怪物死亡
    MAP_MONSTER_REMOVE = "map_monster_remove",     -- 地图怪物移除
    
    -- 特殊系统
    VIP_UPGRADE = "vip_upgrade",                   -- VIP升级
    PRIVILEGE_ACTIVATE = "privilege_activate",     -- 激活特权
    WINGS_UPGRADE = "wings_upgrade",               -- 翅膀升级
    ANGEL_GRAIL_UPGRADE = "angel_grail_upgrade",   -- 天使圣杯升级
    COMBO_SKILL_ACTIVATE = "combo_skill_activate", -- 激活连击技能
    TRIPLE_INCOME_OPEN = "triple_income_open",     -- 开启三倍收益
    MOUNT_UPGRADE = "mount_upgrade",               -- 坐骑升级
    PET_CALL = "pet_call",                         -- 召唤宠物
    BUFF_EFFECT = "buff_effect",                   -- Buff效果
    BUFF_LOSE = "buff_lose",                       -- Buff消失
    SKILL_RELEASE = "skill_release",               -- 释放技能
    SKILL_REMOVE = "skill_remove",                 -- 移除技能
    COMBO_SET = "combo_set",                       -- 设置连击
    
    -- 心跳相关
    ROLE_SECOND_HEART = "role_second_heart",       -- 角色1秒心跳
    ROLE_3SECOND_HEART = "role_3second_heart",     -- 角色3秒心跳
    ROLE_5SECOND_HEART = "role_5second_heart",     -- 角色5秒心跳
    ROLE_10SECOND_HEART = "role_10second_heart",   -- 角色10秒心跳
    ROLE_MINUTE_HEART = "role_minute_heart",       -- 角色分钟心跳
    ROLE_HOUR_HEART = "role_hour_heart",           -- 角色小时心跳
    MAP_SECOND_HEART = "map_second_heart",         -- 地图1秒心跳
    MAP_3SECOND_HEART = "map_3second_heart",       -- 地图3秒心跳
    MAP_5SECOND_HEART = "map_5second_heart",       -- 地图5秒心跳
    
    -- 其他
    PLAYER_ENTER_VIEW = "player_enter_view",       -- 玩家进入视野
    ATTRIBUTE_UPDATE = "attribute_update",         -- 属性更新
    TRANSMIT = "transmit",                         -- 传送
    SCENE_ENTER = "scene_enter",                   -- 进入场景
    OFFLINE_EXP = "offline_exp",                   -- 离线经验
    STALL_INFO = "stall_info",                     -- 摆摊信息
    DEPLOY_ATTR_POINT = "deploy_attr_point",       -- 加点
    MONSTER_INIT = "monster_init",                 -- 怪物初始化
    SHOW_REWARD_PANEL = "show_reward_panel",       -- 显示奖励面板
}

-- 钩子回调函数存储
local hookCallbacks = {}

-- 导出钩子类型
GameHookManager.HookType = HookType

--- 注册钩子回调函数
--- @param hookType string 钩子类型
--- @param callback function 回调函数
--- @param priority number 优先级(数字越小优先级越高，默认100)
function GameHookManager.RegisterHook(hookType, callback, priority)
    if not hookCallbacks[hookType] then
        hookCallbacks[hookType] = {}
    end
    
    priority = priority or 100
    
    table.insert(hookCallbacks[hookType], {
        callback = callback,
        priority = priority
    })
    
    -- 按优先级排序
    table.sort(hookCallbacks[hookType], function(a, b)
        return a.priority < b.priority
    end)
    
    jprint("注册钩子:", hookType, "优先级:", priority)
end

--- 触发钩子
--- @param hookType string 钩子类型
--- @param ... any 传递给回调函数的参数
function GameHookManager.TriggerHook(hookType, ...)
    if not hookCallbacks[hookType] then
        return
    end
    
    local args = {...}
    
    for _, hook in ipairs(hookCallbacks[hookType]) do
        local success, result = xpcall(hook.callback, debug.traceback, table.unpack(args))
        if not success then
            jprint("钩子执行异常:", hookType, "错误:", result)
        end
    end
end

--- 移除钩子回调
--- @param hookType string 钩子类型
--- @param callback function 要移除的回调函数
function GameHookManager.UnregisterHook(hookType, callback)
    if not hookCallbacks[hookType] then
        return
    end
    
    for i = #hookCallbacks[hookType], 1, -1 do
        if hookCallbacks[hookType][i].callback == callback then
            table.remove(hookCallbacks[hookType], i)
            jprint("移除钩子:", hookType)
            break
        end
    end
end

--- 获取钩子回调数量
--- @param hookType string 钩子类型
--- @return number 回调数量
function GameHookManager.GetHookCount(hookType)
    if not hookCallbacks[hookType] then
        return 0
    end
    return #hookCallbacks[hookType]
end

--- 清空指定类型的钩子
--- @param hookType string 钩子类型
function GameHookManager.ClearHooks(hookType)
    if hookType then
        hookCallbacks[hookType] = nil
        jprint("清空钩子:", hookType)
    else
        hookCallbacks = {}
        jprint("清空所有钩子")
    end
end

--- 初始化钩子管理器
function GameHookManager.Init()
    jprint("游戏钩子管理器初始化完成")
    jprint("支持的钩子类型数量:", table.getn(table.keys(HookType)))
end

-- 导出钩子类型常量
GameHookManager.HookType = HookType