GTA V: FiveM 入门

本指南将引导您在 ServerPrism 上设置 GTA V: FiveM 服务器，从订购和初始配置到让玩家连接。它适用于所有刚订购或即将订购 FiveM 服务器的用户。

开始之前

要运行 FiveM 服务器，您需要一个 CFX.re 许可证密钥。您可以访问 keymaster.fivem.net 免费生成一个。请妥善保管此密钥，因为您需要将其输入到服务器的启动配置中。

在 ServerPrism 上订购

1. 从游戏列表中选择 GTA V: FiveM。
2. 选择您的套餐：我们建议基本服务器至少选择 4 GB RAM。对于包含许多自定义脚本、车辆或玩家的服务器，请考虑 8 GB 或更多，最高可达 16 GB。您可以随时从 ServerPrism 控制面板升级您的套餐。
3. 选择离您的玩家最近的区域以获得最佳性能。
4. 部署您的服务器。

首次启动

部署后，您的服务器将自动启动。首次启动会安装必要的 FiveM 服务器文件，包括 txAdmin。此过程可能需要几分钟。您可以通过 ServerPrism 面板中的网页控制台监控进度。

当您看到消息指示 txAdmin 正在运行并监听连接时，您的服务器就准备好了，通常在端口 40120（用于 txAdmin）和 30120（用于游戏客户端）上。

连接/邀请玩家

玩家可以通过以下几种方式连接到您的 FiveM 服务器：

• 直接连接：玩家打开 GTA V，启动 FiveM，按 F8 打开控制台，然后输入 connect [YOUR_SERVER_IP]:30120。将 [YOUR_SERVER_IP] 替换为您的服务器 IP 地址，该地址可在您的 ServerPrism 面板中找到。
• 服务器列表：如果您的服务器是公开的，玩家可以在 FiveM 游戏内服务器浏览器中找到它。确保您的 sv_master1 变量设置正确（默认为 ""，表示公开）。
• 邀请链接：如果已配置，您可以从 txAdmin 或服务器的 cfx_nui_url 生成邀请链接。

为了更方便访问，您可以从 ServerPrism 控制面板为您的服务器附加一个免费子域名。

配置基础知识

大多数 FiveM 服务器配置通过 server.cfg 文件管理，该文件位于服务器目录的根目录（例如，/home/container/server-data/server.cfg）。您可以使用 ServerPrism 面板中的“文件管理器”直接编辑此文件。

您需要更改的关键设置：

• 许可证密钥：使用 sv_licenseKey "YOUR_LICENSE_KEY" 设置您的 CFX.re 许可证密钥。这对于您的服务器启动至关重要。
• 服务器名称：将 sv_hostname "My FiveM Server" 更改为您想要的服务器名称。这是玩家在服务器列表中看到的名称。
• 最大玩家数：调整 sv_maxClients 32 以设置最大玩家数。请注意您服务器的 RAM 和 CPU。
• 服务器标签：添加标签以在服务器浏览器中获得更好的可见性：sets tags "default, roleplay, custom"。
• 资源启动：要自动启动资源（脚本、地图），请使用 ensure resource_name。例如，ensure essentialmode。
• RCON 密码：设置 RCON 密码以进行远程管理：rcon_password "your_rcon_password"。

这些值中的许多，包括您的许可证密钥，也可以使用 ServerPrism 面板中的“Startup Variables”选项卡进行设置或覆盖，这简化了初始设置。

常见问题

• 服务器未显示在列表中/未启动：最常见的原因是缺少或无效的 sv_licenseKey。请仔细检查 server.cfg 或“Startup Variables”中的密钥。确保其格式正确并带有引号。
• 玩家无法连接：验证您的服务器 IP 地址和端口 (30120) 是否正确。检查网页控制台是否有任何与网络绑定或防火墙问题相关的错误消息。
• 特定资源未加载：确保资源文件夹正确放置在您的 resources 目录中，并且您在 server.cfg 中为每个要启动的资源都有一行 ensure resource_name。
• txAdmin 无法访问：默认情况下，txAdmin 在端口 40120 上运行。请确保您通过 http://[YOUR_SERVER_IP]:40120 访问它，并且服务器已完全启动。

如果您遇到持续性问题，请通过“文件管理器”或网页控制台检查服务器日志。您也可以在 serverprism.com/tickets 提交支持工单，提供您的服务器 ID 和相关的日志片段。

后续步骤

• 探索 txAdmin：您的 FiveM 服务器包含 txAdmin，这是一个功能强大的网页面板，用于管理资源、玩家和服务器设置。通过 http://[YOUR_SERVER_IP]:40120 访问它。
• 添加自定义资源：浏览 FiveM 论坛和社区，寻找自定义脚本、车辆和地图以增强您的服务器。通过 SFTP 或“文件管理器”将它们上传到您的 resources 文件夹。
• 安装框架：考虑为角色扮演服务器安装流行的框架，如 ESX 或 vRP。请遵循它们特定的安装指南。
• 监控性能：在 ServerPrism 面板中密切关注服务器的资源使用情况。如果您遇到延迟或崩溃，请考虑升级您的套餐以获取更多 RAM 或 CPU 资源。