FoundryVTTのソースを表示

[[Category:ゲーム]]
[[en:FoundryVTT]]
[[es:FoundryVTT]]
[https://foundryvtt.com Foundry VTT] は、機能が豊富で最新の自己ホスト型アプリケーションを使って、マルチプレイヤーのテーブルトーク RPG を体験するために作られたスタンドアロンアプリケーションです。プレイヤーはブラウザを通じて直接接続します。

'''Foundry VTT''' は [[Wikipedia:Proprietary software|プロプライエタリソフトウェア]] です。使用するには有料ライセンスを取得する必要があります。

以下の手順は、Arch Linux システムに Foundry VTT をインストールする方法の一例です。手順を終えると、[[SSL|セキュア接続]] を使用してブラウザからサービスにアクセスできるようになります。

== インストール ==

=== 必要条件 ===

Foundry VTT をインストールする前に、[[nginx]] と [[Node.js]] が動作している環境を用意してください。

=== ディレクトリ作成 ===

まず、ソフトウェアとそのデータをインストールするためのディレクトリを作成します。例として /home 配下に作成します。

 # mkdir -p /home/foundry/{foundryvtt,foundrydata}

=== システムユーザー作成 ===

Foundry VTT はシステムユーザーで実行します。まず、'''foundry''' などの名前で [[ユーザーとグループ#システムユーザーを追加する例|システムユーザーを作成]] します。

 # useradd -r -s /usr/bin/nologin ''foundry''

=== ダウンロード ===

[https://foundryvtt.com foundryvtt.com] に登録しライセンスを購入したら、プロフィールページの「Purchased Software Licenses」セクションに移動します。そこには複数のパッケージが表示されますが、Node.js 版をダウンロードする必要があります。

ダウンロードページのリンク横に小さな「チェーン」アイコンがあり、これをクリックすると一時的に有効なリンクが生成されます。このリンクは wget を使ってターミナルやシェルからダウンロードできます。

wget などのコマンドラインユーティリティでリンクをダウンロードする際は、リンクを二重引用符で囲むことが重要です。これによりリンクが正しく解釈されます。例:

 # wget -O foundryvtt.zip "<nowiki>https://your-download-link-from-foundry-vtt.com-here/</nowiki>"

ダウンロードしたファイルは、先ほど作成した ''foundryvtt'' ディレクトリに展開します。展開後、適切なパーミッションを設定します。

 # unzip foundryvtt.zip -d /home/foundry/foundryvtt
 # chown -R foundry:foundry /home/foundry/foundryvtt
 # chown -R foundry:foundry /home/foundry/foundrydata

このアーカイブは [[AUR]] の {{AUR|foundryvtt}} パッケージを使用する場合にも必要です。

== 使用方法 ==

=== プロキシなしでの実行 ===

まずソフトウェアが動作するかテストします。''foundry'' ユーザーとしてサーバーを実行します。

 [foundry]$ node /home/foundry/foundryvtt/main.js --dataPath=/home/foundry/foundrydata

実行中はブラウザでポート 30000 にアクセスしてサーバーに接続できます。この時点で管理者パスワードを設定し、ライセンスキーを保存できます。

終了する場合は {{ic|Ctrl+c}} でサーバーを停止します。

=== サービスの作成 ===

ソフトウェアを実行する方法のひとつとして [[systemd#ユニットファイル]] を使います。以下のような Foundry VTT 用のシンプルなサービスファイルを作成できます。

 [Unit]
 Description=Foundry VTT
 
 [Service]
 Type=simple
 ExecStart=node /home/foundry/foundryvtt/main.js --dataPath=/home/foundry/foundrydata
 Restart=on-failure
 User=foundry
 
 [Install]
 WantedBy=multi-user.target

[https://foundryvtt.com/article/nginx/ インストール手順] にあるように、プロキシサーバー経由でアクセスできるようにソフトウェアオプションを編集します。

''hostname'' に {{ic|a.domain.tld}} などを設定し、他の項目はそのままにして以下のように設定します。

{{hc|/home/foundry/foundrydata/Config/options.json|
"hostname": "''hostname''",
"routePrefix": null,
"sslCert": null,
"sslKey": null,
"port": 30000,
"proxyPort": 443,
"proxySSL": true
}}

=== nginx の設定 ===

Foundry VTT 用に nginx プロキシサーバーを設定するには、公式ドキュメントの以下の例を使用できます。

 # /etc/nginx/sites-available/ 内にファイルを作成します。慣例的に、
 # ファイル名は "your.domain.com" や "foundryvtt" などですが、
 # 一意で分かりやすければ何でも構いません。
 
 # Server 定義
 server {
 
     # FQDN を入力、または空白に
     server_name             your.hostname.com;
 
     # SSL 証明書を使用してポート 443 で待ち受け
     listen                  443 ssl;
     listen                  [::]:443 ssl;
     ssl_certificate         "/etc/letsencrypt/live/your.hostname.com/fullchain.pem";
     ssl_certificate_key     "/etc/letsencrypt/live/your.hostname.com/privkey.pem";
 
     # 最大アップロードサイズを 300 MB に設定
     client_max_body_size 300M;
 
     # Foundry VTT へのプロキシ設定
     location / {
 
         # プロキシヘッダーを設定
         proxy_set_header Host $host;
         proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
         proxy_set_header X-Forwarded-Proto $scheme;
 
         # WebSocket サポートのために必要
         proxy_set_header Upgrade $http_upgrade;
         proxy_set_header Connection "Upgrade";
 
         # Foundry VTT のポート番号を設定
         proxy_pass <nowiki>http://localhost:30000</nowiki>;
     }
 }
 
 # 任意だが推奨。HTTP リクエストを HTTPS にリダイレクト
 server {
     if ($host = your.hostname.com) {
         return 301 <nowiki>https://$host$request_uri</nowiki>;
     }
 
     listen 80;
     listen [::]:80;
 
     server_name your.hostname.com;
     return 404;
 }

証明書は [[certbot]] を使用して取得できます。

=== サービスの実行 ===

最後に {{ic|foundryvtt.service}} と {{ic|nginx.service}} を [[起動/有効化]]します。

これで、先ほど設定した ''hostname'' を使って [[Web ブラウザ]]からサービスにアクセスできるはずです。