Handset (beta)

O Handset é o telefone dentro do jogo para servidores FiveM, feito pela CursedTech. É gratuito com o CAdmin e, por enquanto, está em beta.

O que ele faz:

• contatos e um número de telefone para cada personagem;
• mensagens um a um, incluindo localizações compartilhadas;
• chamadas por meio do pma-voice;
• uma câmera e uma galeria;
• um app de staff do CAdmin com os alertas atribuídos a você.

O telefone está em inglês, espanhol e português do Brasil.

O seu servidor de jogo continua no comando de tudo: os números de telefone, as mensagens, as chamadas e as fotos ficam no seu servidor e no seu banco de dados, não na CursedTech.

Beta. O Handset funciona, mas é novo. Teste em um servidor de testes antes de ativá-lo para os seus jogadores e conte para nós o que encontrar (veja "Como obter ajuda" abaixo).

O que você precisa

• CAdmin conectado à sua network, com o instalador da CursedTech (versão 0.3.0 ou posterior). Veja Primeiros passos.

• Para o modo in-place, FXServer build 35245 ou posterior. Em um build anterior, o instalador apenas prepara as versões para você copiar manualmente.

• oxmysql com MariaDB ou MySQL.

• pma-voice 7.x, para as chamadas. Sem ele, o telefone funciona e as chamadas aparecem como indisponíveis.

• Opcional, para a câmera:

  • screenshot-basic. Você mesmo o instala; o instalador não faz isso.
  • O endereço público https:// do seu servidor de jogo, para as fotos (handset_photo_origin, abaixo).

  Sem os dois, a câmera e a galeria ficam desativadas e todo o resto funciona.

Instalação

O Handset é instalado e atualizado pelo instalador da CursedTech, do mesmo modo que o CAdmin. Você não copia arquivos manualmente.

Disponível com o instalador 0.3.0. A entrega do Handset precisa do instalador da CursedTech 0.3.0 ou posterior, que está sendo publicado agora. Até o seu instalador mostrar 0.3.0, estes passos ainda não se aplicam.

1. Ative o Handset para o servidor no dashboard

Primeiro o dashboard mostra o que encontrou no servidor:

• qualquer outro telefone;
• se o screenshot-basic está presente;
• se o pma-voice está em execução.

Confirme ali.

2. Permita a instalação no server.cfg

O instalador só instala o Handset quando o seu próprio server.cfg permite. O dashboard pode pedir, mas não consegue instalar nada sozinho:

set handset_install 1

set handset_install 0, ou nenhuma linha, significa que o instalador nunca baixa nem toca no Handset.

3. Modo in-place: crie a pasta uma vez

A maioria dos servidores usa o modo in-place do instalador. O FXServer não deixa o instalador criar a pasta de um resource, então você a cria uma vez, manualmente (com o gerenciador de arquivos do txAdmin, ou no disco).

Crie a pasta:

resources/[cursedtech]/cursedtech_handset/

Adicione um arquivo provisório. A pasta deve conter um arquivo chamado fxmanifest.lua quando o servidor iniciar, com exatamente este conteúdo:

fx_version 'cerulean'
game 'gta5'
version '0.0.0'

A versão 0.0.0 o marca como provisório, e o instalador o substitui pela versão assinada.

Adicione a linha de permissão. No bloco da CursedTech do server.cfg, antes de ensure cursedtech, adicione a linha do Handset ao lado da do CAdmin:

add_filesystem_permission cursedtech write cadmin
add_filesystem_permission cursedtech write cursedtech_handset
add_ace resource.cursedtech command.refresh allow
add_ace resource.cursedtech command.ensure allow
add_ace resource.cursedtech command.stop allow
add_ace resource.cursedtech command.start allow
set cursedtech_mode "inplace"
set handset_install 1
ensure cursedtech

Não adicione ensure cadmin nem ensure cursedtech_handset: o instalador inicia o que instala. Garanta que oxmysql e pma-voice sejam iniciados no server.cfg antes de ensure cursedtech.

Reinicie o servidor. Então o instalador verifica a versão assinada do Handset e a instala. Para atualizá-lo manualmente depois, execute cursedtech update cursedtech_handset no console do servidor.

4. Ative o telefone

set handset_enabled 1

Qualquer outro valor, ou nenhuma linha, mantém o telefone totalmente desligado.

5. Inicie o servidor

Na primeira inicialização, o Handset cria as suas tabelas no banco de dados, todas com o nome handset_.... Ele nunca altera, apaga nem reescreve outras tabelas. Se já existir uma tabela handset_ com um layout diferente, o app afetado fica desativado e o console do servidor explica o motivo.

As atualizações chegam do mesmo modo e nunca voltam para uma versão anterior. Suas fotos e configurações são mantidas, e os jogadores mantêm as próprias teclas atribuídas.

Teclas

Os jogadores abrem e fecham o telefone com F1. É a única tecla que o Handset usa enquanto o telefone está fechado.

Enquanto o telefone está aberto:

• os jogadores se movem por ele com as setas ou o teclado numérico;
• Enter seleciona e Backspace volta;
• Home vai para a tela inicial;
• andar e dirigir continuam funcionando.

