用途:为 FiveM 开发基于 Qbox Project(qbx_core)的资源,提供开发规范与模式参考。
主要能力:
- 哲学与 API 风格:Qbox 摒弃全局 Core Object 模式(仍可通过 bridge 支持),改用直接 exports 与导入模块。推荐写法:local player = exports.qbx_core:GetPlayer(source);兼容旧写法:local QBCore = exports['qb-core']:GetCoreObject()。
- 关键依赖:Qbox 以 Ox 优先,常用 ox_lib(UI、回调、区域、工具)、ox_inventory(物品与库存)、oxmysql(数据库交互)。
- 玩家管理:通过 exports.qbx_core:GetPlayer(source) 获取玩家;玩家数据使用内部 setter/getter 经 exports 暴露,而非 QBCore 的查找表;保存/加载自动处理,自定义数据可通过 GetPlayer(source).Functions.SetMetaData 保存。
- 资源结构:示例目录含 fxmanifest.lua(依赖 qbx_core)、client/main.lua、server/main.lua、locales/en.json(ox_lib 通常用 .json 本地化文件)。
使用方式:按上述 exports 与模块方式编写资源,依赖 qbx_core 并在 fxmanifest.lua 中声明;本地化文件采用 ox_lib 的 .json 格式。
适用场景:FiveM 服务器端与客户端资源开发、从 QBCore 迁移或兼容移植。
限制:资料未提供具体安装命令、收费信息、平台支持范围及效果说明,暂未提供。官方文档见 https://docs.qbox.re/,代码库见 https://github.com/Qbox-project/qbx_core。