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

开始使用 Agency Phone

Agency Phone is a premium phone script designed for FiveM roleplay servers running QBCore, ESX, or standalone frameworks. This guide walks you through the complete installation process, from downloading the resource to configuring it for your specific server setup. Whether you are an experienced developer or setting up your first server, these steps will get Agency Phone running smoothly.

先决条件

开始安装前，请确保您的服务器满足以下要求。您需要运行一个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社区，团队和其他服务器所有者将协助您。