このガイドでは、FiveM サーバーで最もよく発生する問題の解決方法を扱います — TXAdmin のアクセスの問題、CFX ライセンスキーのエラー、データベース接続の失敗、サーバークラッシュ、プレイヤーの接続の問題、リソースが読み込まれない問題などです。初期のサーバーセットアップについては、FiveM サーバーセットアップガイドを参照してください。

TXAdmin が読み込まれない、またはアクセスできない

• サーバーが GPanel で稼働していることを確認してください — TXAdmin は FiveM サーバープロセスがアクティブな場合にのみ起動します。
• GPanel のコンソールで TXAdmin の URL とポートを確認してください。TXAdmin のポートはゲームポートとは異なります。
• https:// ではなく http:// を使用していることを確認してください — TXAdmin はデフォルトでは SSL を使用しません。
• TXAdmin が以前は動作していたのに読み込まれなくなった場合は、GPanel からサーバーを再起動してみてください。
• ブラウザのキャッシュをクリアするか、シークレット/プライベートウィンドウを試してください。

CFX ライセンスキーのエラー

データベース接続のエラー

データベースの追加トラブルシューティング手順:

• oxmysql を使用している場合は、resources/ フォルダに oxmysql リソースがあること、そしてデータベースを必要とするリソースよりも前に server.cfg に ensure oxmysql が記載されていることを確認してください。
• パスワードに @、#、% などの特殊文字が含まれている場合は、接続文字列で URL エンコードしてください（例: @ は %40 になります）。
• 接続文字列に文字の欠落や余分な文字がないかテストしてください — 1 文字でも位置がずれていると失敗します。

起動時のサーバークラッシュ

• GPanel のコンソールでエラーメッセージを確認してください。よくある原因として、server.cfg の欠落や設定ミス、無効な CFX ライセンスキー、壊れたリソースなどがあります。
• server.cfg でカスタムリソースをコメントアウト（各 ensure 行の前に # を追加）して無効にし、再起動してみてください。1 つずつ追加し直して、問題のあるリソースを特定してください。
• endpoint_add_tcp と endpoint_add_udp のポートが GPanel で割り当てられたポートと一致していることを確認してください。

# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource

# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat

プレイヤーが接続できない

• サーバーが GPanel で Running と表示されていることを確認してください。
• IP とポートを確認してください — プレイヤーは TXAdmin ポートではなくゲームポートを使用する必要があります。
• sv_maxclients が 0 や不合理に低い数値に設定されていないことを確認してください。
• サーバーパスワード（server.cfg の sv_password）を使用している場合は、プレイヤーがそれを知っていることを確認してください。
• プレイヤーは FiveM クライアントをインストールしている必要があります — 通常の GTA V ランチャーでは接続できません。
• GPanel の Network タブを確認し、endpoint_add_tcp と endpoint_add_udp のポートが一致していることを確認してください。不一致があると接続できません。

リソースが読み込まれない

• リソースフォルダが resources/ ディレクトリ（または適切なサブフォルダ）内にあることを確認してください。
• フォルダ名が server.cfg の ensure 行と正確に一致していることを確認してください（大文字と小文字が区別されます）。
• 各リソースには有効な fxmanifest.lua（または古い __resource.lua）が含まれている必要があります。このファイルがない場合、リソースは読み込まれません。
• リソースに関連するエラーメッセージがないか、TXAdmin または GPanel のコンソールを確認してください。よくあるエラーには、依存関係の欠落や Lua の構文エラーがあります。
• リソースがフレームワーク（ESX、QBCore）を必要とする場合は、server.cfg でリソースより前にフレームワークが読み込まれていることを確認してください。
• リソースがデータベースを必要とする場合は、MySQL リソース（oxmysql、mysql-async）が読み込まれていて、データベース接続が機能していることを確認してください。

サーバーのパフォーマンスの問題

• TXAdmin を開き、Dashboard でパフォーマンス指標（ティックタイム、プレイヤー数、メモリ使用量）を確認してください。
• 正常な FiveM サーバーは、サーバーのティックタイム（「hitch」とも呼ばれる）を 20ms 未満に維持する必要があります。これを超える一貫したスパイクは、リソースが処理時間を使いすぎていることを示します。
• TXAdmin の Resources ページを使用して、どのリソースが最も多くのサーバー時間を消費しているかを特定してください。
• 最適化が不十分なリソースを削除または置き換えてください。出所不明の無料リソースがパフォーマンス問題の原因であることがよくあります。
• サーバープランのメモリや CPU の上限に達している場合は、読み込まれているリソースの数を減らしてください。

サポートを受ける

上記の解決策を試しても問題が解決しない場合:

1. GPanel のコンソールまたは TXAdmin ログから完全なエラーメッセージをコピーしてください。
2. すでに試したトラブルシューティング手順をメモしてください。
3. この情報を添えて https://legionhosting.net/submitticket.php でサポートチケットを開いてください。当社のチームができるだけ早くお手伝いします。

関連記事

• FiveM サーバーセットアップガイド
• FiveM リソース、スクリプト、データベースのセットアップ
• サーバーの IP とポートの確認方法
• サーバー起動ガイド