Как установить Agency Phone на ваш сервер FiveM

Начало работы с 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: Скачайте и распакуйте

После покупки Agency Phone в магазине Tebex скачайте файлы ресурса из вашего аккаунта Keymaster. Распакуйте архив и поместите agency-phone папка в директорию ресурсов вашего сервера. Структура папок должна выглядеть как resources/[phone]/agency-phone/ хотя вы можете разместить его в любой предпочитаемой подпапке.

Шаг 2: Настройте ваш фреймворк

Открыть config.lua файл внутри папки agency-phone. Установите ваш фреймворк, изменив Config.Framework значение для либо "qbcore", "esx"", или", "standalone". Agency Phone автоматически определяет большинство настроек фреймворка, но вы можете настроить стили уведомлений, приложения по умолчанию и форматы номеров телефонов, чтобы соответствовать теме вашего сервера.

Шаг 3: Настройка базы данных и запуск

Импортируйте предоставленный SQL-файл в вашу базу данных для создания необходимых таблиц для контактов, сообщений и журналов звонков. Затем добавьте ensure agency-phone для вашего server.cfg файл. Перезапустите сервер и протестируйте телефон, нажав настроенную клавишу (по умолчанию F1 ). Телефон должен открываться с плавной анимацией и отображать главный экран со всеми стандартными приложениями, готовыми к использованию.

Устранение распространённых проблем

Если телефон не открывается, проверьте, запущен ли ресурс, просмотрев консоль сервера на наличие ошибок. Самая частая проблема , отсутствие зависимости или неправильная настройка фреймворка. Убедитесь, что имена экспортов фреймворка совпадают с ожидаемыми Agency Phone. Если возникают ошибки базы данных, убедитесь, что импорт SQL прошёл без проблем и у пользователя базы есть необходимые права. Для дополнительной помощи присоединяйтесь к Discord-сообществу Agency Scripts, где команда и другие владельцы серверов помогут вам.