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.
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:
ensure phone
add_ace group.admin phone.admin allowReinicie 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:
- Renomeie a sua pasta
screenshot-basicatual (por exemplo parascreenshot-basic.bak) e tire-a deresources, para poder colocar de volta. - Copie a nossa para
resourcescom o mesmo nome,screenshot-basic, e mantenha a mesma linhaensure screenshot-basic. - 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.
- Se algo se comportar diferente, apague a nossa cópia, coloque a sua pasta antiga de volta como
screenshot-basice 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"eset 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.