La NUI est blanche ou vide
Un menu s'ouvre en boîte blanche ou vide, en général parce que des fichiers manquent dans le téléchargement.
Faites d'abord ceci
Retéléchargez le script : une extraction incomplète est la cause habituelle.
Ce que ça veut dire
Le navigateur s'est ouvert et n'a rien affiché. L'interface tourne — on voit en général qu'elle a pris le focus — mais la page elle-même n'a pas chargé ou n'a pas été peinte.
Ce qui la provoque
Classé par fréquence : la cause la plus probable en premier.
- 1
Un fichier dont la page a besoin n'est pas dans la liste du manifeste
Tout ce que la page charge (HTML, CSS, JS, images, polices) doit être déclaré dans
files {}. Les fichiers non déclarés renvoient 404 et la page sort vide. - 2
ui_page pointe vers le mauvais chemin
Il est relatif à la racine de la ressource.
- 3
Un dossier de build qui n'a jamais été construit
Les interfaces React et Vue chargent depuis
dist/oubuild/. Livrer les sources sans le build donne une page blanche. - 4
Une erreur JavaScript sur la page
Une seule erreur non interceptée au démarrage laisse l'élément racine vide.
- 5
Des chemins absolus qui ne résolvent pas
/assets/x.pngpointe vers la racine de la nui, pas celle de la ressource. Les chemins relatifs marchent ; les absolus, généralement pas.
Comment savoir laquelle est la vôtre
Ouvrez les outils de développement NUI avec nui_devtools dans la console F8. Les onglets console et réseau répondent en quelques secondes : des 404 désignent la liste de fichiers, une erreur rouge le JavaScript de la page.
Où regarder
Les entrées ui_page et files de fxmanifest.lua, et la console du navigateur.
Comment la corriger
fx_version 'cerulean'
game 'gta5'
ui_page 'web/dist/index.html'
files {
'web/dist/index.html',
'web/dist/**/*', -- les jokers fonctionnent et évitent bien des ennuis
}Toujours bloqué sur votre propre code ?
Cette page explique ce que cette erreur signifie en général. Collez votre console dans Server Fixer : il classera tout ce qui s'y trouve et vous dira quoi faire en premier ; et si vous préférez ne pas y toucher, ORBIE peut réparer le script et vous rendre la ressource prête à déposer.
bug_reportOuvrir le Server FixerPour ce type d'erreur, le Loading Screen Creator construit une NUI qui marche sans HTML écrit à la main.