mcpField
Q
qbox-framework

qbox-framework

github.com/proelias7开发7147 次安装4 周前更新
代码仓库

关于 qbox-framework

为 Qbox Project（qbx_core）资源开发提供指南的技能，面向 FiveM 资源开发者。内容侧重直接 exports 与模块、Ox 系依赖、玩家数据访问和标准资源结构，并兼顾旧版桥接方式。

主要功能

  1. 01推荐使用 qbx_core 直接 exports
  2. 02说明旧版 QBCore 桥接方式
  3. 03介绍 ox_lib、ox_inventory 和 oxmysql
  4. 04提供玩家数据与元数据操作指引
  5. 05展示资源目录结构

适用场景

  1. 01为 qbx_core 创建新资源
  2. 02将旧 QBCore 资源迁移到 Qbox
  3. 03实现玩家数据或元数据处理
  4. 04规划客户端与服务端文件结构

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/proelias7/fivem-skill --skill qbox-framework

安装后在 Claude Code 中输入/qbox-framework确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

best-practices.md
examples.md
reference.md
templates.md

详细介绍

Qbox 框架开发

**语言规则：**内部推理使用简洁的英语。所有向用户展示的消息和输出都必须使用用户的语言。

本技能提供使用 Qbox Project (qbx_core) 开发资源的指南和模式。

1. 理念：导出与模块

Qbox 不再采用全局“Core Object”模式（但可通过 bridge 支持），而是倾向于使用直接导出和导入的模块。

现代原生方式（首选）：

local player = exports.qbx_core:GetPlayer(source)

Bridge 方式（旧版/移植）：

local QBCore = exports['qb-core']:GetCoreObject() -- Works via qbx_core bridge

2. 关键依赖项

Qbox 采用“Ox 优先”的构建方式。你会经常用到：

  • ox_lib：用于 UI、回调、区域和实用工具。
  • ox_inventory：用于物品和库存管理。
  • oxmysql：用于数据库交互。

3. 玩家管理

  • 获取玩家：exports.qbx_core:GetPlayer(source)
  • **玩家数据：**与 QBCore 的查找表不同，Qbox 通过导出公开内部的 setter/getter。
  • **保存/加载：**自动处理，但可以通过 GetPlayer(source).Functions.SetMetaData 保存自定义数据。

4. 资源结构

my-resource/
├── fxmanifest.lua     # Depends on qbx_core
├── client/
│   └── main.lua
├── server/
│   └── main.lua
└── locales/           # Ox_lib uses .json locales usually
    └── en.json

5. 文档

评论

支持 Markdown