Demo ao vivo
Experimente o Agency Phone no navegador — sem download.
Porquê construir mais outro telemóvel para FiveM?
Construímos o Agency-Phone porque todos os telemóveis que experimentámos nos nossos próprios servidores ou pareciam ótimos e tinham um desempenho mau, ou tinham bom desempenho e pareciam datados. O mercado estava cheio de compromissos. Queríamos algo que realmente se sentisse como um smartphone moderno no momento em que o abres, e que ainda assim atingisse 0,00ms de uso de recursos em inatividade quando estivesse no bolso de alguém.
Uma UI que não parece FiveM
A maior parte dos telemóveis de FiveM denunciam a sua origem dois segundos depois de serem abertos. As fontes parecem ligeiramente estranhas, as animações são bruscas, o layout do ecrã principal parece um placeholder. O Agency-Phone foi desenhado por pessoas que usam smartphones reais todos os dias. Cada elemento — do relógio do ecrã de bloqueio à física de mola da gaveta de apps — foi iterado até deixar de parecer um script e começar a parecer um telemóvel.
A arquitetura das apps
Por baixo do capô, o Agency-Phone usa um sistema de apps com lazy-loading. As apps só inicializam a sua UI quando são efetivamente abertas, o que mantém o uso de memória estável mesmo à medida que vamos lançando mais apps. O event bus entre o Lua do cliente e a camada NUI está debounced para que ações rápidas do utilizador não inundem o jogo com picos de resmon. É o tipo de trabalho de engenharia que ninguém vê mas de que toda a gente beneficia quando o seu servidor está a aguentar 128 jogadores.
Framework-agnóstico por defeito
O Agency-Phone vem com adaptadores para QBCore e ESX, mas o núcleo é independente do framework. Se corres um servidor standalone com a tua própria camada de dados de jogador, podes ligá-lo numa tarde implementando quatro funções de lookup. Recusamo-nos a lançar scripts que te prendam a um único framework porque os frameworks vão mudando — já vimos passar pelo menos três vagas de "este é agora o standard" durante o nosso tempo na comunidade.
O propósito de um telemóvel em RP
Um telemóvel de FiveM é, no fundo, uma ferramenta social. Os jogadores usam-no para coordenar encontros, tratar de negócios de droga, enviar mensagem ao personagem do chefe, ouvir música na app de rádio. Tudo o que acrescentamos ou retiramos do Agency-Phone é julgado perante a pergunta: isto torna a interação social mais fácil ou mais divertida? É por isso que lançámos uma app de galeria antes de lembretes de calendário, e porque é que a app de mensagens de base tem indicadores de escrita ricos antes de ter envios agendados. RP primeiro, checklists de funcionalidades depois.
Instalação e Configuração
Agency Phone requer oxmysql e é compatível com todas as versões modernas do ESX e QBCore. A instalação inclui executar o script SQL, adicionar o recurso ao server.cfg e configurar as integrações opcionais de framework que você deseja habilitar.
Opções de Configuração
- Integrações habilitadas — quais sistemas do framework usar (banco, identidade, trabalhos)
- Configuração de aplicativos — quais aplicativos estão disponíveis para os jogadores
- Configuração da loja de aplicativos — se os jogadores podem instalar aplicativos opcionais ou se estão pré-instalados
- Configuração do servidor — nome do servidor e marca que aparece no telefone
Compatibilidade com Frameworks
Agency Phone suporta ESX e QBCore para todos os dados do personagem do jogador. Também suporta ox_lib para elementos de UI aprimorados. Em modo standalone, as funções básicas do telefone (chamadas, mensagens) funcionam sem framework, mas as integrações de banco e trabalho requerem configuração manual.
Arquitetura Técnica do Agency Phone
Por baixo, Agency Phone é construído sobre uma arquitetura NUI que utiliza HTML, CSS e JavaScript para a interface. Desenvolvedores familiarizados com desenvolvimento web podem personalizar e estender a interface facilmente. A interface usa React.js para uma experiência fluida e responsiva.
API para Desenvolvedores
Agency Phone expõe uma API para que os desenvolvedores possam adicionar funcionalidades. Você pode criar novos "aplicativos" que se integram à interface do telefone, enviar mensagens e notificações de outros recursos, e acessar contatos e histórico de chamadas com as permissões apropriadas. Essa extensibilidade torna Agency Phone uma plataforma, não apenas um aplicativo.
Compatibilidade e Atualizações
Agency Phone é mantido ativamente e atualizado para permanecer compatível com novas versões do FiveM e mudanças de framework. As atualizações estão disponíveis através do sistema de gerenciamento de recursos do Agency Scripts, com notas de versão detalhadas para cada mudança.
Perguntas Frequentes
- Agency Phone substitui completamente o telefone nativo do GTA V? Sim, Agency Phone desativa a funcionalidade do telefone nativo do GTA V e o substitui completamente.
- Os jogadores podem ter múltiplos números de telefone? Configurável — os jogadores podem ter um número por personagem, ou múltiplos números se o servidor permitir.
- Como as chamadas perdidas são tratadas? As chamadas perdidas aparecem no histórico de chamadas com timestamp. Se o telefone estiver desligado, as chamadas vão diretamente para o correio de voz se configurado.
Sobre o Agency Scripts
Agency Scripts é uma coleção de recursos premium do FiveM projetados para servidores de roleplay que levam a imersão a sério. Cada recurso é construído com os mesmos princípios: compatibilidade multi-framework, desempenho otimizado e configuração flexível para se adaptar a qualquer conceito de servidor.
Todos os recursos do Agency estão disponíveis através do sistema de licenças da cfx.re Keymaster. Uma vez comprado, você pode implantar o recurso em qualquer servidor que possua, com suporte ativo disponível através do Discord do Agency Scripts.
Suporte e Comunidade
A comunidade do Agency Scripts inclui milhares de servidores FiveM que usam esses recursos. O Discord oficial é onde os desenvolvedores compartilham suas configurações, fazem perguntas e sugerem novos recursos. As atualizações são regulares e incluem tanto correções de bugs quanto novos recursos baseados no feedback da comunidade.
Para dúvidas de instalação, problemas de compatibilidade ou solicitações de recursos, o Discord é o melhor canal. A documentação é mantida atualizada e cobre todas as configurações com exemplos práticos.
Requisitos do Sistema
Para usar os recursos do Agency Scripts, seu servidor FiveM precisa atender aos seguintes requisitos mínimos:
- Versão do servidor FiveM — artifact 4752 ou superior recomendado
- Framework — ESX 1.2+, QBCore (qualquer versão principal) ou configuração standalone
- Banco de dados — MariaDB ou MySQL 5.7+ com oxmysql como camada de banco de dados
- ox_lib — recomendado para elementos de UI aprimorados, nem sempre obrigatório
Os recursos do Agency Scripts são testados nos artifacts de servidor mais recentes e atualizados regularmente para acompanhar as mudanças do FiveM. As licenças são por servidor mas não têm data de expiração uma vez compradas através do Keymaster.