Atender e desligar, o obturador da câmera e o cursor do mouse funcionam dentro do telefone. Os jogadores que quiserem uma tecla para alguma dessas ações a atribuem por conta própria nas configurações do jogo, nas teclas do FiveM. Todas as teclas aparecem no telefone, em Ajustes > Atalhos.

Junto com outro telefone

Se o seu servidor já usa outro telefone (por exemplo lb-phone, qb-phone, npwd ou gksphone), o Handset nunca mexe nele. Você escolhe o que acontece com handset_coexist:

Valor	O que acontece
unbound (padrão)	O Handset funciona junto com o outro telefone. A tecla de abrir não tem padrão; os jogadores atribuem a sua
ignore	O Handset funciona normalmente, com as teclas padrão. Use quando você estiver migrando só para o Handset
off	O Handset fica desligado enquanto o outro telefone estiver funcionando, e liga sozinho quando ele não estiver mais presente

O Handset não registra nenhum item de telefone nem o comando /phone. Para ficar só com o Handset, pare ou remova você mesmo o outro telefone.

Configuração

Configuração	Padrão	O que faz
handset_enabled	0	1 ativa o telefone
handset_install	não definido	1 permite que o instalador instale e atualize o Handset
handset_coexist	unbound	comportamento junto com outro telefone (veja acima)
handset_photo_origin	não definido	o endereço público do seu servidor de jogo, apenas como https://host (sem porta, caminho ou credenciais), de onde o telefone carrega as fotos. Sem ele, a câmera e a galeria ficam desativadas
handset_photo_bytes_max	2 GB	armazenamento total de fotos neste servidor. No limite, as fotos novas são recusadas; nada é apagado
handset_number_format	###-####	padrão do número de telefone, em que # é um dígito
handset_call_channel_base	4000	primeiro canal de chamada do pma-voice que o Handset usa. Mantenha essa faixa livre
handset_key_toggle	F1	tecla padrão para abrir e fechar. Vazio significa sem atribuição; os jogadores sempre podem reatribuí-la

Escolha o formato do número antes de o seu primeiro jogador abrir o telefone. Os números já entregues nunca são reescritos, e um número que deixa de seguir o padrão não pode mais ser digitado.

Limites nesta versão:

• 200 contatos e 200 fotos por personagem, com 600 KB por foto;
• mensagens de até 500 caracteres;
• 20 mensagens e 6 chamadas realizadas por minuto por personagem;
• as chamadas tocam por 30 segundos.

O que os jogadores devem saber

Você pode mostrar este texto aos seus jogadores, ou adaptá-lo:

Os contatos, as mensagens, o histórico de chamadas e as fotos do seu telefone ficam armazenados neste servidor de jogo. A staff não lê o conteúdo do telefone. Você pode apagar as suas próprias fotos na Galeria.

A staff não vê mensagens, listas de chamadas, contatos nem fotos no CAdmin. Esta versão não tem um botão para denunciar mensagens ou fotos.

Fora desta versão

• mensagens em grupo;
• fotos nas mensagens;
• um app de mapas;
• denunciar uma mensagem ou foto;
• modo streamer;
• hospedagem de fotos pela CursedTech;
• vincular um telefone real;
• o app de despacho.

Uma localização compartilhada aparece como "Localização compartilhada", sem nome de rua.

Limites conhecidos deste beta

• Câmera e galeria: precisam do seu próprio screenshot-basic e de handset_photo_origin. Ainda não foram testadas em um servidor ao vivo com um endereço https real.
• Salvamento de foto interrompido: se o servidor parar enquanto uma foto está sendo salva, a galeria pode mostrar um item sem a imagem. Exclua esse item na Galeria.
• Frameworks: no jogo, o Handset foi testado com ESX. QBCore, Qbox e CLRPV2 são compatíveis e testados automaticamente, mas ainda não foram jogados.
• Desempenho: o desempenho no cliente ainda não foi medido em um cliente real do jogo. Os testes de carga no servidor passam.
• Instalador: as atualizações in-place em servidores Windows ainda não foram testadas. Atualizações grandes levam cerca de um minuto.
• Chamadas e mensagens entre jogadores: testadas com jogadores de teste automáticos, ainda não entre dois clientes reais do jogo.
• Outros apps: nenhum app de terceiros é aprovado por padrão, e a aprovação vale para o servidor inteiro.
• Verificação da tela do telefone: a verificação mais rígida da origem das mensagens da tela do telefone está sendo implantada. Nesta versão, ela apenas registra.

Como obter ajuda

Execute a verificação do próprio telefone. No app Telefone, disque *#0*#. O Handset executa os seus diagnósticos (tela, teclas, ida e volta com o servidor, armazenamento, notificações, mensagens, chamadas e relógio) e mostra um resumo. Disque *#06# para ver a versão e o id do dispositivo do telefone.

Fale com o suporte. Use o seu canal habitual de suporte do CAdmin e inclua:

• a versão do Handset (de *#06#);
• o resumo dos diagnósticos;
• o que você fez;
• qualquer linha do console F8 ou do console do servidor.

Nunca envie chaves de licença, tokens ou senhas.