qbox-framework

Qbox フレームワークの開発

言語ルール： 内部推論は簡潔な英語で行います。ユーザーに表示するすべてのメッセージと出力は、ユーザーの言語で記述します。

このスキルでは、**Qbox Project（qbx_core）**を使用したリソース開発のガイドラインとパターンを紹介します。

1. 設計思想：エクスポートとモジュール

Qbox は、グローバルな「Core Object」パターン（ブリッジ経由でのサポートはあります）から離れ、直接エクスポートとインポートしたモジュールを優先します。

最新のネイティブな方法（推奨）：

local player = exports.qbx_core:GetPlayer(source)

ブリッジ方式（レガシー／移植用）：

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

2. 主な依存関係

Qbox は「Ox-First」を基本としています。次のツールを頻繁に使用します。

• ox_lib：UI、コールバック、ゾーン、ユーティリティに使用します。
• ox_inventory：アイテムとインベントリ管理に使用します。
• oxmysql：データベース操作に使用します。

3. プレイヤー管理

• プレイヤーの取得： exports.qbx_core:GetPlayer(source)
• プレイヤーデータ： QBCore のルックアップテーブルとは異なり、Qbox ではエクスポート経由で公開される内部のセッター／ゲッターを使用します。
• 保存／読み込み： 自動的に処理されますが、カスタムデータは 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. ドキュメント

• 公式ドキュメント：https://docs.qbox.re/
• Github：https://github.com/Qbox-project/qbx_core