QB-Core资源重写/扩展最佳实践问询（以qb-shops为例）

方案1：事件劫持与逻辑扩展（最稳妥，无资源替换风险） #

qb-shops的核心逻辑依赖FiveM事件系统（如客户端qb-shops:client:openShopMenu、服务器qb-shops:server:buyItem），可通过监听并覆盖原事件的方式，在不修改原资源的前提下注入自定义逻辑：

客户端示例（扩展商店菜单） #

-- 覆盖原商店菜单事件，添加VIP专属商品逻辑
AddEventHandler('qb-shops:client:openShopMenu', function(shopItems, data)
    -- 自定义扩展：为VIP用户追加专属商品
    local modifiedShopItems = {}
    for k, v in pairs(shopItems) do
        table.insert(modifiedShopItems, v)
        if QBCore.Functions.HasPermission('vip') then
            table.insert(modifiedShopItems, {
                name = 'vip_armor',
                price = 5000,
                amount = 10,
                info = {},
                type = 'item',
                slot = #modifiedShopItems + 1,
                label = 'VIP专属护甲'
            })
        end
    end

    -- 执行原菜单逻辑（复制qb-shops的CreateShopMenu核心代码）
    CreateThread(function()
        SetNuiFocus(true, true)
        SendNUIMessage({
            action = "openShop",
            data = {
                items = modifiedShopItems,
                label = data.label
            }
        })
    end)
end)

服务器端示例（添加VIP折扣） #

RegisterServerEvent('qb-shops:server:buyItem', function(itemName, amount, shop)
    local src = source
    local Player = QBCore.Functions.GetPlayer(src)
    local discount = QBCore.Functions.HasPermission(src, 'vip') and 0.8 or 1.0
    local item = QBCore.Shops[shop][itemName]
    local totalPrice = item.price * amount * discount

    -- 保留原资源的余额检查与物品发放逻辑
    if Player.Functions.GetMoney('cash') >= totalPrice then
        Player.Functions.RemoveMoney('cash', totalPrice)
        Player.Functions.AddItem(itemName, amount)
        TriggerClientEvent('QBCore:Notify', src, string.format('购买x%s %s，花费$%s', amount, item.label, totalPrice))
    else
        TriggerClientEvent('QBCore:Notify', src, '余额不足', 'error')
    end
end)

注意：复制原资源核心逻辑时，需同步原版本更新，避免兼容性问题。

方案2：全局环境劫持（模拟OOP继承） #

利用Lua的环境机制，通过调整资源加载优先级让自定义资源先于qb-shops启动，劫持全局对象或函数实现功能扩展：

服务器端示例（劫持商店注册逻辑） #

-- 保存原有的商店注册函数
local originalAddShop = QBCore.Functions.AddShop

-- 重写函数，自动为所有商店添加VIP商品
QBCore.Functions.AddShop = function(shopName, shopData)
    shopData['vip_armor'] = {
        name = 'vip_armor',
        price = 5000,
        amount = 10,
        info = {},
        type = 'item',
        label = 'VIP专属护甲'
    }
    -- 调用原函数完成注册
    originalAddShop(shopName, shopData)
end

这种方式类似OOP的方法重写，适合全局范围的功能增强，无需复制大量原逻辑。

方案3：利用provides字段替换资源标识（需谨慎） #

FiveM的provides字段用于声明资源提供的服务标识，若原qb-shops的fxmanifest.lua中有provides 'qb-shops'，可创建新资源并在自身fxmanifest中配置：

fx_version 'cerulean'
game 'gta5'

provides 'qb-shops'
dependency 'qb-core'
dependency 'qb-shops' -- 依赖原资源，确保原逻辑加载

client_scripts {
    'client/*.lua'
}

server_scripts {
    'server/*.lua'
}

之后在自定义资源中重定义qb-shops的核心函数，同时调用原资源逻辑。但该方案存在风险：原资源更新可能导致标识冲突，部分框架会优先加载provides声明的资源，需严格控制加载顺序。

最佳实践总结 #

1. 优先选择事件劫持方案：无需修改原资源，兼容性最强，适合局部功能扩展
2. 全局环境劫持：适合全局范围的功能增强，模拟OOP继承/重写逻辑
3. provides字段仅用于极端场景：如需要完全重写资源但保留原依赖的情况，需充分测试加载顺序与兼容性

内容的提问来源于stack exchange，提问作者Maxpumpe