Primeiros passos com o telefone da agência
Agency Phone é um script de telefone premium projetado para servidores de roleplay FiveM executando QBCore, ESX ou estruturas independentes. Este guia orienta você durante todo o processo de instalação, desde o download do recurso até a configuração para a configuração específica do seu servidor. Quer você seja um desenvolvedor experiente ou esteja configurando seu primeiro servidor, estas etapas farão com que o Agency Phone funcione perfeitamente.
Pré-requisitos
Antes de iniciar a instalação, certifique-se de que seu servidor atenda aos seguintes requisitos. Você precisa de um servidor FiveM em execução com QBCore, ESX ou uma estrutura personalizada. Seu servidor deve estar executando os artefatos FiveM recomendados mais recentes e você precisa de acesso aos arquivos do servidor via FTP ou gerenciamento direto de arquivos. Além disso, certifique-se de ter uma licença válida da loja Agency Scripts Tebex.
Etapa 1: baixar e extrair
Depois de comprar o Agency Phone na loja Tebex, baixe os arquivos de recursos da sua conta Keymaster. Extraia o arquivo e coloque a pasta agency-phone no diretório de recursos do servidor. A estrutura da pasta deve ser semelhante a resources/[phone]/agency-phone/, embora você possa colocá-la em qualquer subpasta de sua preferência.
Etapa 2: Configure sua estrutura
Abra o arquivo config.lua dentro da pasta agency-phone. Defina sua estrutura alterando o valor Config.Framework para "qbcore", "esx" ou "standalone". O Agency Phone detecta automaticamente a maioria das configurações da estrutura, mas você pode personalizar estilos de notificação, aplicativos padrão e formatos de número de telefone para corresponder ao tema do seu servidor.
Etapa 3: Configuração e inicialização do banco de dados
Importe o arquivo SQL fornecido para seu banco de dados para criar as tabelas necessárias para contatos, mensagens e registros de chamadas. Em seguida, adicione ensure agency-phone ao seu arquivo server.cfg. Reinicie seu servidor e teste o telefone pressionando a tecla configurada (o padrão é F1). O telefone deve abrir com uma animação suave e exibir a tela inicial com todos os aplicativos padrão prontos para uso.
Solução de problemas comuns
Se o telefone não abrir, verifique se o recurso foi iniciado verificando se há mensagens de erro no console do servidor. O problema mais comum é a falta de dependência ou configuração incorreta da estrutura. Verifique se os nomes de exportação da sua estrutura correspondem ao que o Agency Phone espera. Se você encontrar erros no banco de dados, certifique-se de que a importação do SQL foi concluída sem problemas e que o usuário do banco de dados tenha as permissões adequadas. Para obter ajuda adicional, junte-se à comunidade Agency Scripts Discord, onde a equipe e outros proprietários de servidores podem ajudá-lo.