Repository navigation
v0.5.0 — Linux + macOS support
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.pyreplaces 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, thenshutil.which-style PATH
probes. MIPS toolchain auto-detectsmipsel-none-elf-gcc(Windows /
macOS) ORmipsel-linux-gnu-gcc(Linux apt) and passes the matching
PREFIX=...to make. - Parallel
.cmd+.shshims. Every action keeps its native-feel
shortcut:scripts\build-psxsplash.cmdon Windows,./scripts/build-psxsplash.sh
on Linux/macOS. Both are one-line wrappers aroundpython scripts/run.py. - PS1Godot dock dispatches via Python.
PS1GodotPlugin.RunScript- the two
OS.CreateProcesslaunch sites now invoke
python(3) scripts/run.py <action>instead ofcmd.exe /c ....
Drops the hardcoded\path conversions; in-editor Build / Launch
buttons work identically across platforms.
- the two
- GDExtension Linux + macOS targets.
ps1lua.gdextensiondeclares
linux.*.x86_64(.so) andmacos.*(.framework) entries.
Local SCons builds for either platform are picked up automatically;
CI matrix produces them on every push. build-release.pypackages both psxsplash variants. PCdrv +
CDROM.ps-exe(and matching.elfdebug 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 parallelplugin-csharpjob runsdotnet buildon
every OS to catch C# regressions on platforms we don't usually
develop on. - Docs reformatted for three platforms.
README.mdadds the
Platforms: Windows / Linux / macOSline near the top.QUICKSTART.md
drops the Windows-only caveat; the "install the four tools" section
has per-OS install commands.SETUP.mdprerequisites table grows
Windows / Linux / macOS columns; the env-var defaults table lists
per-OS fallback paths.
Behaviour changes
scripts/*.cmdfiles 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 intoscripts/run.py
alongside the existing actions.launch-editorkeeps the cmd window open viapauseon
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..gitattributespins line endings:.shand.pyalways LF,
.cmdalways 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:
- Wait for v0.5.1 which will include them in the plugin zip
(build-release.pyalready includes any binaries it finds in
scripting/build/), OR - Build locally:
cd godot-ps1/addons/ps1godot/scripting && scons platform=<linux|macos>,
then re-runpython 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 customisedscripts/*.cmd
shouldn't notice the change. - Forks with custom toolbar buttons that called
RunScript("scripts/foo.cmd", "Label")
need to migrate to action names. SeeOnBuildPsxsplash/OnBuildPsxsplashCdrom
for the pattern. - Python 3.10+ becomes a hard dependency for the launcher. Already
true viabuild_iso.py,gen_api_data.py, andbuild-release.py,
but now the in-editor Build button also fails without it. scripts/bootstrap-env.cmdno longer callssetx. Running it
prints resolved values and a per-OS hint at how to persist your own
overrides. Set env vars directly viasetx(Windows) or shell rc
(Linux/macOS).
Artifacts
PS1Godot-plugin-v0.5.0.zip— drop into your project at
addons/ps1godot/. Windows GDExtension.dllbundled; Linux / macOS
binaries see "What's not yet bundled" above.psxsplash-runtime-v0.5.0.zip— bothpsxsplash.ps-exe(PCdrv) and
psxsplash-cdrom.ps-exe(ISO) bundled with matching.elfdebug
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.