如何在 FiveM 服务器上安装 Agency Phone

开始使用 Agency Phone

Agency Phone 是一款高级手机脚本，专为运行 QBCore、ESX 或 standalone 框架的 FiveM 角色扮演服务器打造。本指南将带你完成完整的安装流程，从下载资源到根据服务器配置进行设置。无论你是经验丰富的开发者，还是正在搭建首台服务器，按照这些步骤都能让 Agency Phone 顺利运行。

先决条件

开始安装前，请确保您的服务器满足以下要求。您需要运行一个FiveM服务器，使用QBCore、ESX或自定义框架。服务器应运行最新推荐的FiveM版本，并且您需要通过FTP或直接文件管理访问服务器文件。此外，确保您拥有Agency Scripts Tebex商店的有效许可证。

步骤 1：下载并解压

从Tebex商店购买Agency Phone后，请从您的Keymaster账户下载资源文件。解压缩归档并将 agency-phone 将文件夹放入服务器资源目录。文件夹结构应如下所示 resources/[phone]/agency-phone/ 尽管您可以将其放置在任何您喜欢的子文件夹中。

步骤 2：配置您的框架

打开 config.lua agency-phone文件夹内的文件。通过更改 Config.Framework value 至任一 "qbcore", "esx"，或 "standalone". Agency Phone自动检测大多数框架设置，但你可能想自定义通知样式、默认应用和电话号码格式以匹配你的服务器主题。

步骤 3：数据库设置与启动

将提供的SQL文件导入数据库，以创建联系人、消息和通话记录所需的表。然后添加 ensure agency-phone 您的 server.cfg 文件。重启服务器并通过按配置键（默认是 F1）。手机应以流畅动画打开，并显示带有所有默认应用的主屏幕，准备使用。

常见问题排查

如果手机无法打开，请通过检查服务器控制台中的错误信息确认资源是否已启动。最常见的问题是缺少依赖或框架配置错误。检查您的框架导出名称是否符合Agency Phone的要求。如果遇到数据库错误，请确保SQL导入无误且数据库用户拥有适当权限。需要额外帮助，请加入Agency Scripts Discord社区，团队和其他服务器所有者将协助您。