メインコンテンツへスキップ
見出し画像

【FiveM】claude codeを使って  QBox で個人サーバーを一から立てた記録(2026年版)

    はじめに

    「自作スクリプトをテストしたい」「友達と少人数で遊びたい」——そんな目的で、FiveM の個人サーバーをゼロから構築しました。フレームワークは今主流の QBox(QBCore の後継)。この記事では、実際にハマったポイントも含めて手順を残しておきます。

    環境

    • Windows 11

    • フレームワーク:QBox

    • データベース:MariaDB

    • 管理:txAdmin(FXServer内蔵)


    全体の流れ

    1. サーバー本体(FXServer)の用意

    2. データベース(MariaDB)の用意

    3. txAdmin で管理者登録

    4. QBox を自動デプロイ

    5. 起動・接続確認


    ステップ1:サーバー本体(FXServer)を用意

    FiveM公式アーティファクトから最新の server.7z をダウンロードし、任意のフォルダに展開します。今回は build 31039 を使用。

    ⚠️ ハマりポイント①:フォルダパスに日本語を使わない

    最初、デスクトップの「FiveM 新規サーバー」フォルダに置いたところ、txAdmin が起動せず以下のエラー:

    FATAL ERROR: E1007

    your paths CANNOT contain non-ASCII characters.

    txAdmin はパスに日本語(非ASCII文字)があると動きません。 C:\FiveMServer のような半角英数字のみのパスに置き直して解決しました。

    ⚠️ ハマりポイント②:OneDrive 配下に置かない

    サーバーは数千〜数万ファイルになり、起動中も大量に書き換わります。OneDrive 同期フォルダに置くと、同期エラー・容量圧迫・ファイルロックの原因に。必ず OneDrive 外のローカルパスに置きましょう。


    ステップ2:データベース(MariaDB)を用意

    QBox には MySQL系DBが必須です。

    ⚠️ ハマりポイント③:XAMPP は使わない

    日本語の古い記事では XAMPP がよく使われますが、QBox公式は「XAMPP は絶対に使うな」と明記しています。素直に MariaDB を入れましょう。

    winget install MariaDB.Server --silent --override "/passive PASSWORD=(任意のパスワード) SERVICENAME=MariaDB PORT=3306 UTF8=1"

    MariaDB はサービスとして自動起動するので、毎回手動で立ち上げる必要もなく、GUI管理ツール HeidiSQL も同梱されて便利です。


    ステップ3:txAdmin で管理者登録

    サーバーフォルダの FXServer.exe を起動すると txAdmin が立ち上がり、コンソールに登録用PINが表示されます。

    http://localhost:40120/

    Use the PIN below to register: 4175

    ブラウザで http://localhost:40120/ を開き、PINを入力して管理者アカウント(ユーザー名・パスワード)を作成します。


    ステップ4:QBox を自動デプロイ

    ここが一番ラクなところ。txAdmin のセットアップウィザードで:

    「Popular Recipes」→「QBox Framework」 を選ぶだけ。

    必要なもの:ライセンスキー(Server Registration Key)

    Cfx.re Keymaster でログインし、「+ New server」→ Server type: Self-hosted でキー(cfxk_xxxxxxxx)を発行しておきます。デプロイ時に入力します。

    ⚠️ ハマりポイント④:DBオプションは必ず開いて入力

    入力画面の 「Show/Hide Database options (advanced)」 を開き、MariaDB の接続情報を入れます。

    欄値HostlocalhostPort3306UsernamerootPassword(ステップ2で設定したパスワード)

    パスワード欄を空のままだと接続に失敗します。 root にパスワードを設定した場合は必ず入力を。

    「Run Recipe」を押すと、QBox本体・ox_lib・ox_inventory・スマホ(npwd)など 約99リソースが自動ダウンロードされ、DBにもテーブルがインポートされます(数分)。

    All tasks completed.

    Deploy finished and folder validated. All done!


    ステップ5:起動・接続確認

    最後に txAdmin が server.cfg を生成してサーバーを起動。ログに以下が出れば成功です。

    [oxmysql] Database server connection established!

    Authenticated with cfx.re Nucleus: https://xxxxx.users.cfx.re/

    [ox_inventory] Inventory has loaded 301 items

    Welcome to Qbox!

    FiveM クライアントで F8 →「connect localhost」 で自分のサーバーに接続できます。キャラ作成画面が出れば完成!


    まとめ:ハマりポイント4選

    1. パスに日本語を使わない(txAdmin E1007エラー)

    2. OneDrive配下に置かない(同期トラブル)

    3. XAMPPではなくMariaDBを使う(QBox公式推奨)

    4. デプロイ時のDBパスワードを忘れず入力

    QBox は QBCore スクリプトの約99%がそのまま動く互換性があり、自作スクリプトのテスト環境としても優秀でした。次回は自作スクリプトの導入編を書く予定です。


    このサーバーは個人・少人数用です。一般公開する場合はセキュリティやライセンス周りの確認をお忘れなく。

    不明点ありましたら、公式discordサーバーよりご質問ください。

     
     
    素人がClaude Codeで遊ぶだけの記事です! Claude Code、AI活用、開発関連の話題を発信していきます!

    あなたへのおすすめ