ライセンスキーエラー、サーバーブラウザでの表示、リソースの不具合、クライアント接続、データベースの問題、パフォーマンス最適化など、RedM サーバーの一般的な問題に関するトラブルシューティングガイドです。初期セットアップ手順については、RedM サーバーセットアップガイドをご覧ください。

ライセンスキーエラー

ライセンスキーの問題は、新しい RedM サーバーを起動する際に最もよくある問題です。典型的なエラーとその解決策は以下の通りです:

「Invalid license key」または「Could not authenticate」

サーバーがブラウザに表示されない

サーバーは実行中なのに、プレイヤーが RedM サーバーブラウザで見つけられない場合:

チェックリスト

1. 少なくとも 5 分間待ってください。 起動後、サーバーが Cfx.re マスターサーバーリストに登録されるには時間が必要です。新しいサーバーは表示されるまで数分かかる場合があります。
2. ライセンスキーが有効であることを確認してください。 有効なライセンスキーがなければサーバーはリストに表示されません。サーバーコンソールでライセンス関連のエラーを確認してください。
3. エンドポイント設定を確認してください。 server.cfg の endpoint_add_tcp および endpoint_add_udp が正しいポートを使用していることを確認してください:

   endpoint_add_tcp "0.0.0.0:30120"
   endpoint_add_udp "0.0.0.0:30120"

   ポートは GPanel で割り当てられたものと一致する必要があります。
4. 「sv_master1」やリスト設定を確認してください。 誤ってサーバーが自身をリストに表示しないように設定していないことを確認してください。設定に sv_master1 "" があってはいけません（これはマスターリストへの登録を無効にします）。
5. サーバーが実際に実行中であることを確認してください。 GPanel コンソールを確認してください。サーバーがクラッシュまたは停止している場合、ブラウザに表示されません。
6. 直接接続を試してください。 サーバーがブラウザに表示されなくても、直接接続は機能するはずです。プレイヤーに RedM で F8 を押して以下を入力してもらってください:

   connect YOUR_SERVER_IP:PORT

リソースの読み込みエラー

リソースエラーは、新しいスクリプトやフレームワークをサーバーに追加する際によく発生します。最も頻繁に起こる問題は以下の通りです:

「Could not find resource [resource_name]」

• リソースフォルダが resources/ ディレクトリに存在しないか、間違った場所にあります。
• フォルダ名が ensure で使用されている名前と一致していません。リソース名は大文字と小文字を区別します。
• 解決策: リソースフォルダが存在し、server.cfg の名前が正確に一致していることを確認してください。GPanel ファイルマネージャーまたは SFTP を使用して確認してください。

「Failed to load resource [resource_name]: manifest error」

• リソースの fxmanifest.lua または __resource.lua に構文エラーがあります。
• マニフェストがリソースフォルダに存在しないファイルを参照しています。
• 解決策: マニフェストファイルを開き、タイプミス、カンマの欠落、存在しないファイルへの参照がないか確認してください。エラーの具体的な行番号についてはサーバーコンソールを確認してください。

「Error loading script [filename]: [error details]」

• リソース内の Lua、C#、または JavaScript ファイルに構文エラーまたはランタイムエラーがあります。
• 解決策: コンソールで完全なエラーメッセージを読んでください。ファイル名と行番号が含まれています。一般的な原因は以下の通りです:
  • 依存関係の欠落（先に読み込む必要がある別のリソース）
  • 現在の RedM サーバーバージョンと互換性のない古いリソース
  • リソースの設定ファイル内の誤った設定値

リソースの読み込み順序の問題

server.cfg 内のリソースは、記載されている順序で読み込まれます。あるリソースが別のリソースに依存している場合（例: vorp_inventory が vorp_core に依存）、依存先を先に記載する必要があります:

# Correct order - dependencies first
ensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure vorp_stores

# Wrong order - will cause errors
# ensure vorp_inventory   <-- depends on vorp_core
# ensure vorp_core        <-- loaded too late

クライアント接続の問題

プレイヤーがサーバーに接続できない場合:

「Connection timed out」/「Failed to connect」

「Connection rejected by server」

• サーバーパスワード: sv_password が設定されている場合、プレイヤーは正しいパスワードを入力する必要があります。
• ホワイトリスト/許可リストリソース: ホワイトリストリソースが有効になっている場合、プレイヤーは接続前に承認される必要があります。
• バン: プレイヤーがバンされている可能性があります。バンリストまたはデータベースで識別子を確認してください。

接続時にクライアントがクラッシュする

