Skip to content

Releases

v0.5.1 — Linux + macOS binaries actually shipped

Choose a tag to compare

@BuffJesus BuffJesus released this 19 May 03:46

PS1Godot v0.5.1 — "Linux + macOS binaries actually shipped"

Release date: 2026-05-18
Splashpack format: v32 (unchanged from v0.5.0)

TL;DR

v0.5.0 added Linux + macOS support at the source level but didn't
bundle the per-platform GDExtension binaries (CI matrix hadn't run
yet). v0.5.1 closes that loop: the CI matrix is now passing 12/12
green across all three OSes, and the plugin zip below contains every
platform's libps1lua.* library so Linux and macOS users get the
PS1Lua script-language extension (syntax highlighting, autocomplete,
API stubs) on install — no local SCons build required.

What changed since v0.5.0

  • Linux GDExtension binaries bundled: libps1lua.linux.editor.x86_64.so,
    libps1lua.linux.template_debug.x86_64.so, and
    libps1lua.linux.template_release.x86_64.so. Built by CI from
    upstream godot-cpp commit 4862a9d.
  • macOS GDExtension binaries bundled: libps1lua.macos.editor.universal.dylib,
    libps1lua.macos.template_debug.universal.dylib, and
    libps1lua.macos.template_release.universal.dylib. Universal
    binaries — work on Apple Silicon and Intel.
  • ps1lua.gdextension macOS paths corrected from .framework to
    .universal.dylib to match the SCons output convention. The
    v0.5.0 entries were aspirational (they pointed at a .framework
    bundle that godot-cpp doesn't actually produce on macOS for our
    build setup); v0.5.1 ships the real filenames.

Behaviour changes

None. Source-level changes are limited to the gdextension manifest's
macOS library paths.

CI history (for the curious)

The v0.5.0 CI matrix needed five rounds of debugging to reach 12/12
green — see commits 2a7db6c, 4b31eb5, 732d8cd, ab15059:

  • GODOT_NUPKGS bootstrap for the C# build job — the
    Godot.NET.Sdk/4.7.0-dev.5 pre-release isn't on nuget.org, so CI
    downloads the matching Godot zip per OS and points NuGet at the
    embedded GodotSharp/Tools/nupkgs/ folder.
  • pwd -W on Windows runners — Git Bash's plain pwd returns
    POSIX paths (/c/Users/...) that Windows NuGet can't parse;
    pwd -W gives the C:\Users\... form.
  • godot-cpp SHA pinned to upstream — the local working-tree
    checkout had a one-commit private tweak (d328849) on top of
    upstream master that was never pushed; CI couldn't reach the SHA.
    Now pinned to the upstream merge-base 4862a9d, verified to exist
    via api.github.com.

The lessons are baked into the workflow file's inline comments so
future bumps don't repeat them.

Artifacts

  • PS1Godot-plugin-v0.5.1.zip — drop into your project at
    addons/ps1godot/. Now contains GDExtension binaries for all
    three platforms
    (Windows .dll, Linux .so, macOS universal.dylib).
  • psxsplash-runtime-v0.5.1.zip — unchanged from v0.5.0; both PCdrv
    and CDROM variants of the PS1 runtime.

Verification

CI run 26073945304 (sha ab15059): 12/12 green. All artifacts
downloaded from that run and bundled here.

v0.5.0 — Linux + macOS support

Choose a tag to compare

@BuffJesus BuffJesus released this 19 May 02:41

PS1Godot v0.5.0 — "Linux + macOS support"

Release date: 2026-05-18
Splashpack format: v32 (unchanged from v0.4.x)

TL;DR

Linux and macOS contributors can now clone the repo, follow SETUP.md,
and reach the same one-button Run-on-PSX loop Windows users get. The
tooling collapsed onto a single Python entry point (scripts/run.py),
the GDExtension grew Linux/macOS build targets, and a GitHub Actions
matrix validates all three platforms on every push.

Closes RFC docs/rfc/linux-support.md
in four stages.

