Documentação do Pulse Phone

Pulse Phone — Guia rápido

Instale um único resource chamado phone. Mantenha o seu framework e os scripts suportados que você já usa; o Pulse os detecta quando inicia.

Para o Pulse Phone 1.4.24 min de leituraAtualizado em

O PhoneHub + Pulse é uma edição separada, com licença própria e sua própria cópia deste celular. Se você comprou essa edição, siga o guia de instalação dela: um servidor roda um resource de celular.

1. Verifique o seu servidor

O quê Necessário?
OneSync ativado, game build 2699 ou mais recente Obrigatório
Um banco de dados: oxmysql (ou mysql-async, ghmattimysql) em MariaDB 10.6+ ou MySQL 8 Recomendado. Sem um resource de SQL, o celular guarda os dados no armazenamento key/value do servidor
Um resource de voz: pma-voice, mumble-voip, SaltyChat, TokoVOIP ou YACA Recomendado. Sem ele, as chamadas conectam, mas sem áudio
screenshot-basic Recomendado, para a câmera poder salvar fotos. O resource padrão funciona
Um framework e um inventário Opcional. Sem eles, o celular roda em standalone

Inicie seu banco de dados, framework, inventário, resource de voz e screenshot-basic antes do Pulse. Veja os requisitos e o seu framework para a ordem correta.

Faça backup do seu banco de dados antes da primeira inicialização. O Pulse cria as próprias tabelas. Se outro celular deixou tabelas com os mesmos nomes, elas são renomeadas para old_<name> (nada é apagado); os detalhes estão nos requisitos.

2. Copie a pasta phone

Baixe sua compra pela sua conta Cfx.re. Copie a pasta phone que contém o fxmanifest.lua para os resources do seu servidor. Mantenha o nome dela. A chave do seu servidor precisa pertencer à conta dona do asset.

Enviando por FTP (servidor hospedado): use o modo Binary (FileZilla: Transfer > Transfer Type > Binary), ou envie o zip e extraia no servidor. O modo Auto altera os arquivos protegidos e o celular se recusa a iniciar; os sintomas e a solução estão em Solução de problemas. A pasta que você envia precisa bater com esta tabela; a verificação de inicialização aponta qualquer arquivo ausente ou com tamanho errado.

O download do Pulse Phone 1.4.2:

Pasta ou arquivo Arquivos Tamanho
ui/ 3,932 78,3 MB
stream/ 40 30,5 MB
config/ 138 23.2 MB
d6c1e95a/ (o código bloqueado; o nome muda a cada versão) 7 5,5 MB
data/ 2 1,4 MB
bridge/ 55 0,5 MB
guides/ 13 0,2 MB
phone.sql 1 0,2 MB
fxmanifest.lua 1 6 KB
pasta phone inteira 4,204 139.7 MB

Atualizando uma instalação existente? Siga antes a Atualização para preservar as configurações e a mídia dos jogadores. Pare o resource de celular anterior antes de mudar para o Pulse.

3. Adicione os itens ao inventário

Abra Inventários e siga as instruções do inventário que você já usa. As definições e imagens fornecidas estão em config/items/. Junte as entradas ao seu inventário; não substitua o arquivo de itens inteiro dele.

O inventário padrão do ESX e o QBCore podem registrar sozinhos as definições que faltam. Outros inventários podem precisar das entradas fornecidas. Copie as imagens dos itens para onde o seu inventário espera. Standalone sem inventário não precisa de itens.

4. Inicie o Pulse

Mantenha a detecção automática em config/config.lua. A primeira seção contém framework, idioma, escolha do inventário, item do celular e teclas. As configurações opcionais estão listadas em Configuração.

Adicione isto depois das suas dependências no server.cfg:

server.cfg
ensure phone
add_ace group.admin phone.admin allow

Reinicie o servidor. O Pulse cria as tabelas do banco de dados quando a conexão SQL está disponível. Leia a verificação no console e siga as instruções de correção, se houver. Rode phone:health para repetir a verificação.

5. Abra o seu celular

Entre como administrador, abra o F8 e digite phone:setup. Confirme o framework e o inventário detectados e complete a configuração guiada. Aperte F1 ou use /phone para abrir o celular. Se as suas configurações exigirem um item, compre um celular e use a caixa dele no inventário antes.

As configurações salvas em Settings → Server têm prioridade sobre as configurações equivalentes nos arquivos. Remova ali uma configuração salva se quiser que o valor do arquivo volte a valer.

6. Opcional: o screenshot-basic mais leve

O seu download também contém uma pasta screenshot-basic. É o screenshot-basic da CitizenFX (licença MIT) com uma mudança: o original fica redesenhando a imagem do jogo na camada de captura a cada frame, mesmo quando ninguém está tirando foto, e esta cópia só desenha enquanto uma foto está sendo tirada. O nome do resource, os exports (requestScreenshot, requestScreenshotUpload, requestClientScreenshot) e os eventos não mudaram, e ele já vem compilado, então não precisa se compilar na primeira inicialização. Os arquivos alterados estão listados em screenshot-basic/ZERODEV-CHANGES.md.

O Pulse funciona com qualquer uma das cópias, então este passo é opcional. Outros scripts do seu servidor também usam o screenshot-basic, então troque primeiro num servidor de testes, se você tiver um:

  1. Renomeie a sua pasta screenshot-basic atual (por exemplo para screenshot-basic.bak) e tire-a de resources, para poder colocar de volta.
  2. Copie a nossa para resources com o mesmo nome, screenshot-basic, e mantenha a mesma linha ensure screenshot-basic.
  3. Reinicie o servidor e teste todos os scripts que tiram capturas de tela: a câmera do celular e qualquer ferramenta de report, provas ou bodycam que você use.
  4. Se algo se comportar diferente, apague a nossa cópia, coloque a sua pasta antiga de volta como screenshot-basic e reinicie.

Configure os recursos que você usa

  • Chamadas, vídeo e Live: resources de voz suportados, controles de chamada e configuração da conexão de vídeo em produção.
  • Fotos e vídeos: armazenamento integrado, FiveManage e outras opções de upload. As chaves privadas de serviço ficam na configuração do seu servidor. Em um servidor hospedado cuja porta web não é acessível, as fotos precisam do FiveManage: duas linhas no server.cfg (set phone_media_provider "fivemanage" e set phone_fivemanage_token "<token>").
  • Configuração: lojas, apps, acessórios, idiomas e recursos opcionais.
  • Solução de problemas: encontre o sintoma e siga a solução.
  • Integrações para desenvolvedores: scripts customizados e configurações avançadas de conexão.

A instalação normal não exige editar bridge/, ui/ ou stream/. Mantenha o resource completo junto, incluindo os assets de modelo e de mapa.

Traduzido do inglês. Se algo aqui divergir da página em inglês, vale a página em inglês. English