• サーバー上のリソースが不正なデータを送信しているか、クライアントをクラッシュさせるクライアント側スクリプトエラーがあります。
• 解決策: 最近追加したリソースを 1 つずつ無効にして問題のあるものを特定してください。クライアント接続中のエラーについてサーバーコンソールを確認してください。
• プレイヤーの RedM クライアントが最新であることを確認してください。

「Could not download file」エラー

• サーバーが転送制限を超える大きなファイル（例: ストリーミングアセット）を送信しようとしているか、接続が不安定です。
• 解決策: ストリーミングされるアセットのサイズを縮小するか、サポートされている場合は大きなファイルに CDN/外部ホスティングを使用するか、プレイヤーに接続を再試行してもらってください。

データベースの問題（MySQL / oxmysql）

ほとんどの RedM ロールプレイフレームワークは、永続的なデータ保存に MySQL を使用します。最も一般的なデータベースコネクタは oxmysql です。

接続失敗エラー

oxmysql（または別の MySQL コネクタ）が接続に失敗した場合は、以下を確認してください:

# Typical oxmysql connection string in server.cfg
set mysql_connection_string "mysql://user:password@host:3306/database_name?charset=utf8mb4"

テーブルの欠落またはスキーマエラー

ロールプレイフレームワークは、機能する前にデータベーステーブルのセットアップが必要な場合がよくあります:

1. フレームワークのドキュメントまたは GitHub リポジトリで SQL インポートファイル（多くの場合 database.sql、schema.sql などの名前）を確認してください。
2. phpMyAdmin または MySQL クライアントを使用して、SQL ファイルをデータベースにインポートしてください。
3. 一部のフレームワークは初回起動時にテーブルを自動作成します。データベースユーザーに CREATE TABLE 権限があることを確認してください。

パフォーマンスの問題

RedM サーバーでラグ、低ティックレート、または全般的なパフォーマンス低下が発生している場合:

パフォーマンス問題の特定

パフォーマンス警告についてサーバーコンソールを確認してください。RedM サーバーは約 30〜64 ティック/秒のティックレートを目標としています。これは以下で監視できます:

• txAdmin ダッシュボード: txAdmin が利用可能な場合、リアルタイムのサーバーパフォーマンス指標が表示されます。
• サーバーコンソール: 「slow tick」または「resource hitch」警告に注意してください。
• resmon コマンド: サーバーコンソール（または F8 コンソール）で resmon 1 と入力すると、リソースごとの CPU 時間を表示するリソースモニターが有効になります。

一般的なパフォーマンスの解決策

推奨される実践

• GPanel のスケジュール機能または txAdmin を使用して、蓄積されたメモリやエンティティの問題をクリアするために、6〜12 時間ごとに自動再起動をスケジュールしてください。
• パフォーマンスの修正と最適化の恩恵を受けるために、リソースを最新の状態に保ってください。
• 機能の重複を避けてください — 同じことを行う 2 つのリソース（例: 2 つの天候システム）を実行しないでください。
• メインサーバーに展開する前に、新しいリソースをステージングサーバー（またはプレイヤー数の少ない環境）でテストしてください。
• 問題を早期に発見するために、GPanel または txAdmin を通じてサーバー指標を定期的に監視してください。

一般的なトラブルシューティングのヒント

1. 常にサーバーコンソールの出力を読んでください。 ほぼすべてのエラーには、何が問題でどこで発生したかを示すメッセージがコンソールに含まれています。
2. 設定変更後はサーバーを再起動してください。 server.cfg へのほとんどの変更は、反映させるためにサーバーの完全な再起動が必要です。
3. 問題を切り分けるために、リソースを 1 つずつ無効にしてください。server.cfg の ensure 行を # でコメントアウトしてください。
4. 変更を加える前に、動作する設定のバックアップを保管してください。大きな更新の前に server.cfg とデータベースをダウンロードしてください。
5. FiveM と RedM の両方に適用される公式ドキュメントについては、docs.fivem.net で Cfx.re フォーラムとドキュメントを確認してください。
6. サーバーバージョンとのリソースの互換性を確認してください。古いバージョン向けに構築されたリソースは、現在の RedM ビルドでは動作しない場合があります。

関連記事

• RedM サーバーセットアップガイド — ライセンスキー、server.cfg の設定、リソース管理、接続。
• サーバーの IP とポートの確認方法
• SFTP でファイルをアップロードする方法
• 新しいサーバーを始める

お困りですか？

RedM サーバーで依然として問題が発生していますか？ サポートチケットを開いて、サーバーコンソールのエラーメッセージを記載してください。チームが問題の診断と解決をお手伝いいたします。