Getting Started with 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.
Prerequisites
Before you begin the installation, make sure your server meets the following requirements. You need a running FiveM server with either QBCore, ESX, or a custom framework. Your server should be running the latest recommended FiveM artifacts, and you need access to your server files via FTP or direct file management. Additionally, ensure you have a valid license from the Agency Scripts Tebex store.
Step 1: Download and Extract
After purchasing Agency Phone from the Tebex store, download the resource files from your Keymaster account. Extract the archive and place the agency-phone folder into your server resources directory. The folder structure should look like resources/[phone]/agency-phone/ though you can place it in any subfolder you prefer.
Step 2: Configure Your Framework
Open the config.lua file inside the agency-phone folder. Set your framework by changing the Config.Framework value to either "qbcore", "esx", or "standalone". Agency Phone auto-detects most framework settings, but you may want to customize notification styles, default apps, and phone number formats to match your server theme.
Step 3: Database Setup and Starting
Import the provided SQL file into your database to create the necessary tables for contacts, messages, and call logs. Then add ensure agency-phone to your server.cfg file. Restart your server and test the phone by pressing the configured key (default is F1). The phone should open with a smooth animation and display the home screen with all default apps ready to use.
Troubleshooting Common Issues
If the phone does not open, verify that the resource is started by checking the server console for any error messages. The most common issue is a missing dependency or incorrect framework configuration. Check that your framework export names match what Agency Phone expects. If you encounter database errors, make sure the SQL import completed without issues and that the database user has proper permissions. For additional help, join the Agency Scripts Discord community where the team and other server owners can assist you.