本指南涵盖了在 Legion Hosting 上运行 alt:V 服务器所需的一切内容，从首次启动和 server.toml 配置到游戏模式资源、CDN 设置、语音聊天以及玩家如何通过 alt:V 启动器连接。有关资源开发、数据库设置和管理员管理，请参阅 alt:V 管理员与资源配置。
什么是 alt:V？
alt:V 是一个免费、开源的 Grand Theft Auto V 多人游戏修改工具。它允许玩家连接到运行独特游戏模式的自定义服务器，例如角色扮演（RP）、死亡竞赛、竞速、自由漫游等。服务器运行使用 JavaScript、TypeScript 或 C# 编写的自定义资源，让服务器所有者完全控制游戏逻辑。玩家通过 alt:V 启动器连接，该启动器会修改 GTA 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，将客户端文件上传到 Web 服务器并在资源配置中设置 CDN URL，以减少游戏服务器的带宽使用。
语音聊天
alt:V 包含内置语音聊天系统，允许玩家之间进行位置感知（3D）语音通信。语音聊天在 server.toml 中启用和配置。
语音配置
[voice]
bitrate = 64000
externalSecret = ""
externalHost = ""
externalPort = 0bitrate 控制语音质量（64000 为标准值）。external* 字段配置外部语音服务器 — 留空/设为零以使用内置语音服务器，这是大多数设置推荐的方式。外部语音服务器选项仅在需要将语音处理分担到单独机器的高级配置中使用。
玩家如何连接
玩家通过 alt:V 启动器连接到 alt:V 服务器，而非直接通过 GTA V。
通过服务器浏览器
- 从 altvmp.com 下载并安装 alt:V 启动器。
- 启动 alt:V 启动器。它将检测并验证 GTA V 安装。
- 在启动器中，浏览 Server Browser。
- 按名称搜索您的服务器或使用筛选器（游戏模式、标签、玩家数量）。
- 点击您的服务器并选择 Connect。
- 如果服务器有密码，玩家将被提示输入。
- GTA V 将以 alt:V 多人模式启动并连接到您的服务器。
通过直接连接
- 在 alt:V 启动器中，选择 Direct Connect。
- 以
IP:PORT格式输入服务器的 IP 地址和端口（例如192.168.1.1:7788）。 - 点击 Connect。
要查找服务器的 IP 地址和端口，请参阅 如何查找服务器 IP 和端口。
server.toml 中 announce = true 且您有有效的公告令牌。服务器启动后可能需要一分钟才能注册。检查控制台是否有主服务器连接错误。请注意，除非您有私有 IP，否则端口是随机分配的 -- 请在 GPanel 中检查正确的值。
最大玩家数与性能
alt:V 服务器可以支持高玩家数量，但性能在很大程度上取决于您的资源和服务器方案：
- 32–128 名玩家： 大多数服务器的常见范围。简单的游戏模式在较高数量时运行流畅。
- 128–512+ 名玩家： 对于拥有高效资源的优化服务器来说是可行的。需要更多 CPU 和 RAM。
- 资源效率： 优化不佳的脚本是导致性能问题的主要原因。每帧运行大量计算操作或在内存中维护大型数据结构的服务器端脚本会成为服务器瓶颈。
- 数据库查询： 使用数据库（MySQL、MongoDB）的游戏模式应使用异步查询，以避免阻塞主线程。
相关文章
- alt:V 管理员与资源配置 — 资源开发、数据库设置、管理工具和故障排除
- 如何查找服务器 IP 和端口
- 如何通过 SFTP 上传文件
- 服务器启动指南 — 在 Legion Hosting 上启动任何游戏服务器的通用指南
需要更多帮助？
如果您遇到本指南未涵盖的问题，我们的支持团队随时为您提供帮助。请在 legionhosting.net/submitticket.php 提交工单，并附上您的服务器详细信息和问题描述。
