sc_textUI para FiveM: exports, instalação e remoção de avisos

sc_textUI da ScubeScripts é um recurso de avisos de texto para FiveM independente de framework. A versão 1.0.0 revisada usa ui/textui.html e não declara dependência de ESX ou QBCore. O código foi conferido no commit e97687f41b97895464522842927fe230e28c1822.

Fonte do criador

Use a interface documentada

Scripts de cliente chamam exports.sc_textUI:showUI(key, message) e exports.sc_textUI:hideUI(). Scripts de servidor usam TriggerClientEvent para enviar sc_textUI:showUI a playerId com key e message, ou sc_textUI:hideUI a playerId. A NUI atribui a tecla e a mensagem usando textContent. Isso exibe um aviso; seu código de interação deve executar a ação e as verificações de permissão necessárias no servidor.

Instale e integre primeiro uma interação

Coloque sc_textUI em resources e adicione ensure sc_textUI antes dos recursos que chamam seus exports. Mantenha fxmanifest.lua diretamente na pasta do recurso. O README inclui um exemplo opcional de substituição do ESX TextUI; faça backup da integração original antes de adaptá-la. Defina um único responsável pelo aviso visível para que um recurso não oculte a mensagem de outro.

Oculte avisos antigos e teste traduções mais longas

Chame hideUI quando o jogador sair da interação, morrer, se teleportar ou mudar de estado e trate a limpeza ao parar o recurso ou reconectar. Teste mensagens traduzidas longas, escala da interface e diferentes tamanhos de tela. O loop de marcador executado a cada quadro no README é um exemplo de integração, não uma exigência inerente de desempenho. Meça seu loop real antes de fazer alegações de desempenho.

Código e licença

O repositório inclui GPL-3.0. Mantenha a licença e os avisos junto ao código redistribuído e revise a licença antes de distribuir modificações. Esta revisão confirma a interface documentada e os arquivos inspecionados; não é um benchmark em jogo nem uma garantia de compatibilidade com todas as integrações de interface.