THE ORB
Arrancando el studio

La NUI está en blanco

Un menú se abre como una caja blanca o vacía, normalmente porque faltan archivos suyos en la descarga.

groupsLos menús abren vacíospersonPodés arreglarlo

Haz esto primero

Vuelve a descargar el script: una extracción incompleta es la causa habitual.

bug_reportMejor pega tu consola entera

Qué significa

El navegador se abrió y no dibujó nada. La interfaz está corriendo —normalmente se nota que tomó el foco— pero la página en sí no cargó o no llegó a pintarse.

Qué lo provoca

Ordenado por la frecuencia con la que es la respuesta.

  1. 1

    Un archivo que la página necesita no está en la lista del manifiesto

    Todo lo que la página cargue (HTML, CSS, JS, imágenes, tipografías) tiene que estar declarado en files {}. Los archivos sin declarar dan 404 y la página sale vacía.

  2. 2

    ui_page apunta a la ruta equivocada

    Es relativa a la raíz del recurso.

  3. 3

    Una carpeta de salida de compilación que nunca se compiló

    Las interfaces de React y Vue cargan desde dist/ o build/. Entregar el código fuente sin la compilación da una página en blanco.

  4. 4

    Un error de JavaScript en la página

    Un solo error sin capturar durante el arranque deja el elemento raíz vacío.

  5. 5

    Rutas absolutas que no resuelven

    /assets/x.png resuelve a la raíz de la nui, no a la del recurso. Las rutas relativas funcionan; las absolutas normalmente no.

Cómo saber cuál es el tuyo

Abrí las herramientas de desarrollo de la NUI con nui_devtools en la consola de F8. Las pestañas de consola y de red te contestan esto en segundos: los 404 apuntan a la lista de archivos, un error en rojo al JavaScript de la propia página.

Dónde mirar

Las entradas ui_page y files de fxmanifest.lua, y la consola del navegador.

Cómo arreglarlo

fx_version 'cerulean'
game 'gta5'

ui_page 'web/dist/index.html'

files {
    'web/dist/index.html',
    'web/dist/**/*',          -- los comodines funcionan y ahorran disgustos
}

¿Sigues atascado en tu propio código?

Esta página es lo que suele significar este error. Pega tu consola en Server Fixer y ordenará todo lo que haya en ella y te dirá qué hacer primero; y si prefieres no tocarlo, ORBIE puede reparar el script y devolverte el recurso listo para soltar.

bug_reportAbrir el Server Fixer

Para este tipo de error, el Loading Screen Creator construye NUI que funciona sin escribir HTML a mano.

Errores que viajan con este