このガイドでは、初回起動と server.toml の設定から、ゲームモードリソース、CDN のセットアップ、ボイスチャット、プレイヤーが alt:V ランチャーを通じて接続する方法まで、Legion Hosting で alt:V サーバーを稼働させるために必要なすべてを解説します。リソース開発、データベースのセットアップ、管理者管理については、alt:V 管理者およびリソースのセットアップをご覧ください。
alt:V とは?
alt:V は、Grand Theft Auto V 向けの無料のオープンソースマルチプレイヤー改造です。プレイヤーは、ロールプレイ（RP）、デスマッチ、レース、フリーローミングなど、独自のゲームモードを実行するカスタムサーバーに接続できます。サーバーは JavaScript、TypeScript、または C# で書かれたカスタムリソースを実行し、サーバーオーナーにゲームプレイのロジックを完全に制御させます。プレイヤーは、マルチプレイヤー接続のために GTA V を改変する alt:V ランチャーを通じて接続します。
初回起動
alt:V サーバーを初めて受け取ったら、オンラインにするために次の手順に従ってください:
- GPanel にログインし、alt:V サーバーを選択します。
- Startup タブに移動し、サーバー名、最大プレイヤー数、その他の起動変数を設定します。
- Console タブを開き、Start をクリックします。
- サーバーは初回起動時に alt:V サーバーファイルをダウンロードします。これには数分かかる場合があります。
- サーバーがリッスン状態で接続の準備が整ったことがコンソールに表示されれば、サーバーはオンラインです。
- デフォルトでは、サーバーはゲームモードリソースなしで起動します。ゲームプレイを作成するにはリソースを追加する必要があります。詳しくは alt:V 管理者およびリソースのセットアップをご覧ください。
GPanel 起動変数
alt:V は、いくつかの設定オプションを GPanel の起動変数として公開しています。これらを変更するには Startup タブに移動してください。変更にはサーバーの再起動が必要です。
| 変数 | デフォルト | 説明 |
|---|---|---|
PASSWORD |
ChangeMe |
サーバーに参加するためのパスワード。最低 6 文字。 |
SERVER_DESC |
A Pterodactyl Hosted Server |
alt:V サーバーブラウザに表示されるサーバーの説明。 |
BUILD |
release |
alt:V のサーバーブランチ: release（安定版）、rc（リリース候補）、または dev（開発版）。 |
サーバー設定（server.toml）
alt:V サーバーの主要な設定ファイルは server.toml で、サーバーのルートディレクトリにあります。このファイルは GPanel の Files タブまたは SFTP 経由で編集できます。
server.toml の例
name = "My alt:V Server"
host = "0.0.0.0"
port = 7788
players = 128
password = ""
announce = true
token = ""
gamemode = "Freeroam"
website = ""
language = "en"
description = "A custom GTA V multiplayer server"
modules = ["js-module"]
resources = ["myresource"]
tags = ["freeroam", "fun"]主な設定: name（ブラウザ表示名）、host（0.0.0.0 のままにする）、port（GPanel と一致させる必要がある）、players（最大数）、password（公開の場合は空）、announce（ブラウザに表示するには true）、token（alt:V ウェブサイトのアナウンストークン、ブラウザ掲載に必要）、gamemode（"Roleplay" のようなブラウザラベル）、modules（スクリプトモジュール: js-module または csharp-module）、resources（読み込むリソースフォルダの配列）、tags（ブラウザのフィルタータグ）。
アナウンストークン
サーバーを alt:V サーバーブラウザに表示するには、alt:V マスターサーバーからのアナウンストークンが必要です:
- alt:V ウェブサイトにアクセスし、ログインするかアカウントを作成します。
- サーバー管理セクションに移動し、新しいサーバートークンを生成します。
- トークンをコピーし、
server.tomlのtokenフィールドに貼り付けます。 - 設定で
announce = trueになっていることを確認します。 - サーバーを再起動します。公開ブラウザに表示されるはずです。
server.toml 内にのみ記載してください。
ゲームモードリソース
alt:V サーバーはリソース — すべてのゲームプレイロジックを定義するスクリプト — によって動作します。リソースがなければ、サーバーにはカスタム機能がありません。リソースは resources/ ディレクトリに配置されます。
リソースの構造
resources/
myresource/
resource.toml <-- Resource configuration
server/
index.js <-- Server-side script
client/
index.js <-- Client-side script (runs on the player's GTA V)リソースの読み込み
起動時に読み込むには、リソース名を server.toml の resources 配列に追加します:
resources = ["chat", "freeroam", "spawn"]各リソースは、その種類、依存関係、スクリプトのエントリポイントを定義する resource.toml ファイルをそのディレクトリに持つ必要があります。リソースの作成と管理の詳細については、alt:V 管理者およびリソースのセットアップをご覧ください。
CDN のセットアップ
alt:V は、クライアントサイドのファイル（モデル、テクスチャ、スクリプト）を接続するプレイヤーに配信するために CDN の仕組みを使用します。組み込みの CDN は追加設定なしでサーバーから直接ファイルを配信します — これがデフォルトであり、ほとんどのサーバーで問題なく機能します。多数のカスタムアセットを持つ大規模なサーバーでは、クライアントファイルをウェブサーバーにアップロードし、リソース設定で CDN URL を設定することで、オプションで外部 CDN を構成し、ゲームサーバーの帯域幅使用量を削減できます。
ボイスチャット
alt:V には、プレイヤー間で位置情報に基づく（3D）音声通信を可能にする組み込みのボイスチャットシステムが含まれています。ボイスチャットは server.toml で有効化および設定されます。
音声設定
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate は音声品質を制御します（64000 が標準）。external* フィールドは外部音声サーバーを設定します — 組み込みの音声サーバーを使用するには空/ゼロのままにしてください。これがほとんどの構成で推奨されます。外部音声サーバーのオプションは、音声処理を別のマシンにオフロードする高度な構成でのみ必要です。
プレイヤーの接続方法
プレイヤーは GTA V から直接ではなく、alt:V ランチャーを通じて alt:V サーバーに接続します。
サーバーブラウザ経由
- altvmp.com から alt:V ランチャーをダウンロードしてインストールします。
- alt:V ランチャーを起動します。GTA V のインストールを検出して確認します。
- ランチャーから サーバーブラウザ を閲覧します。
- 名前でサーバーを検索するか、フィルター（ゲームモード、タグ、プレイヤー数）を使用します。
- サーバーをクリックして Connect を選択します。
- サーバーにパスワードがある場合、プレイヤーは入力を求められます。
- GTA V が alt:V マルチプレイヤー mod とともに起動し、サーバーに接続します。
ダイレクト接続経由
- alt:V ランチャーで Direct Connect を選択します。
- サーバーの IP アドレスとポートを
IP:PORT形式（例:192.168.1.1:7788）で入力します。 - Connect をクリックします。
サーバーの IP アドレスとポートを見つけるには、サーバーの IP とポートの確認方法をご覧ください。
server.toml で announce = true になっていること、および有効なアナウンストークンがあることを確認してください。サーバーは起動後、登録されるまでに 1 分ほどかかる場合があります。マスターサーバー接続エラーがないかコンソールを確認してください。プライベート IP をお持ちでない限りポートはランダムに割り当てられるため、正しい値については GPanel を確認してください。
最大プレイヤー数とパフォーマンス
alt:V サーバーは多数のプレイヤーをサポートできますが、パフォーマンスはリソースとサーバープランに大きく依存します:
- 32〜128 プレイヤー: ほとんどのサーバーに共通する範囲です。シンプルなゲームモードはより多い人数でもスムーズに動作します。
- 128〜512 以上のプレイヤー: 効率的なリソースを持つ最適化されたサーバーでは可能です。より多くの CPU と RAM が必要です。
- リソースの効率: 最適化が不十分なスクリプトはパフォーマンス問題の主要な原因です。ティックごとに重い操作を実行したり、メモリ内に大きなデータ構造を維持したりするサーバーサイドスクリプトは、サーバーのボトルネックになります。
- データベースクエリ: データベース（MySQL、MongoDB）を使用するゲームモードは、メインスレッドをブロックしないように非同期クエリを使用すべきです。
関連記事
- alt:V 管理者およびリソースのセットアップ — リソース開発、データベースのセットアップ、管理者ツール、トラブルシューティング
- サーバーの IP とポートの確認方法
- SFTP でファイルをアップロードする方法
- サーバー起動ガイド — Legion Hosting であらゆるゲームサーバーを起動するための一般ガイド
さらにサポートが必要ですか?
このガイドで扱われていない問題が発生している場合は、当社のサポートチームがお手伝いします。legionhosting.net/submitticket.php でチケットを開き、サーバーの詳細と問題の説明を記載してください。
