THE ORB
Iniciando o studio

A NUI está em branco

Um menu abre como uma caixa branca ou vazia, normalmente porque faltam arquivos dele no download.

groupsOs menus abrem vaziospersonVocê consegue consertar

Faça isto primeiro

Baixe o script de novo: uma extração incompleta é a causa comum.

bug_reportMelhor colar o console inteiro

O que significa

O navegador abriu e não desenhou nada. A interface está rodando —normalmente dá para ver que ela pegou o foco— mas a página em si não carregou ou não chegou a pintar.

O que causa isso

Ordenado pela frequência com que é a resposta.

  1. 1

    Um arquivo que a página precisa não está na lista do manifesto

    Tudo o que a página carrega (HTML, CSS, JS, imagens, fontes) precisa estar declarado em files {}. Arquivos não declarados dão 404 e a página sai vazia.

  2. 2

    O ui_page aponta para o caminho errado

    É relativo à raiz do resource.

  3. 3

    Uma pasta de saída de build que nunca foi construída

    As interfaces de React e Vue carregam de dist/ ou build/. Entregar o código-fonte sem o build dá uma página em branco.

  4. 4

    Um erro de JavaScript na página

    Um único erro sem captura durante a inicialização deixa o elemento raiz vazio.

  5. 5

    Caminhos absolutos que não resolvem

    /assets/x.png resolve para a raiz da nui, não a do resource. Caminhos relativos funcionam; os absolutos normalmente não.

Como saber qual é o seu

Abra as ferramentas de desenvolvimento da NUI com nui_devtools no console do F8. As abas de console e de rede respondem isso em segundos: os 404 apontam para a lista de arquivos, um erro em vermelho para o JavaScript da própria página.

Onde olhar

As entradas ui_page e files do fxmanifest.lua, e o console do navegador.

Como consertar

fx_version 'cerulean'
game 'gta5'

ui_page 'web/dist/index.html'

files {
    'web/dist/index.html',
    'web/dist/**/*',          -- os curingas funcionam e poupam dor de cabeça
}

Ainda travado no seu próprio código?

Esta página é o que esse erro costuma significar. Cole o seu console no Server Fixer e ele vai ordenar tudo o que estiver lá e te dizer o que fazer primeiro; e se você preferir não mexer, o ORBIE consegue consertar o script e te devolver o resource pronto para soltar.

bug_reportAbrir o Server Fixer

Para esse tipo de erro, o Loading Screen Creator constrói NUI que funciona sem HTML escrito à mão.

Erros que andam junto com este