Solução de problemas

As poucas coisas que costumam dar errado mais de uma vez e as respostas que não são óbvias.

---

Uma alteração no recurso não surtiu efeito

restart não relê o fxmanifest.lua. Se você adicionou um arquivo novo, execute refresh primeiro:

refresh
restart mic_phone

Sem isso, o servidor continua usando a lista de arquivos que já tinha em memória, e um arquivo novo simplesmente não existe para ele. Isso é comportamento do FiveM, não do telefone, e já custou pelo menos uma hora de vida a todo mundo alguma vez.

O telefone não abre e não há nada no console

Quase sempre é o inventário, e quase sempre logo após reiniciá-lo.

Reiniciar o ox_inventory enquanto há pessoas conectadas trava o cliente delas. invBusy permanece true e qualquer busca congela para sempre, então o telefone pergunta “há um telefone neste bolso?” e nunca recebe resposta.

Reinicie o inventário uma segunda vez. A primeira reinicialização é a que quebra o cliente conectado e a segunda é a que o recupera. Ninguém precisa reconectar no servidor, e limpar a state bag manualmente não basta.

Caso contrário, verifique nesta ordem:

• O item configurado em Config.Open.Item é realmente o que o seu inventário possui?
• Config.Open.RequireItem está ativado em um servidor onde os jogadores não carregam esse item? Desativá-lo é a maneira mais rápida de descobrir se o problema é o item.
• A bateria está ativada e descarregada? Config.Battery.Dead recusa abrir o telefone abaixo do nível definido ali.

O telefone se guarda sozinho enquanto estou jogando

Isso vem de shared/config/restrict.lua, e cada regra ali tem um interruptor próprio. As duas que mais surpreendem as pessoas:

• Queda (Falling) — o jogo considera descer de uma calçada como estar caindo. Falling.Height define os metros de ar abaixo de você antes que isso conte como queda; vem configurado em 8, o que equivale a uma queda de cerca de seis metros.
• Escalada (Climbing) — o jogo considera descer de um muro como escalada. Climbing.After define os segundos antes que isso conte; vem configurado em 1.0, tempo que um pulo rápido de parkour nunca atinge, mas subir uma escada sempre atinge.

Config.Restrict.Tell.OnClose decide se o telefone exibe um aviso quando isso acontece. Vem desligado: você já está olhando para a situação que tirou o telefone da sua mão.

Ninguém ouve nada nas chamadas

O telefone não transmite a voz por conta própria; ele coloca as duas pessoas em um canal e deixa o seu recurso de voz fazer o trabalho. pma-voice, mumble-voip, SaltyChat e TokoVoip são detectados automaticamente — se nenhum deles estiver rodando, as chamadas conectam, mas ninguém ouve nada.

As fotos fazem upload, mas depois não aparecem

shared/server_config.lua decide para onde uma imagem vai. Duas coisas quebram isso silenciosamente:

• Um token do Fivemanage que não pertence a este servidor, ou um webhook do Discord que foi apagado.
• Um host que não está listado em Hosts. O servidor só aceita URLs vindas de volta dos endereços listados ali, o que impede um cliente mal-intencionado de entregar à galeria um link para qualquer lugar.

Um aplicativo sumiu da Tela de Início

Na ordem: ele está como off em Config.AppList? Está restrito a um emprego com Jobs ou NotJobs? É um aplicativo com Boss = true e a framework considera que este jogador gerencia uma empresa? Está dentro de uma pasta — arraste um ícone sobre outro e você terá criado uma.

A Biblioteca de Apps, acessível pelo botão de editar na Tela de Início, lista tudo o que existe e não está em nenhuma página.

A versão web não carrega

O telefone no navegador precisa de um certificado, e o próprio recurso busca o dele. O certificado cobre os casos que o guia rápido não aborda — o mais comum é uma porta que não está aberta no firewall ou um domínio DuckDNS que não foi atualizado desde que o seu endereço IP mudou.

Tudo está em inglês

Config.Locale é o idioma padrão da cidade, e cada jogador pode escolher o seu nos Ajustes — escolha que as notificações fora do telefone também seguem. Os idiomas incluídos têm fallback para o inglês frase por frase em vez de quebrarem, então uma tradução incompleta mostra o que tiver traduzido e exibe o restante em inglês.