Skip to content

v0.5.0 — Linux + macOS support

Choose a tag to compare

@BuffJesus BuffJesus released this 19 May 02:41
· 92 commits to main since this release

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.