Cómo instalar Agency Phone en tu servidor de FiveM

Cómo empezar con Agency Phone

Agency Phone es un script de teléfono premium diseñado para servidores de roleplay de FiveM que usan QBCore, ESX o frameworks standalone. Esta guía te explica todo el proceso de instalación, desde la descarga del recurso hasta su configuración para tu servidor. Tanto si eres un desarrollador con experiencia como si estás configurando tu primer servidor, estos pasos te permitirán poner Agency Phone en marcha sin problemas.

Requisitos previos

Antes de empezar la instalación, asegúrate de que tu servidor cumpla los siguientes requisitos. Necesitas un servidor de FiveM en funcionamiento con QBCore, ESX o un framework personalizado. Tu servidor debe ejecutar los artifacts recomendados más recientes de FiveM y debes tener acceso a los archivos del servidor mediante FTP o administración directa de archivos. Además, asegúrate de tener una licencia válida de la tienda Tebex de Agency Scripts.

Paso 1: Descargar y extraer

Después de comprar Agency Phone en la tienda Tebex, descarga los archivos del recurso desde tu cuenta de Keymaster. Extrae el archivo comprimido y coloca la carpeta agency-phone en el directorio de recursos de tu servidor. La estructura de carpetas debería verse así resources/[phone]/agency-phone/ aunque puedes colocarla en cualquier subcarpeta que prefieras.

Paso 2: Configurar tu framework

Abre el archivo config.lua dentro de la carpeta agency-phone. Configura tu framework cambiando el Config.Framework valor para cualquiera de las dos opciones "qbcore", "esx", o "standalone". Agency Phone detecta automáticamente la mayoría de los ajustes del framework, pero quizá quieras personalizar los estilos de notificación, las aplicaciones predeterminadas y los formatos de números de teléfono para que combinen con el tema de tu servidor.

Paso 3: Configurar la base de datos e iniciar

Importa el archivo SQL proporcionado en tu base de datos para crear las tablas necesarias para los contactos, los mensajes y los registros de llamadas. Luego, añade ensure agency-phone a tu server.cfg al archivo. Reinicia el servidor y prueba el teléfono pulsando la tecla configurada (por defecto es F1). El teléfono debería abrirse con una animación fluida y mostrar la pantalla de inicio con todas las aplicaciones predeterminadas listas para usar.

Solución de problemas comunes

Si el teléfono no se abre, comprueba que el recurso esté iniciado revisando si hay mensajes de error en la consola del servidor. El problema más habitual es que falte una dependencia o que la configuración del framework sea incorrecta. Comprueba que los nombres de exportación de tu framework coincidan con los que espera Agency Phone. Si encuentras errores de base de datos, asegúrate de que la importación de SQL se haya completado sin problemas y de que el usuario de la base de datos tenga los permisos necesarios. Si necesitas más ayuda, únete a la comunidad de Agency Scripts en Discord, donde el equipo y otros propietarios de servidores podrán ayudarte.