What's new

  • Cross-platform launcher. scripts/run.py replaces every .cmd
    file with a single argparse dispatcher. Five actions:
    bootstrap-env, build-psxsplash (--loader=pcdrv|cdrom),
    launch-editor, launch-emulator (--iso), launch-game.
    Tool discovery is env-var-first (GODOT_EXE, PCSX_REDUX_EXE),
    falling back to per-OS defaults, then shutil.which-style PATH
    probes. MIPS toolchain auto-detects mipsel-none-elf-gcc (Windows /
    macOS) OR mipsel-linux-gnu-gcc (Linux apt) and passes the matching
    PREFIX=... to make.
  • Parallel .cmd + .sh shims. Every action keeps its native-feel
    shortcut: scripts\build-psxsplash.cmd on Windows, ./scripts/build-psxsplash.sh
    on Linux/macOS. Both are one-line wrappers around python scripts/run.py.
  • PS1Godot dock dispatches via Python. PS1GodotPlugin.RunScript
    • the two OS.CreateProcess launch sites now invoke
      python(3) scripts/run.py <action> instead of cmd.exe /c ....
      Drops the hardcoded \ path conversions; in-editor Build / Launch
      buttons work identically across platforms.
  • GDExtension Linux + macOS targets. ps1lua.gdextension declares
    linux.*.x86_64 (.so) and macos.* (.framework) entries.
    Local SCons builds for either platform are picked up automatically;
    CI matrix produces them on every push.
  • build-release.py packages both psxsplash variants. PCdrv +
    CDROM .ps-exe (and matching .elf debug symbols) ship in the
    runtime zip. Splashpack version is read from the runtime's own
    assertion (splashpack.cpp) so the README doesn't drift.
  • GitHub Actions matrix. .github/workflows/build-gdextension.yml
    builds the PS1Lua GDExtension across (Windows, Linux, macOS) ×
    (editor, template_debug, template_release) on every push to
    main / PR / tag push. Per-OS / per-target artifacts upload for
    30 days. A parallel plugin-csharp job runs dotnet build on
    every OS to catch C# regressions on platforms we don't usually
    develop on.
  • Docs reformatted for three platforms. README.md adds the
    Platforms: Windows / Linux / macOS line near the top. QUICKSTART.md
    drops the Windows-only caveat; the "install the four tools" section
    has per-OS install commands. SETUP.md prerequisites table grows
    Windows / Linux / macOS columns; the env-var defaults table lists
    per-OS fallback paths.

