本指南介绍如何在 Legion Hosting 上设置和配置您的 Foundry Virtual Tabletop (VTT) 服务器。Foundry VTT 是一个自托管的平台，用于在线进行桌面角色扮演游戏，具有丰富的地图、自动化和游戏系统支持。有关管理员功能和模组管理，请参阅我们的 Foundry VTT 管理员与模组指南。
什么是 Foundry VTT？
Foundry Virtual Tabletop 是一款高级自托管应用程序，用于在线进行桌面 RPG 游戏。与基于浏览器的替代方案不同，Foundry VTT 作为专用服务器运行，玩家通过网页浏览器连接，为 Game Master 和玩家提供丰富的功能。
主要功能包括：
- 游戏系统支持 — 通过社区构建的游戏系统包，支持 D&D 5e、Pathfinder 2e、Call of Cthulhu 以及数百种其他系统
- 动态光照 — 实时光照和视野系统，带有视线计算功能，提供沉浸式地下城探索体验
- 音频/视频 — 内置音频播放列表和可选的音视频聊天集成
- 模组生态系统 — 数千个社区模组，用于自动化、UI 增强和内容扩展
- 基于网页的玩家端 — 玩家通过任何现代网页浏览器连接，无需安装任何软件
前提条件
Foundry VTT 需要有效的许可证密钥才能运行。您必须在设置服务器之前从 Foundry VTT 官方网站购买许可证。
需要许可证： 在初始设置期间您需要 Foundry VTT 许可证密钥。请在首次启动前准备好。您的许可证可以在 Foundry VTT 账户控制面板中找到。
首次启动
当您的 Foundry VTT 服务器在 Legion Hosting 上配置完成后：
- 在 gpanel.legionhosting.net 登录 GPanel
- 从服务器列表中选择您的 Foundry VTT 服务器
- 查看 Startup Variables——如果提供了相应变量，请输入您的 Foundry VTT 许可证密钥
- 点击 Start 启动服务器
- 服务器将启动并提供设置向导的 URL
- 打开网页浏览器并导航到
http://YOUR_IP:PORT访问 Foundry VTT 设置界面 - 在提示时输入您的许可证密钥和管理员密码
默认端口： Foundry VTT 默认使用端口 30000。您服务器分配的端口显示在 GPanel 的服务器主页面上。除非您拥有私有 IP，否则您的服务器将被分配一个随机端口。
GPanel 启动变量
GPanel 可能提供用于基本 Foundry VTT 配置的启动变量：
| 变量 | 描述 | 示例 |
|---|---|---|
TIMED_URL |
来自您 foundryvtt.com 个人资料的限时下载 URL。下载 Foundry VTT 文件时必需。链接约 5 分钟后过期。 | https://foundryvtt.s3.amazonaws.com/... |
FOUNDRY_LANGUAGE |
Foundry VTT 的界面语言 | en.core |
UPDATE_CHANNEL |
更新频道：release、testing 或 development |
release |
配置 (options.json)
Foundry VTT 的主要配置存储在 data/Config/options.json 中。您可以通过 GPanel 的 File Manager 编辑此文件：
{
"port": 30000,
"upnp": false,
"fullscreen": false,
"hostname": null,
"localHostname": null,
"routePrefix": null,
"sslCert": null,
"sslKey": null,
"awsConfig": null,
"dataPath": "/home/container/data",
"compressStatic": true,
"proxySSL": false,
"proxyPort": null,
"minifyStaticFiles": true,
"updateChannel": "stable",
"language": "en.core",
"world": null
}配置设置
| 设置 | 描述 |
|---|---|
port |
Foundry VTT 监听的端口。通常由 GPanel 管理。 |
dataPath |
包含世界、系统和模组的用户数据目录路径。 |
world |
设置为世界名称可在服务器启动时自动启动该世界。设置为 null 则显示设置界面。 |
upnp |
UPnP 端口转发。在托管服务器上保持 false。 |
compressStatic |
为静态文件启用 gzip 压缩。建议设置为 true 以获得更好的性能。 |
updateChannel |
更新频道：stable、testing 或 development。 |
自动启动世界： 将
world 选项设置为世界名称（例如 "my-campaign"）将跳过设置界面直接进入该世界。这很方便，但意味着您需要通过 /setup URL 路径访问设置界面来管理世界。
创建您的第一个世界
完成初始设置后：
- 在浏览器中访问
http://YOUR_IP:PORT打开 Foundry VTT - 输入管理员密码进入设置界面
- 转到 Game Systems 选项卡并安装一个游戏系统（例如 D&D 5e、Pathfinder 2e）
- 转到 Game Worlds 选项卡并点击 Create World
- 设置世界名称、选择已安装的游戏系统并配置初始设置
- 点击 Launch World 开始游戏
玩家如何连接
玩家通过标准网页浏览器连接到 Foundry VTT——无需安装任何软件。
- 将您的服务器 URL 分享给玩家：
http://YOUR_IP:PORT - 玩家在任何现代浏览器（Chrome、Firefox、Edge）中打开链接
- 在登录界面，玩家选择分配给他们的玩家名称并输入密码（如果已设置）
- Game Master（您）必须在玩家连接之前先启动一个世界
查找您的服务器 IP： 您服务器的 IP 和端口显示在 GPanel 的主页面上。详情请参阅我们的 如何查找您的服务器 IP 和端口 指南。
数据和备份
Foundry VTT 将所有数据存储在 data/ 目录中：
data/worlds/— 您的游戏世界（地图、日志、角色、物品）data/systems/— 已安装的游戏系统包data/modules/— 已安装的附加模组
定期备份： 在进行重大更改、更新 Foundry VTT 或修改世界之前，使用 GPanel 的备份功能或通过 SFTP 下载您的
data/ 目录。
相关文章
需要帮助？
如果您需要 Foundry VTT 服务器方面的帮助，提交支持工单，并附上您的服务器 ID 和问题描述。
