MRI Qloadscreen

Tela de carregamento da MRI Qbox. Mostra um vídeo de fundo com música, a logo, os textos da cidade, o botão do Discord, a staff e a barra de progresso com a etapa do carregamento do jogo. Tudo é editado dentro do jogo, no painel do mri_Qadmin, com prévia ao vivo.

Sumário

1. Dependências
2. Instalação
3. Permissões (ACE)
4. Painel admin
5. Arquivos locais
6. Formato do data/config.json
7. Teclas
8. Barra de progresso
9. Tema e cores
10. Atualizando de uma versão com config.lua
11. Estrutura de arquivos
12. Desenvolvimento

Dependências

Instalação

1. Copie a pasta mri_Qloadscreen para resources/.
2. No server.cfg, garanta ensure ox_lib antes do resource e então ensure mri_Qloadscreen.
3. Desative qualquer outro resource que declare loadscreen: o FiveM usa só uma tela de carregamento.

O fxmanifest.lua usa loadscreen_manual_shutdown 'yes': a tela fecha quando o jogo chama ShutdownLoadingScreenNui (o qbx_core ou o mri_Qmultichar fazem isso).

Permissões (ACE)

Pode abrir e salvar o painel quem tiver qualquer uma destas:

Painel admin

No mri_Qadmin, abra Tela de carregamento. À esquerda ficam os campos; à direita, a prévia da tela com o rascunho atual (sem som). Salvar grava em data/config.json, Descartar volta ao que está salvo e Padrão carrega a configuração de fábrica (só grava ao salvar).

As mudanças valem a partir da próxima conexão: quem já está na tela não recebe a alteração.

Arquivos locais

Vídeo, música, logo e foto aceitam um link (https://...) ou o nome de um arquivo na pasta correspondente do resource:

Vídeo local pesado aumenta o download de quem entra pela primeira vez. Para vídeos grandes, prefira um link.

Formato do data/config.json

Criado pelo servidor na primeira subida e reescrito a cada save do painel. Campo que falta ou vem inválido volta ao padrão.

Teclas

Barra de progresso

A porcentagem vem do loadProgress do FiveM e só anda pra frente. Ao lado do texto de carregamento aparece a etapa atual: iniciando o jogo, preparando o mapa, carregando o mapa, carregando o mundo e entrando na sessão.

O spinner de "carregando" que o GTA desenha no canto inferior direito fica desligado: o server.lua liga a convar sv_showBusySpinnerOnLoadingScreen como false ao subir.

Tema e cores

A tela segue o tema da suíte (@mriqbox/ui-kit), lido no momento da conexão e enviado à NUI pelo deferrals.handover:

• Cor de destaque: convar mri:color.
• Cor de fundo: convar mri:backgroundColor (vazio = #09090B).
• Tema, opacidade, fonte, radius e overrides de cor: /uiconfig do ox_lib, lido de ox_lib/mri/data/config.json.

Atualizando de uma versão com config.lua

Se o resource sobe sem data/config.json e existe um config/config.lua antigo, o servidor importa os textos, a logo, o Discord, a staff e as faixas dele uma única vez e grava o json. O console mostra config/config.lua imported into data/config.json. Depois disso o config.lua não é mais lido e pode ser apagado.

O data/config.json não vem no repositório: atualizar o resource não apaga a configuração.

Estrutura de arquivos

mri_Qloadscreen/
├── fxmanifest.lua
├── server.lua          # config em data/config.json, handover, save do painel, plugin do Qadmin
├── client.lua          # callbacks NUI do painel
├── data/config.json    # gerado pelo servidor (fora do git)
├── config/             # logo, video, audio, staffs
├── html/               # build da interface (tela e painel)
└── web/                # código da interface (React + Vite)
    └── src/
        ├── App.jsx                 # entrada da tela: progresso e etapa
        ├── loadscreen/             # a tela, usada também na prévia do painel
        ├── admin/                  # painel do mri_Qadmin
        └── lib/                    # tema, assets, staff, bridge do plugin

Desenvolvimento

cd web
pnpm install
pnpm dev     # tela em /, painel em /admin.html, com dados de exemplo
pnpm lint
pnpm build   # saída em ../html

No navegador, a tela simula o progresso e o painel salva só em memória. A NUI do FiveM é Chrome 103: o build mira chrome103.