Behaviour changes

  • scripts/*.cmd files are now one-line shims into Python.
    Existing muscle memory works unchanged on Windows. If you had
    custom hooks in any of them, port the logic into scripts/run.py
    alongside the existing actions.
  • launch-editor keeps the cmd window open via pause on
    abnormal exit so the post-exit log stays visible.
  • PS1GodotPlugin.RunScript(action, label, ...extraArgs) signature
    changed: callers now pass action names like "build-psxsplash"
    instead of script paths like "scripts/build-psxsplash.cmd". Only
    affects forks of the plugin that added their own toolbar buttons.
  • .gitattributes pins line endings: .sh and .py always LF,
    .cmd always CRLF. Avoids the cross-platform-clone breakage where
    shell scripts arrive with CRLF on Linux (bash misparses) or batch
    scripts arrive with LF on Windows (cmd silently exits early).

What's not yet bundled (and how to get it)

The Linux .so and macOS .framework GDExtension binaries are
not yet attached to this release. They're built per push by the
new CI workflow — download from the Actions tab and either:

  1. Wait for v0.5.1 which will include them in the plugin zip
    (build-release.py already includes any binaries it finds in
    scripting/build/), OR
  2. Build locally: cd godot-ps1/addons/ps1godot/scripting && scons platform=<linux|macos>,
    then re-run python scripts/py/build-release.py.

Until they land in the zip, Linux/macOS users without PS1Lua syntax
highlighting / autocomplete can still author, export, and Run-on-PSX
fully — only the in-editor Lua language features need the extension.

Upgrade notes

  • No code-level breaking changes for users of the plugin's runtime
    API or splashpack format. Anyone who hasn't customised scripts/*.cmd
    shouldn't notice the change.
  • Forks with custom toolbar buttons that called RunScript("scripts/foo.cmd", "Label")
    need to migrate to action names. See OnBuildPsxsplash / OnBuildPsxsplashCdrom
    for the pattern.
  • Python 3.10+ becomes a hard dependency for the launcher. Already
    true via build_iso.py, gen_api_data.py, and build-release.py,
    but now the in-editor Build button also fails without it.
  • scripts/bootstrap-env.cmd no longer calls setx. Running it
    prints resolved values and a per-OS hint at how to persist your own
    overrides. Set env vars directly via setx (Windows) or shell rc
    (Linux/macOS).

Artifacts

  • PS1Godot-plugin-v0.5.0.zip — drop into your project at
    addons/ps1godot/. Windows GDExtension .dll bundled; Linux / macOS
    binaries see "What's not yet bundled" above.
  • psxsplash-runtime-v0.5.0.zip — both psxsplash.ps-exe (PCdrv) and
    psxsplash-cdrom.ps-exe (ISO) bundled with matching .elf debug
    symbols and a refreshed README.

Commits since v0.4.0

0e035ec docs: v0.5 Stage 4 — per-OS install for SETUP, QUICKSTART, README
6458e2f ci: v0.5 Stage 3 — GDExtension matrix (Windows / Linux / macOS)
de8f2ee feat(tooling): v0.5 Stage 2 — GDExtension Linux/macOS targets + multi-variant runtime zip
58f26d0 feat(tooling): v0.5 Stage 1 — cross-platform launcher (scripts/run.py)

4 commits, ~700 LOC across scripts/, addons/ps1godot/,
.github/workflows/, and the three top-level doc files.

Verified

  • python scripts/run.py launch-editor (Windows): rebuilds C# plugin,
    opens Godot, plugin loads clean, editor closes with exit 0, all
    _ExitTree: markers fire as in v0.4.0.
  • python scripts/run.py bootstrap-env: resolves Godot, PCSX-Redux,
    MIPS toolchain, dotnet — all four labeled [set] or [auto].
  • In-editor "Build" + Run-on-PSX flow works via the new dispatcher.

Linux / macOS verification deferred to community testing — please
file issues at https://github.com/BuffJesus/PS1Godot/issues if you
hit anything.

v0.4.0 — UE port batch verified + polish

Choose a tag to compare

@BuffJesus BuffJesus released this 19 May 02:11

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_color theme entry, which in Godot 4.7-dev5 only sets the title text colour, not the bar background — the new override hits both titlebar StyleBox and the title Label's font_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 compile entry = nil (dead graph). Now the compiler's entry-picker mirrors FindNextKey'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.cmd auto-rebuilds the C# plugin DLL on launch and tees Godot's stdout+stderr to godot-ps1/.editor.log for 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 to return (return "success") (Lua syntax error). Leaf compiler now detects a leading return and emits the snippet verbatim; only bare expressions get wrapped.
  • fix(graph): preserve EnabledState on reload + promote entry past disabled — fallback ReconstructGraphFromBareResource (used when Godot 4.7-dev5 drops the C# script binding on .tres load) wasn't reading the EnabledState property, 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 bypassed WriteCompiledLuaSibling, leaving authors with the "edit n0, F5, dialogue runs old state, F5 again to fix" two-pass trap. Plugin now subscribes to EditorFileSystem.FilesystemChanged and regenerates any stale sibling .lua (mtime-gated).
  • fix(scripting): take_over_path on .lua reload — every F5 spammed two Another resource is loaded from path 'res://X.lua' errors. PS1LuaResourceFormatLoader now uses take_over_path instead of set_path, replacing the cached PS1LuaScript instance cleanly.
  • fix(ui): enable small-preview generation for audio clip thumbnails — PS1AudioClipPreviewGenerator was registered but never queried for the FileSystem dock's 64×64 thumbnails (Godot's _can_generate_small_preview defaults false). Overrode both _CanGenerateSmallPreview and _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 — Windows 0xc0000005 access violation on editor exit (reported since the UE port batch). Two distinct triggers: (1) cleanup code called QueueFree on submenu PopupMenus that RemoveToolMenuItem had already disposed, and (2) Godot.Collections.Array wrappers sitting on the C# finalizer queue ran after Godot's native side was already torn down. Diagnosed via per-step GD.Print breadcrumbs in _ExitTree; fixed by IsInstanceValid-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.cmd now keeps the cmd window open after Godot exits (via pause). If you scripted around the old auto-close behaviour, adjust.
  • Plugin DLL is rebuilt on every launch. Set GODOT_NO_BUILD=1 in your environment to skip the gate (useful when debugging a known-bad build).

Artifacts

  • PS1Godot-plugin-20260518.zip — drop into your project at addons/ps1godot/.
  • psxsplash-runtime-20260518.zip — contains both psxsplash.ps-exe (PCdrv) and psxsplash-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.

PS1Godot 2026-04-20

Choose a tag to compare

@BuffJesus BuffJesus released this 21 Apr 06:00

PS1Godot 2026-04-20 — Sequenced music + interior scenes

First public snapshot. Phase 2 of the roadmap complete; Phase 3 polish
starting. You can now author a full PS1 scene in Godot — meshes with
CLUT-quantized textures, colliders, flat nav regions, interactive
objects, UI canvases, cutscenes, skinned meshes with baked animation,
MIDI-driven sequenced music, multi-scene packing, portal-culled
interior scenes, dialog-driven Lua scripts — and hit one button to see
it running on a real PS1 (or PCSX-Redux). Splashpack format at v22.


⚡ Quickstart

1. Grab PS1Godot-plugin-<version>.zip below.
2. Extract into your Godot .NET project's addons/ folder.
3. Grab psxsplash-runtime-<version>.zip, put psxsplash.ps-exe in
   godot-ps1/build/.
4. In Godot, enable the PS1Godot plugin (Project → Project Settings
   → Plugins), then click ▶ Run on PSX in the dock.

Full walkthrough: QUICKSTART.md. Build your own
scene from scratch: docs/tutorial-basic-scene.md.


🎵 What's new — sequenced music

The tentpole feature of this release. A complete MIDI → PS1 SPU music
pipeline built on top of the existing psxsplash audio stack.

  • Drop in a .mid + short instrument WAV samples (bass tone, pad,
    lead, kick, snare, hat — as many as you want up to 8 SPU voices).
  • Create a PS1MusicSequence resource, bind each MIDI channel to
    an audio clip with a base note + volume + pan.
  • Per-note routing for drum kits: one channel per drum, filtered
    to a specific MIDI note (36 = kick, 38/40 = snare, 42 = hat).
    Percussion mode disables pitch shifting.
  • From Lua: Music.Play("track_name", volume), Music.Stop(),
    Music.SetVolume(v), Music.GetBeat(), Music.IsPlaying().
  • Voice reservation: music claims 6 SPU voices for its lifetime;
    dialog/SFX use the other 18. Dialog can never steal a held music
    note mid-sustain.
  • Automatic ducking: dialog scripts drop music volume on show,
    restore on hide. No more narration fighting the BGM.
  • 12th-root-of-2 pitch table (precomputed, 168 B rodata, no libm)
    so one short sample covers a whole melodic range.
  • Binary format documented in
    docs/sequenced-music-format.md.

Most retro-game-music authoring flows — SEQ/VAB conversion, external
tooling — go away. Export MIDI from your DAW, pick samples, done.

🏠 Phase 2 bullet 12 — interior scenes (rooms + portals)

Authored via PS1Room (volume bounds) + PS1PortalLink (connect two
rooms through a portal surface). Exporter assigns triangles to rooms
by vertex-majority containment; runtime culls everything you can't see
through the portal you're looking at. Demo ships two rooms connected
by a portal link you can walk through and see the culling in action.

🌐 Multi-scene + teleports

PS1Scene.SubScenes packs additional scenes into the same splashpack.
Scene.Load(N) Lua API swaps between them mid-game. Demo includes a
"checkered realm" sub-scene reachable via a teleport trigger — a
pattern for boss arenas, dream sequences, region transitions,
menus-as-scenes.

🎬 Cutscene rotation convention — finally solved

Reproduced + diagnosed + fixed the "camera points wrong direction"
bug in the cutscene timeline track. Root cause was on the exporter
side: psyqo::Angle is FixedPoint<10> in fractions of Pi
(1.0 pi-unit = 180° = 1024 raw fp10), not fp12 degrees. Every
authored angle was being doubled. Documented the matrix convention
so future cutscene authors can rely on "raw Vector3 euler → PSX"
making sense. See docs/psxsplash-improvements.md
entry N+1 for the postmortem.

💬 Dialog system overhaul

  • Single-line-per-press model replaces the old multi-line
    auto-advance that could wedge and leave dialogs stuck on screen.
  • Audio-aware auto-hide via new Audio.GetClipDuration(name) Lua
    API: dialog boxes stay up for the full voice-clip duration, not a
    fixed 1.5-second timer. Silent/missing clips fall back cleanly.
  • Music ducking coordinated via a shared bgmMasterVol global
    so all scripts restore the same target volume.

🎨 Authoring conventions

  • Godot 4.4+ WAV import fix: [importer_defaults] in
    project.godot overrides the default QOA compression to raw PCM.
    New WAV drops work with the exporter out of the box; you no longer
    need to click into Import tab per file.
  • Audio clip residency flag (Gameplay / MenuOnly /
    LoadOnDemand) carried forward — only gameplay-resident clips count
    against the SPU budget bar.

🛠️ Bug fixes you don't need to know about but might as well

  • MIDI parse sort order: NoteOff must fire before NoteOn at the
    same tick. Cost 169 silenced snare hits in the demo song until
    found. Documented in MidiParser.cs.
  • Tempo conversion: runtime's m_dt12 = 4096 means one 30 fps
    frame, not 60. Music played at half speed until corrected.
  • Pitch table accuracy: iterative rate = (rate * NUM) / DEN
    accumulates 1-2% error per step in fp14 — wildly wrong by the
    third semitone. Precomputed table is the right answer.
  • Portal-culling safety fallback: upstream psxsplash has an
    else { render all rooms } when the camera is outside any room.
    Hid the feature during testing. Local patch removes the fallback;
    tracker entry filed for upstream consideration.

📦 Splashpack format v22

Bumped from v21 (no compat shim — old splashpacks fail the version
assert). Header tail +8 bytes for music table count + offset. New
section: 24-byte MusicTableEntry rows pointing at PS1M blobs.

Full layout: docs/splashpack-format.md.
PS1M blob layout: docs/sequenced-music-format.md.

If you were on the previous snapshot, re-build the runtime
binary (or grab the runtime zip below) so it matches the exporter.
The two drift apart silently otherwise.


📂 What's in each download

PS1Godot-plugin-<version>.zip (≈1 MB)

Drop into your Godot .NET project's addons/ folder.

  • All custom nodes: PS1Scene, PS1MeshInstance, PS1SkinnedMesh,
    PS1Camera, PS1Player, PS1AudioClip, PS1MusicSequence,
    PS1MusicChannel, PS1TriggerBox, PS1UICanvas, PS1UIElement,
    PS1Animation, PS1Cutscene, PS1Room, PS1PortalLink,
    PS1NavRegion, PS1Theme
  • Splashpack exporter (C#, targets format v22)
  • MIDI parser + PS1M serializer
  • PS1 spatial shader + compositor effect for the in-editor look
  • Dockable panel with scene-budget bars + one-click Run-on-PSX
  • PS1Lua GDExtension (prebuilt Windows x86_64 DLL included)
  • UI prefab templates (dialog box, menu list, HUD bar, toast)

psxsplash-runtime-<version>.zip (≈2 MB)

Drop psxsplash.ps-exe into godot-ps1/build/.

Prebuilt MIPS binary of psxsplash with our local patches applied
(music sequencer, voice reservation, v22 format, portal-culling
safety-fallback removed). Saves you from installing the MIPS
toolchain if you just want to try the demo or author content.

The runtime and the exporter must stay in lock-step on splashpack
format. If you upgrade one, upgrade the other.


🎯 Known limitations

  • Windows-only launch scripts (scripts/*.cmd). Linux/macOS should
    work — all the tooling is cross-platform — but the bootstrap
    scripts are .cmd. PRs welcome.
  • GDExtension binary ships only for Windows x86_64. Linux / macOS
    / ARM users have to rebuild from addons/ps1godot/scripting/ with
    SCons + godot-cpp. Tracked for future releases.
  • Non-flat nav regions (ramps, stairs with variable slope) still
    only partially handled; DotRecast auto-gen is the big gap. Phase 2
    bullet 7.
  • MIDI CC events (volume / pan / expression / pitch bend) are
    parsed but ignored. Authored mix automation doesn't translate
    through to runtime yet — per-track mix is set on the binding
    resource instead.
  • Tooling has sharp edges. The MIDI / sample workflow is
    functional but bare; see ROADMAP.md § Music
    authoring experience for the Tier 1 → 3 polish plan.

📚 Where to go next


🙏 Credits

Built on psxsplash (the
PS1-side runtime — consumed mostly unchanged, patches tracked in
docs/psxsplash-improvements.md), PCSX-Redux
(emulator + toolchain host), Godot
(editor platform), and a chunk of code directly inspired by
SplashEdit's Unity
exporter architecture. Tex-pack / VRAM / BVH ports follow the
SplashEdit file structure closely.

Demo song "RetroAdventureSong" composed by the project author. Sample
bank: Mitch's Music Kit (used for the test demo only — not
redistributed in the plugin zip).

🤖 Disclosure: the sequenced music pipeline, the runtime patches,
most of the new exporter code, and this release write-up were built
with Claude Code over a single extended session. The demo MIDI is
genuinely human-authored. Archi...

Read more