THE ORB
Studio wird gestartet

Die NUI ist leer oder weiß

Ein Menü öffnet sich als weißer oder leerer Kasten — meist fehlen Dateien im Download.

groupsMenüs öffnen sich leerpersonDas kannst du beheben

Mach das zuerst

Lad das Script neu herunter — ein unvollständiges Entpacken ist die übliche Ursache.

bug_reportFüg lieber deine ganze Konsole ein

Was es bedeutet

Der Browser hat geöffnet und nichts gezeichnet. Die Oberfläche läuft — man merkt meist, dass sie den Fokus genommen hat — aber die Seite selbst hat nicht geladen oder nicht gemalt.

Was es auslöst

Sortiert danach, wie oft es die Antwort ist.

  1. 1

    Eine Datei, die die Seite braucht, fehlt in der Liste des Manifests

    Alles, was die Seite lädt (HTML, CSS, JS, Bilder, Schriften), muss in files {} deklariert sein. Nicht deklarierte Dateien geben 404, und die Seite bleibt leer.

  2. 2

    ui_page zeigt auf den falschen Pfad

    Er ist relativ zum Wurzelverzeichnis der Resource.

  3. 3

    Ein Build-Ausgabeordner, der nie gebaut wurde

    React- und Vue-Oberflächen laden aus dist/ oder build/. Den Quellcode ohne Build auszuliefern ergibt eine weiße Seite.

  4. 4

    Ein JavaScript-Fehler auf der Seite

    Ein einziger unbehandelter Fehler beim Start lässt das Wurzelelement leer.

  5. 5

    Absolute Pfade, die nicht auflösen

    /assets/x.png löst auf die NUI-Wurzel auf, nicht auf die Resource. Relative Pfade funktionieren, absolute meist nicht.

Wie du erkennst, welcher deiner ist

Öffne die NUI-Entwicklerwerkzeuge mit nui_devtools in der F8-Konsole. Konsolen- und Netzwerk-Tab beantworten das in Sekunden: 404er zeigen auf die Dateiliste, ein roter Fehler auf das JavaScript der Seite selbst.

Wo du nachsehen musst

Die Einträge ui_page und files in der fxmanifest.lua und die Browserkonsole.

Wie du es behebst

fx_version 'cerulean'
game 'gta5'

ui_page 'web/dist/index.html'

files {
    'web/dist/index.html',
    'web/dist/**/*',          -- Platzhalter funktionieren und ersparen viel Ärger
}

Hängst du immer noch an deinem eigenen Code?

Diese Seite sagt, was dieser Fehler üblicherweise bedeutet. Füg deine Konsole in Server Fixer ein: es sortiert alles darin und sagt dir, was zuerst dran ist; und wenn du lieber nicht ranwillst, kann ORBIE das Script reparieren und dir die Resource fertig zum Einsetzen zurückgeben.

bug_reportServer Fixer öffnen

Für diese Art Fehler Loading Screen Creator baut NUI, die ohne handgeschriebenes HTML funktioniert.

Fehler, die mit diesem zusammen auftreten