このガイドでは、FiveM サーバーにリソース(スクリプト)をインストールする方法、ESX や QBCore などのフレームワーク用に MySQL データベースをセットアップする方法、およびリソースの読み込み順序の理解について説明します。初期サーバーセットアップをまだ完了していない場合は、まず FiveM サーバーセットアップガイド から始めてください。

リソースとスクリプトのインストール

FiveM サーバーは リソース(スクリプトとも呼ばれます)で拡張されます。リソースは、車のディーラー、ジョブ、HUD 要素、フレームワークなどの機能を追加します。

リソースのインストール方法

1. ソース(GitHub、Cfx.re フォーラム、Tebex など)からリソースをダウンロードします。
2. 必要に応じて、ZIP/アーカイブからリソースフォルダを展開します。
3. GPanel の Files タブまたは SFTP を使用して、リソースフォルダをサーバーの resources/ ディレクトリにアップロードします。
4. server.cfg を開き、リソースの ensure 行を追加します:

# Add your custom resources
ensure my-new-resource

5. リソースを読み込むために、GPanel または TXAdmin からサーバーを再起動します。

リソースマニフェスト

有効なリソースには必ずマニフェストファイルが含まれている必要があります。最新のリソースは fxmanifest.lua を使用し、古いものは __resource.lua を使用します。ダウンロードしたリソースフォルダにこれらのファイルのいずれも含まれていない場合、リソースは読み込まれません。一部のダウンロードでは、実際のリソースフォルダが外側のフォルダ内にネストされています — resources/ に配置するフォルダが、マニフェストを含むものであることを確認してください。

リソースの読み込み順序

リソースは server.cfg に表示される順序で読み込まれます。リソースが別のリソースに依存する場合(たとえば、ESX や QBCore などのフレームワークに依存するジョブスクリプト)、それを必要とするリソースの 前 に依存関係がリストされていることを確認してください:

# Database resource first
ensure oxmysql

# Framework second
ensure es_extended

# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshop

カテゴリフォルダによるリソースの整理

リソースを resources/ ディレクトリ内のサブフォルダに整理できます。server.cfg でブラケット記法を使用して、カテゴリフォルダ全体を ensure します:

# Ensure all resources inside resources/[esx]/
ensure [esx]

# Ensure all resources inside resources/[standalone]/
ensure [standalone]

これにより、指定されたサブフォルダ内のすべてのリソースが読み込まれます。各リソースを個別にリストすることなく、関連するスクリプトをグループ化する便利な方法です。

TXAdmin によるリソースのホットロード

新しいリソースを読み込むのに、必ずしも完全なサーバー再起動が必要なわけではありません。TXAdmin は、その Resources ページから個々のリソースを起動、停止、再起動できます。新しいリソースをアップロードしてその ensure 行を追加した後、TXAdmin のライブコンソールで次のコマンドを実行できます:

refresh
ensure my-new-resource

refresh コマンドは、新しいエントリについて resources/ ディレクトリを再スキャンするようサーバーに指示します。

データベースのセットアップ (MySQL / MariaDB)

多くの FiveM フレームワークやリソース(ESX、QBCore、vRP など)は、MySQL または MariaDB データベースを必要とします。Legion Hosting はサーバーにデータベース認証情報を提供します。

データベース認証情報の確認

1. GPanel で、Databases タブに移動します。
2. データベースがまだ存在しない場合は、New Database をクリックして作成します。
3. 以下の詳細を控えておきます:
   • Database Host(アドレスとポート)
   • Database Name
   • Username
   • Password(目のアイコンをクリックして表示します)

データベース接続の設定

データベース接続の詳細は、接続文字列を使用して server.cfg で設定します。正確な形式は使用している MySQL リソースによって異なりますが、最も一般的な形式は次のとおりです:

# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

プレースホルダを Databases タブの実際の認証情報に置き換えます。例:

set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"

MySQL リソースの選択

どの MySQL リソースを使用する場合でも、それに依存するリソースの 前 に server.cfg で ensure する必要があります:

# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"

# MySQL resource — must load before framework
ensure oxmysql

# Framework
ensure es_extended

フレームワークの基礎

フレームワークは、他のリソースが構築する中核的なゲームプレイシステム — プレイヤーの ID、お金、インベントリ、ジョブ、車両などを提供します。最も人気のある 2 つの FiveM フレームワークは次のとおりです:

ほとんどのフレームワークは、初期セットアップ中に TXAdmin のレシピシステムを介してインストールされます。TXAdmin のセットアップ中に「QBCore」や「ESX」などのレシピを選択した場合、フレームワークとその中核的な依存関係はすでにインストールされています。フレームワークを手動でインストールする必要がある場合は、その公式ドキュメントに従ってください:

• ESX ドキュメント
• QBCore ドキュメント

サポートを受ける

リソースのインストールやデータベースの設定についてサポートが必要な場合:

1. インストール手順や既知の問題について、リソースのドキュメントまたは GitHub ページを確認してください。
2. エラーメッセージについて GPanel コンソールまたは TXAdmin ログを確認してください。
3. https://legionhosting.net/submitticket.php でサポートチケットを開き、エラーメッセージとインストールしようとしているリソースの名前を記載してください。

関連記事

• FiveM サーバーセットアップガイド
• FiveM トラブルシューティング
• SFTP でファイルをアップロードする方法
• サーバーの IP とポートを確認する方法