【完全解説】2025年４月版｜ox_inventory導入方法 (QB-Core) #3
【完全解説】2025年4月版｜ox_inventory導入方法（QB-Core）
この記事では、FiveMのQB-Coreフレームワークにox_inventoryを導入する方法を解説します。
ox_inventoryとは？
ox_inventoryは、FiveMで使用されるインベントリシステムの一つで、カスタマイズ性やパフォーマンスに優れています。
デフォルトのQB-Coreインベントリと置き換えることで、より直感的で使いやすいインターフェースを提供します。
必要な準備
-
ox_inventoryリソースのダウンロード
ox_inventory公式GitHubからQB-Core互換バージョン(2.41.0)をダウンロードします。 -
依存リソースの確認
-
oxmysqlが必要です。未導入の場合はoxmysql公式GitHubからダウンロードしてください。 -
ox_libも必要です。ox_libのダウンロードリンクからダウンロードしてください。
-
導入手順
1. サーバーを起動
サーバーファイルの一番上のディレクトリにあるstart_7290_default.batをダブルクリックで起動します。
2. qb-inventory, qb-shops, qb-weaponsの削除
resources/[qb]内にある下記フォルダを削除してください。
qb-inventoryqb-shopsqb-weapons
3. ダウンロードしたファイルの解凍
ox_inventory.zipをダウンロードしたら、解凍します。
Windows標準の機能で解凍可能です。
4. リソースの配置
解凍したox_inventoryフォルダをresourcesディレクトリに配置します。
/resources
├── [qb-core]
├── ox_inventory
├── ox_lib
5. server.cfgの編集
ensure ox_lib
ensure qb-core
exec @ox_inventory/config.cfg
ensure ox_inventory
これでサーバー起動時にox_inventoryが読み込まれます。
6. configファイルの追加・設定
- 公式ドキュメントの「5 Config」からConfigファイルのテンプレートをコピーします。
Configファイルのテンプレートをコピー
-
ox_inventoryフォルダ内にconfig.cfgというファイルを新規作成し、コピーした内容を貼り付けます。
config.cfgを新規作成し、内容を貼り付け
- 貼り付けたコード内のこの部分が
esxになっているので、qbに変更してください。
esx→qbに変更
7. データベースの追加
以下のSQLをHeidiSQLなどで実行し、データベースにテーブルを追加します。
CREATE TABLE IF NOT EXISTS `gloveboxitems` (
`id` int NOT NULL AUTO_INCREMENT,
`plate` varchar(255) DEFAULT NULL,
`items` json DEFAULT NULL,
PRIMARY KEY (`id`),
KEY `plate` (`plate`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `stashitems` (
`id` int NOT NULL AUTO_INCREMENT,
`stash` varchar(255) DEFAULT NULL,
`items` json DEFAULT NULL,
PRIMARY KEY (`id`),
KEY `stash` (`stash`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
CREATE TABLE IF NOT EXISTS `trunkitems` (
`id` int NOT NULL AUTO_INCREMENT,
`plate` varchar(255) DEFAULT NULL,
`items` json DEFAULT NULL,
PRIMARY KEY (`id`),
KEY `plate` (`plate`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
今回はHeidiSQLを使用しますので、他のツールの場合は操作方法が異なることがありますのでご了承ください。
HeidiSQLでの操作手順（クリックで展開）
- 画像の黄色枠の「qbcoreframework_OOOOOO」を選択します。
- 緑枠の「クエリー」をクリックすると、エディター画面が開きます。
- 上記のSQLコードをエディターに貼り付けます。
- 赤枠の「▶」ボタンをクリックして実行しましょう。
HeidiSQLでクエリを実行する画面
実行後、下部に「クエリは正常に実行されました」等のメッセージが表示されれば成功です。
うまくいかない場合は、記事末尾の連絡先までご相談ください。
成功時のメッセージ例
8. サーバーの再起動
txAdminからサーバーを再起動しましょう。
txAdminで再起動
9. インベントリーのデータ移行
txAdminのLive Consoleにて
convertinventory qb
と入力し、緑枠のようにログが流れたらqbからoxへの移行完了です。
データ移行のログ例
10. 動作確認
サーバーに接続し、F2キー（デフォルト）などでインベントリが正しく表示されるか確認しましょう。
問題がある場合は、config.cfgの設定などを再確認してください。
まとめ
これでox_inventoryの導入は完了です。
次回は、ox_inventoryのカスタマイズ方法や他リソースとの連携について解説します。
Discussion