# Qbox Framework

> Develops resources for FiveM using the Qbox Project (qbx_core). Covers the exports-based API, bridge compatibility, Ox integration (ox_lib, ox_inventory), and best practices. Use when the user works with FiveM, Qbox, qbx_core, or mentions `exports.qbx_core`, `QBX.PlayerData`, or `ox_lib`.

- Skill: `proelias7/qbox-framework` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add proelias7/qbox-framework`
- Raw SKILL.md: https://api.skillmd.com/api/skills/proelias7/qbox-framework/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: proelias7 (https://skillmd.com/u/proelias7)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/proelias7/qbox-framework

---


# Qbox Framework Development

**Language rule:** Internal reasoning is in compact English. All messages and output displayed to the user must be in the user's language.

This skill provides guidelines and patterns for developing resources using the **Qbox Project (qbx_core)**.

## 1. Philosophy: Exports & Modules

Qbox moves away from the global "Core Object" pattern (though supported via bridge) in favor of **direct exports** and **imported modules**.

**Modern Native Way (Preferred):**
```lua
local player = exports.qbx_core:GetPlayer(source)
```

**Bridge Way (Legacy/Porting):**
```lua
local QBCore = exports['qb-core']:GetCoreObject() -- Works via qbx_core bridge
```

## 2. Key Dependencies

Qbox is built "Ox-First". You will frequently use:
- **ox_lib**: For UI, callbacks, zones, and utilities.
- **ox_inventory**: For items and inventory management.
- **oxmysql**: For database interactions.

## 3. Player Management

- **Get Player:** `exports.qbx_core:GetPlayer(source)`
- **Player Data:** Unlike QBCore's lookup table, Qbox uses internal setters/getters exposed via exports.
- **Save/Load:** Handled automatically, but custom data can be saved via `GetPlayer(source).Functions.SetMetaData`.

## 4. Resource Structure

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

## 5. Documentation
- Official Docs: https://docs.qbox.re/
- Github: https://github.com/Qbox-project/qbx_core