Detalhes de instalação

1. Instalação rápida

Antes de copiar qualquer coisa

Use um artifact de servidor que atenda aos requisitos abaixo, com OneSync ativado e game build 2699 ou mais recente. Para um servidor de roleplay normal, deixe primeiro funcionando o seu framework, inventário, oxmysql, resource de voz e screenshot-basic. O standalone também funciona sem framework; ali os itens de inventário são opcionais.

Baixe o resource pela sua conta Cfx.re depois de resgatar a compra. Use a chave do servidor que pertence à conta dona do asset. Se a Cfx.re acusar um erro de entitlement, corrija a associação entre conta e chave; mudar as configurações do celular não concede o entitlement.

Passo 1 — Coloque o resource no seu servidor

Extraia o pacote e copie a pasta do resource phone, que contém o fxmanifest.lua, para o diretório resources do seu servidor. Não a renomeie e não coloque a pasta externa do ZIP/pacote no lugar dela.

Em um servidor hospedado, envie em modo Binary ou envie o zip e extraia lá (por quê). O guia rápido (passo 2) lista a contagem e o tamanho de arquivos de cada pasta deste build, e a verificação de inicialização aponta qualquer arquivo ausente ou com tamanho errado.

Pare o seu resource de celular anterior antes de testar o Pulse, para que dois celulares não disputem a mesma tecla e o mesmo item. Faça backup dos dados dele se pretende importá-los depois.

Passo 2 — Adicione os itens ao seu inventário

Escolha o inventário que você já usa; não precisa substituí-lo.

A verificação de inicialização identifica as entradas que faltam e imprime só as definições de que você ainda precisa. Um inventário que carrega as definições de item na inicialização, como o ox_inventory, precisa das entradas acima; o Pulse não sobrescreve arquivos de outro resource.

Passo 3 — Confira a configuração principal

Abra o config/config.lua. Os padrões detectam o seu setup atual:

Config.Framework = 'auto'

Deixe inventory = 'auto' na tabela Config.Providers existente. Se você roda vários resources de inventário, defina esse valor para o inventário que pretende usar, como 'ox_inventory'. Não adicione uma segunda tabela Config.Providers ou Config.Item no fim do arquivo.

Na tabela Config.Item existente, escolha como os celulares funcionam:

Os celulares únicos seguem a bridge de inventário selecionada. Deixe Config.Item.inventory = 'auto'; essa configuração antiga serve só para instalações avançadas existentes. Config.Providers.inventory tem prioridade quando definido explicitamente.

Não mude Config.IdentityScope em um servidor existente. O padrão, 'character', mantém separados os celulares de personagens diferentes.

Opcional: celulares no inventário e serviço pago

Para exigir um item de aparelho separado para cada celular, defina required = true e unique = true dentro da tabela Config.Item existente em config/config.lua, depois de adicionar as entradas do inventário. Use um dos inventários de celulares únicos listados acima.

Para vender serviço de telefonia, defina Config.Carrier.enabled = true no mesmo arquivo. Isso ativa o app Carrier, onde os jogadores compram o plano. Celulares novos precisam de um plano antes de chamadas normais, mensagens e apps de dados móveis ficarem disponíveis. O App Hub é onde os jogadores instalam apps, não a loja de serviço. Defina Config.Coverage.enabled = true se também quiser zonas de cobertura. Cobertura e planos pagos são opções separadas; deixe qualquer uma desligada se não quiser esse recurso.

Edite as configurações existentes em vez de adicionar tabelas duplicadas. Reinicie o servidor depois de salvar. Se uma configuração foi salva antes dentro do jogo, remova essa configuração em Settings → Server para o valor do arquivo valer.

Passo 4 — Inicie as dependências antes do Pulse

Mantenha a conexão com o banco de dados e as configurações de framework que você já tem. Adicione só as linhas que faltam; não inicie uma segunda cópia de nenhuma dependência.

Use esta ordem com os resources já instalados no seu servidor:

1. Resource de banco de dados e as configurações de conexão existentes.
2. Framework e as bibliotecas, resources de identidade e de personagem que ele exige.
3. Inventário, usando a configuração desse inventário para o seu framework.
4. Um resource de voz suportado e o screenshot-basic.
5. ensure phone.

Não instale ESX, QBCore ou outro inventário só para o Pulse. Escolha o seu setup atual em Seu framework para ver o exemplo de ordem de inicialização específico. O Qbox é detectado como Qbox mesmo quando outro resource usa os exports compatíveis com QBCore dele.

Para o acesso de administrador do Pulse, adicione add_ace group.admin phone.admin allow. A sua conta de administrador já precisa pertencer ao group.admin para essa permissão valer.

Passo 5 — Leia a verificação da primeira inicialização

Reinicie o servidor. O Pulse imprime um relatório de inicialização e cria as tabelas do banco de dados automaticamente quando a conexão SQL está disponível.

• FIX / FAIL: uma parte obrigatória não consegue funcionar. Siga a linha de correção antes de deixar os jogadores usarem.
• NOTE / WARN: veja qual recurso é afetado; alguns avisos descrevem recursos opcionais que você não configurou.
• Rode phone:health no console do servidor para repetir a verificação.
• Rode phone:diag para ver o framework/inventário/provedores escolhidos.
• Como admin, entre, abra o F8 e rode phone:setup para a configuração guiada existente.

As configurações salvas na configuração de admin dentro do jogo têm prioridade sobre as configurações equivalentes nos arquivos. Se uma mudança no arquivo parecer ignorada, confira Settings → Server e remova essa configuração salva antes de mudar mais arquivos.

Passo 6 — Teste como jogador

1. Carregue um personagem, aperte F1 e complete a configuração do celular. Se a exigência de item estiver ativada, compre um celular na loja ou dê ao personagem o item de celular configurado antes.
2. Se você comprou uma caixa lacrada, use a caixa no inventário para fazer o unboxing e depois termine a configuração. O aparelho chega ligado; com Config.Device.arrivesOn = false, segure End ou O antes.
3. Abra Messages, Contacts e Phone. Volte para a Home, abra o app switcher e feche cada app em sequência.
4. Tire uma foto e grave um vídeo curto. Abra os dois em Photos, feche e reabra o celular e confirme que continuam lá.
5. Reconecte e confira se o mesmo personagem continua com o mesmo celular. Teste chamadas com um segundo jogador usando o resource de voz instalado.

Onde mudar as coisas

As seções abaixo contêm a referência detalhada. Você não precisa ler todas as configurações de recursos para terminar a primeira instalação.