Presskit: Greenlight - Webexport Toolkit for Godot

Beschreibung

Überprüft Ihr Projekt auf häufige Probleme beim Web-Export und behebt die meisten davon mit einem Klick. Enthält einen Startbildschirm (per Klick) für die Audioausgabe im Browser.

Ich entwickle kleine Spiele mit Godot und veröffentliche sie auf Itch.io sowie anderen Webportalen. Der Web-Export war dabei stets der zeitaufwendigste Teil: versehentlich aktivierte Threads, falsche Dateinamen, Audio-Knistern, fehlender Ton bis zum ersten Klick oder ein auf dem Portal abgeschnittenes Spielfenster. Die jeweils passenden Einstellungen im Editor zu finden, ist ein kleines Abenteuer für sich.

Greenlight überprüft dein Projekt sowie die tatsächlichen Export-Presets, zeigt eine Liste mit grün/gelb/roten Statusanzeigen in einem eigenen Dock an und behebt die meisten Probleme mit nur einem Klick.

Was überprüft (und behoben) wird

• Web-Export-Preset vorhanden – erstellt eines, falls es fehlt
• Thread-Unterstützung deaktiviert – schaltet Threads aus (die meisten Portale senden nicht die für Threads erforderlichen COOP/COEP-Header)
• Export-Datei heißt „index.html“ – benennt sie entsprechend um
• Web-Export-Templates sind installiert
• Hauptszene ist festgelegt – verwendet die aktuell geöffnete Szene
• Stretch-Modus ist aktiv – setzt canvas_items / expand
• Web-Audio – Latenz, „Sample“-Wiedergabe und Browser-Mix-Rate werden auf Godots Web-Standardwerte zurückgesetzt

„Fix all“ führt alle Schritte in der richtigen Reihenfolge aus. Wenn dein Projekt über mehrere Web-Presets verfügt, erhält jedes Preset eigene Zeilen, und „Fix all“ fragt ab, welche Presets angepasst werden sollen. Bei nur einem Preset erfolgt die Korrektur direkt.

Zu jedem Problem wird ein Pfad („Where:“) zur entsprechenden Einstellung angezeigt, sodass du sie auch manuell ändern kannst – und zwar in der Sprache deines Editors.

Godot lädt geänderte Export-Presets erst nach einem Neustart neu. Greenlight fordert dich zum Neustart auf und behält einen Hinweis („Restart needed“) im Dock bei, bis der Neustart tatsächlich erfolgt ist.

„Click to start“

Browser geben keinen Ton wieder, solange der Spieler noch nichts angeklickt hat. Greenlight fügt ein WebToolkit-Autoload hinzu:

func _ready() -> void:
await WebToolkit.wait_for_start()
$Music.play()

Im Browser wird dadurch ein einfacher Startbildschirm angezeigt („Click to start“ in der Sprache des Spielers). Im Editor läuft das Spiel hingegen direkt weiter. Details

• Godot 4.5, 4.6 und 4.7 (auf allen drei Versionen getestet)
• Englisch und Deutsch
• Ändert in der export_presets.cfg nur die Zeilen, die tatsächlich korrigiert werden – alle anderen Einstellungen in deinen Presets bleiben unverändert
• Reines GDScript, keine Abhängigkeiten

Demnächst (in Arbeit)

Greenlight bleibt komplett kostenlos. Das nächste Update ist bereits in Entwicklung:

• CrazyGames-Integration – Midgame- und Belohnungs-Werbung (Rewarded Ads) mit nur einer Zeile Code. Das Spiel wird während der Werbung automatisch pausiert und stummgeschaltet; die Sound-Einstellungen von CrazyGames werden berücksichtigt, und Funktionen für Gameplay-Events sowie die Erkennung von Adblockern sind enthalten.
• Test im Browser mit einem Klick – Greenlight exportiert dein Web-Preset, startet einen lokalen Server und öffnet das Spiel – optional inklusive Test-Werbung von CrazyGames.
• Pause beim Tab-Wechsel – das Spiel pausiert und schaltet den Ton aus, wenn der Spieler den Tab wechselt, und läuft weiter, sobald er zurückkehrt.

Weitere Ideen auf der Liste: eine Schaltfläche zum direkten Aufrufen bestimmter Einstellungen, Unterstützung für weitere Web-Portale, eine Überprüfung der Build-Größe sowie ein Performance-Check (auf Ruckler und niedrige FPS im Browser).

Einen Fehler gefunden oder etwas vermisst? Schreib an gdplugin@impact-cores.de.