Repository navigation
v0.4.0 — UE port batch verified + polish
PS1Godot v0.4.0 — "UE port batch verified + polish"
Release date: 2026-05-18
Splashpack format: v32 (unchanged from v0.3.x)
TL;DR
This release closes out the UE port batch landed in v0.3.x, ships verification across all eight handoff phases (A–H), and adds three Option-1 polish features plus six follow-up bug fixes. The graph editor is now genuinely usable end-to-end, the bottom-panel UI no longer overwhelms first-time authors, and editor shutdown is finally clean (no more 0xc0000005 access violation dialog on close).
New features
- Dialogue typewriter reveal.
feat(dialogue): typewriter text-reveal effect on Line nodes. Authors can opt into a per-line typewriter crawl with author-set rate (chars/sec). X-press skips to end. Slice 1 covers typewriter only; per-letter fade-in / fall-in / jitter are future work that share the same cursor state machine. - Compile button writes the file.
feat(graph): Compile button writes sibling .lua to disk. The Compile button on the PS1 Graph dock toolbar now produces the .lua artifact instead of just printing the preview to the Output panel. Encodes the "action buttons must complete the action" UI principle.
Behaviour changes
- Bottom-panel tab strip consolidated from 10 tabs to 4 (
PS1 Graph,PS1 Doctor,PS1 Authoring,PS1 Tools). Secondary docks (UI Canvas, VRAM, Audio, Lua API, Quest Journal, Graph Find, References, Lua REPL) fold into the two grouped containers via internal sub-tabs. Addresses the "non-intimidating" pillar of the UI/UX philosophy. - Graph node titlebars are now category-tinted (Dialogue=blue, FSM=teal, Quest=amber, Untyped=grey, Meta=purple) with luminance-based title-text contrast. Earlier code targeted the
title_colortheme entry, which in Godot 4.7-dev5 only sets the title text colour, not the bar background — the new override hits bothtitlebarStyleBox and the title Label'sfont_color. - Disabled entry node auto-promotes downstream.
fix(graph): preserve EnabledState on reload + promote entry past disabled. Flipping the dialogue entry to Disabled used to compileentry = nil(dead graph). Now the compiler's entry-picker mirrorsFindNextKey's "chase past Disabled" semantics, matching UE Blueprint behaviour. - PS1Godot right-side dock now scrolls vertically.
fix(ui): wrap PS1Godot dock content in ScrollContainer. Phase 3 budget rows + last-export summary + Quick Actions stacked past the visible height; sections below the fold were unreachable until this fix. launch-editor.cmdauto-rebuilds the C# plugin DLL on launch and tees Godot's stdout+stderr togodot-ps1/.editor.logfor post-crash diagnosis. Godot 4.x .NET doesn't refresh plugin assemblies on startup, and a stale DLL silently ran old code on every restart prior to this.
Bug fixes
fix(graph): don't double-wrap BT leaf return statements—return "success"inside a BT leaf used to compile toreturn (return "success")(Lua syntax error). Leaf compiler now detects a leadingreturnand emits the snippet verbatim; only bare expressions get wrapped.fix(graph): preserve EnabledState on reload + promote entry past disabled— fallbackReconstructGraphFromBareResource(used when Godot 4.7-dev5 drops the C# script binding on .tres load) wasn't reading theEnabledStateproperty, silently reverting Disabled/DevelopmentOnly to Enabled on every reload. Added to the reconstruction; also fixed the entry-picker as above.fix(runtime): ASCII-only debug prints (no more PCSX-Redux mojibake)— em-dashes (—) and arrows (→,←,↑↓) in dialogue / lua hot-swap printfs rendered asΓÇö/ΓåÆin PCSX-Redux's cp437 console. Substituted ASCII equivalents.fix(scripting): override PS1LuaScript._editor_can_reload_from_file— Godot 4.7 promoted this virtual to "required"; missing override printed a red error on every Run-on-PSX. Returns false (we have our own hot-swap path via PCdrv).fix(graph): auto-sync sibling .lua when .tres changes outside dock— Ctrl+S / inspector commit / other internal Godot saves bypassedWriteCompiledLuaSibling, leaving authors with the "edit n0, F5, dialogue runs old state, F5 again to fix" two-pass trap. Plugin now subscribes toEditorFileSystem.FilesystemChangedand regenerates any stale sibling .lua (mtime-gated).fix(scripting): take_over_path on .lua reload— every F5 spammed twoAnother resource is loaded from path 'res://X.lua'errors. PS1LuaResourceFormatLoader now usestake_over_pathinstead ofset_path, replacing the cached PS1LuaScript instance cleanly.fix(ui): enable small-preview generation for audio clip thumbnails—PS1AudioClipPreviewGeneratorwas registered but never queried for the FileSystem dock's 64×64 thumbnails (Godot's_can_generate_small_previewdefaults false). Overrode both_CanGenerateSmallPreviewand_GenerateSmallPreviewAutomatically; waveform + route stripe now visible per clip. Delete.godot/imported/after upgrading to refresh cached thumbnails.fix(plugin): guard submenu QueueFree against disposed PopupMenu+fix(plugin): drain pending finalizers in _ExitTree— Windows0xc0000005access violation on editor exit (reported since the UE port batch). Two distinct triggers: (1) cleanup code calledQueueFreeon submenu PopupMenus thatRemoveToolMenuItemhad already disposed, and (2)Godot.Collections.Arraywrappers sitting on the C# finalizer queue ran after Godot's native side was already torn down. Diagnosed via per-stepGD.Printbreadcrumbs in_ExitTree; fixed byIsInstanceValid-guarding the QueueFree calls and force-draining the GC finalizer queue while Godot is still alive. Editor now exits cleanly.
Upgrade notes
- Delete
.godot/imported/after upgrading to refresh PS1AudioClip thumbnails. Godot caches by content hash and won't re-query the generator otherwise. - No splashpack format bump. v32 from v0.3.x is forward-compatible with this release's runtime, but the runtime contains the typewriter implementation, so old splashpacks won't show the typewriter even if their .lua sets
reveal_mode = "typewriter". Rebuild the splashpack to pick it up. launch-editor.cmdnow keeps the cmd window open after Godot exits (viapause). If you scripted around the old auto-close behaviour, adjust.- Plugin DLL is rebuilt on every launch. Set
GODOT_NO_BUILD=1in your environment to skip the gate (useful when debugging a known-bad build).
Artifacts
PS1Godot-plugin-20260518.zip— drop into your project ataddons/ps1godot/.psxsplash-runtime-20260518.zip— contains bothpsxsplash.ps-exe(PCdrv) andpsxsplash-cdrom.ps-exe(ISO mode). F5's Run-on-PSX auto-selects the right variant based on whether the scene has XA-routed audio.
Commits in this release
dd045ae fix(plugin): drain pending finalizers in _ExitTree (kills 0xc0000005)
d0eeab2 chore(tooling): launch-editor tees Godot output to .editor.log
e3b3067 fix(plugin): guard submenu QueueFree against disposed PopupMenu
6b6ab98 chore(plugin): _ExitTree breadcrumbs for shutdown-crash diagnostic
91a5744 fix(scripting): take_over_path on .lua reload (no more cyclic warnings)
17eb157 fix(ui): enable small-preview generation for audio clip thumbnails
9354708 fix(graph): auto-sync sibling .lua when .tres changes outside dock
e67fb0f fix(scripting): override PS1LuaScript._editor_can_reload_from_file
f5a5349 fix(runtime): ASCII-only debug prints (no more PCSX-Redux mojibake)
c7d8850 feat(dialogue): typewriter text-reveal effect on Line nodes
36fc5cb fix(ui): consolidate bottom-panel tabs into 4 grouped containers
34e4164 fix(graph): category-tinted titlebar with luminance-based text contrast
4723a74 fix(graph): don't double-wrap BT leaf return statements
9a66cb1 fix(graph): preserve EnabledState on reload + promote entry past disabled
96086d7 feat(graph): Compile button writes sibling .lua to disk
bd74edd fix(ui): wrap PS1Godot dock content in ScrollContainer
63d14c6 chore(tooling): launch-editor rebuilds C# DLL before start
17 commits since v0.3.x (handoff baseline 7f64c7e).
Verified by
- Phase A–H of the UE port batch verification (see
docs/handoff-2026-05-17-ue-port-batch.md). - End-to-end dialogue smoke (typewriter + notify + sub-dialogue + lua_snippet) on PCSX-Redux.
- Clean editor shutdown after the GC-drain fix — no 0xc0000005.