Como Remover o Retículo em FiveM (HideHudComponentThisFrame 14)

Resposta rápida: Servidores FiveM removem o retículo padrão do GTA — componente HUD 14, o retículo — executando HideHudComponentThisFrame(14) todos os quadros em um script do cliente. A chamada deve ser executada no cliente, dentro de um loop, porque os componentes do HUD são renderizados novamente no próximo quadro. Abaixo: o recurso de copiar e colar, um comando opcional de alternância do jogador e correções para uma mira que continua voltando.

A configuração e os exemplos de código aqui são voltados ao FiveM para GTA V Legacy. O Enhanced tem regras diferentes de runtime e de compatibilidade; verifique as alterações de Legacy para Enhanced do Cfx.re antes de aplicá-las a um servidor Enhanced.

Script de cliente copiável

Crie um pequeno recurso de cliente e coloque isso em client.lua:

CreateThread(function()
 while true do
 Wait(0)
 HideHudComponentThisFrame(14)
 end
end)

A referência nativa oficial do Cfx.re lista HideHudComponentThisFrame como o nativo para ocultar componentes do HUD. O componente 14 é o retículo/mira.

fxmanifest.lua mínimo

Coloque isso ao lado de client.lua em uma pasta de recursos, por exemplo resources/[local]/no-crosshair/:

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'

Em seguida, adicione o recurso ao server.cfg:

ensure no-crosshair

Por que precisa ser executado a cada quadro

Ocultar o HUD é baseado em quadros. Chamar a função nativa uma vez pode parecer que funcionou por um momento, mas o retículo retorna porque o GTA renderiza os componentes do HUD novamente em quadros posteriores. Mantenha o loop leve e não adicione lógica complexa dentro dele.

Remoção de mira do lado do jogador vs. do lado do servidor

Meta	Melhor método
Remova a mira padrão do GTA para todos	Utilize um pequeno recurso de cliente com HideHudComponentThisFrame(14).
Deixe os jogadores escolherem	Adicione uma configuração ou comando do cliente que alterne o loop.
Remover um HUD de arma personalizado	Verifique o recurso de arma/HUD. Ele pode desenhar sua própria mira.
Impeça que monitores ou sobreposições adicionem um ponto	Verifique as sobreposições do cliente, os recursos do monitor e as modificações gráficas.

Comando de alternância opcional

Para uma alternância do jogador, substitua o primeiro exemplo de client.lua por esta versão completa. Não execute ambos os loops:

local crosshairHidden = true

RegisterCommand('crosshair', function()
 crosshairHidden = not crosshairHidden
 print(crosshairHidden and 'Crosshair hidden' or 'Crosshair visible')
end, false)

CreateThread(function()
 while true do
 Wait(0)
 if crosshairHidden then
 HideHudComponentThisFrame(14)
 end
 end
end)

Solução de problemas

• Se a mira ainda aparecer, outro recurso HUD ou de arma pode estar desenhando seu próprio elemento.
• Se o recurso não iniciar, verifique a configuração do fxmanifest.lua.
• Se apenas um jogador vir um ponto, verifique as sobreposições do monitor ou as ferramentas gráficas nesse PC.

Perguntas frequentes

Isso pode ser feito em server.lua?

Não. A renderização do HUD é do lado do cliente. Acione um evento do cliente se precisar de lógica do servidor, mas chame a função nativa no código do cliente.

Isso afeta miras personalizadas?

Isso oculta o componente de retículo padrão. Scripts de armas personalizados, miras ou sobreposições NUI ainda podem desenhar sua própria interface de usuário.

Lista de verificação para implantação no servidor

Antes de adicionar isso a um servidor de roleplay ativo, teste com os recursos de armas e HUD que seus jogadores já usam. Uma mira padrão pode ser ocultada pelo componente 14, mas muitos servidores também executam sobreposições de armas, miras personalizadas ou HUDs NUI. Esses scripts podem desenhar sua própria mira e precisam de configurações separadas.

1. Crie o recurso em um servidor de teste.
2. Teste pistolas, rifles, espingardas, armas brancas e movimentação desarmada.
3. Verifique a visão em primeira pessoa e em terceira pessoa.
4. Abra o inventário, o menu radial, a substituição da roda de armas e o HUD.
5. Peça a um testador com um cliente limpo e a um testador com sobreposições normais para comparar.

Como depurar uma mira que retorna

Se o ponto retornar apenas ao mirar, seu código pode não estar sendo executado a cada quadro. Se ele retornar apenas com uma arma ou um trabalho, um recurso de arma ou polícia pode estar desenhando a interface. Se ele aparecer apenas para um jogador, verifique os recursos de mira do monitor, sobreposições do ReShade, sobreposições da GPU ou ferramentas de acessibilidade nesse PC.

Boa redação da política do servidor

Se o seu servidor proíbe miras externas, escreva a regra claramente: sem mira no monitor, sem mira sobreposta, sem ponto de mira de terceiros. Em seguida, aplique-a com revisão da equipe, em vez de depender apenas de um script que oculta a mira padrão do HUD.

Documentação de referência

Cfx.re — nativos