Detalhes de instalação

1. Instalação rápida

Antes de copiar o que quer que seja

Use um artifact de servidor que cumpra os requisitos abaixo, com OneSync ativo e game build 2699 ou mais recente. Num servidor de roleplay normal, tenha primeiro o framework, o inventário, o oxmysql, o resource de voz e o screenshot-basic a funcionar. O standalone também funciona sem framework; aí, os itens de inventário são opcionais.

Transfira o resource a partir da sua conta Cfx.re depois de reclamar a compra. Use a chave de servidor que pertence à conta dona do asset. Se a Cfx.re indicar um erro de direitos, corrija a associação conta/chave; mudar definições do telemóvel não dá esse direito.

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 a pasta resources do seu servidor. Não lhe mude o nome nem coloque no seu lugar a pasta exterior do ZIP/pacote.

Num servidor alojado, envie em modo Binary ou envie o zip e extraia-o lá (porquê). O guia rápido (passo 2) indica o número de ficheiros e o tamanho de cada pasta para esta build, e a verificação de arranque indica qualquer ficheiro em falta ou com o tamanho errado.

Pare o seu resource de telemóvel anterior antes de testar o Pulse, para que dois telemóveis não disputem a mesma tecla e o mesmo item. Faça uma cópia de segurança dos dados dele se pretender importá-los mais tarde.

Passo 2 — Adicione os itens ao inventário

Escolha o inventário que já tem; não precisa de o substituir.

A verificação de arranque identifica as entradas em falta e mostra só as definições de que ainda precisa. Um inventário que carrega as definições de itens no arranque, como o ox_inventory, precisa das entradas acima; o Pulse não substitui ficheiros de outro resource.

Passo 3 — Verifique a configuração principal

Abra config/config.lua. Os valores padrão detetam a sua configuração atual:

Config.Framework = 'auto'

Deixe inventory = 'auto' na tabela Config.Providers existente. Se corre 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 ficheiro.

Na tabela Config.Item existente, escolha como funcionam os telemóveis:

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

Não mude o Config.IdentityScope num servidor existente. O padrão, 'character', mantém separados os telemóveis de personagens diferentes.

Opcional: telemóveis no inventário e serviço pago

Para exigir um item de telemóvel separado para cada telemóvel, 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 para telemóveis únicos listados acima.

Para vender serviço de telemóvel, defina Config.Carrier.enabled = true no mesmo ficheiro. Isto ativa a app Carrier, onde os jogadores compram o seu plano. Os telemóveis novos precisam de um plano antes de as chamadas normais, as mensagens e as apps de dados móveis ficarem disponíveis. A App Hub é onde os jogadores instalam apps, não a loja do serviço. Defina Config.Coverage.enabled = true se também quiser zonas de cobertura. A cobertura e os planos pagos são opções separadas; deixe qualquer uma desligada se não quiser essa funcionalidade.

Edite as definições existentes em vez de adicionar tabelas duplicadas. Reinicie o servidor depois de guardar. Se uma definição em jogo tiver sido guardada antes, reponha essa definição em Settings → Server para que o valor do ficheiro se aplique.

Passo 4 — Inicie as dependências antes do Pulse

Mantenha a sua ligação à base de dados e as definições do framework atuais. Adicione só as linhas em falta; não inicie uma segunda cópia de nenhuma dependência.

Use esta ordem com os resources que já estão instalados no seu servidor:

1. O resource da base de dados e as suas definições de ligação atuais.
2. O framework e as bibliotecas, os resources de identidade e de personagens de que precisa.
3. O 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 nem um inventário diferente só para o Pulse. Escolha a sua configuração atual em O seu framework para ver o exemplo de ordem de arranque correspondente. O Qbox é detetado como Qbox mesmo quando outro resource usa os seus exports compatíveis com QBCore.

Para dar acesso de administrador ao Pulse, adicione add_ace group.admin phone.admin allow. A sua conta de administrador tem de já pertencer a group.admin para essa permissão se aplicar.

Passo 5 — Leia a verificação do primeiro arranque

Reinicie o servidor. O Pulse mostra um relatório de arranque e cria automaticamente as suas tabelas na base de dados quando a ligaçã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 usá-la.
• NOTE / WARN: veja que funcionalidade é afetada; alguns avisos descrevem funcionalidades opcionais que não configurou.
• Corra phone:health na consola do servidor para repetir a verificação.
• Corra phone:diag para ver o framework/inventário/fornecedores escolhidos.
• Como administrador, entre, abra o F8 e corra phone:setup para a configuração guiada.

As definições guardadas na configuração de administração em jogo sobrepõem-se às definições equivalentes dos ficheiros. Se uma alteração num ficheiro parecer ignorada, veja Settings → Server e reponha essa definição guardada antes de mudar mais ficheiros.

Passo 6 — Teste como jogador

1. Carregue uma personagem, carregue em F1 e conclua a configuração do telemóvel. Se os requisitos de itens estiverem ativos, compre primeiro um telemóvel na loja ou dê à personagem o item de telemóvel configurado.
2. Se comprou uma caixa selada, use a caixa a partir do inventário para a abrir e depois termine a configuração. O telemóvel chega ligado; com Config.Device.arrivesOn = false, mantenha premido End ou O primeiro.
3. Abra Messages, Contacts e Phone. Volte ao ecrã principal, abra o app switcher e feche cada app, uma a uma.
4. Tire uma foto e grave um vídeo curto. Abra os dois em Photos, feche e volte a abrir o telemóvel, e confirme que continuam lá.
5. Volte a ligar-se e verifique que a mesma personagem continua a ter o mesmo telemóvel. Teste chamadas com um segundo jogador usando o resource de voz que tem instalado.

Onde mudar as coisas

As secções abaixo contêm a referência detalhada. Não precisa de ler todas as definições de funcionalidades para concluir a primeira instalação.