用途:为 FiveM 服务器开发基于 QBCore 框架的资源,提供开发规范与代码模式。
主要能力:涵盖资源创建、Core Object 使用、玩家管理、回调(Callbacks)、事件、物品、职业、帮派等内容。
必要用法:需先获取 Core Object,并在脚本顶部用局部变量缓存:local QBCore = exports['qb-core']:GetCoreObject()。服务端用 QBCore.Functions.GetPlayer(source) 获取玩家对象,Player.PlayerData 含职业、帮派、金钱、物品、元数据等;玩家临时用 Source 标识,持久化用 CitizenID。回调方面,服务端用 QBCore.Functions.CreateCallback 发送数据,客户端用 QBCore.Functions.TriggerCallback 请求数据,且服务端必须校验客户端数据。物品用 QBCore.Functions.CreateUseableItem 注册,定义在 qb-core/shared/items.lua(或 qb-inventory)。数据库默认使用 oxmysql,可用 MySQL.query、MySQL.insert、MySQL.update、MySQL.scalar。标准资源结构包含 fxmanifest.lua、config.lua、client/main.lua、server/main.lua。
最佳实践:缓存 Core Object,避免在循环中调用;优先用回调获取数据;校验输入(职业、金钱、归属);按距离动态 Wait 优化循环;使用 qb-core/shared/locale.lua 或 Lang 对象做本地化。
限制:资料未提供具体收费、平台支持范围或效果数据。官方文档见 https://docs.qbcore.org/,GitHub 见 https://github.com/qbcore-framework/qb-core。