Author PlayStation 1 games in Godot.
Platforms: Windows ✓ · Linux ✓ · macOS ✓ (CI-built GDExtension lands per release; runtime + plugin build from source on all three.)
PS1Godot is a Godot 4.x editor plugin (C# / .NET) that lets you design PS1 scenes in Godot and export them to the psxsplash runtime, which runs on real PS1 hardware and in PCSX-Redux.
It is a Godot-native rethink of SplashEdit (Unity). Same binary format, different editor, deliberately better UX.
Phase 1 (in-editor PS1 preview): done. PS1 look (vertex snap, 2× color modulate, nearest filter, fog) renders in Godot's viewport. Stretch goals landed too: subdivision tool, texture compliance analyzer, low-res compositor preview, PS1Lua as a first-class Godot script language via GDExtension.
Phase 2 (splashpack exporter MVP): in progress, bullets 1–6, 8, 9, 10,
11, and 12 (MVP) running on PSX. The Godot demo scene exports to a
valid splashpack, boots in PCSX-Redux, and plays: intro cutscene with
narrator + camera arc + cube zoom, third-person camera follows the
player, humanoid avatar tracks + turns with player input, interactive
cubes with branching dialog (audio-aware auto-hide), animated skinned
mesh, audio with per-clip residency, MIDI-driven sequenced background
music with per-channel pitch shifting and dialog ducking, multi-scene
teleport (Scene.Load), portal-culled interior scene, in-editor dock
with live scene-budget bars. Remaining Phase 2 bullets: 7 (nav beyond
flat). See ROADMAP.md.
What works right now
- PS1 spatial shader + default material, vertex jitter, fog
- Custom nodes:
PS1Scene,PS1MeshInstance,PS1SkinnedMesh,PS1Camera,PS1Player,PS1AudioClip,PS1TriggerBox,PS1UICanvas,PS1UIElement,PS1Animation,PS1Cutscene - Splashpack v22 exporter (meshes with bone weights, textures with
CLUT quantization, per-object colliders, flat nav regions,
source-text Lua scripts, ADPCM audio with Residency flags,
editor-driven camera + avatar rigs from
PS1Playerchild nodes, rooms + portals + tri-ref assignment for interior scenes, sequenced music tracks) - Skinned meshes with per-vertex rigid bone assignment + baked animation clips sampled at author-set FPS
- First-person / third-person camera mode switching via
Camera.SetMode()Lua API - Sequenced music: drop a
.mid+ sample-bank WAVs into the scene, bind each MIDI channel to an instrument sample (with per-note routing for drum kits), and play viaMusic.Play("name"). Voice reservation keeps dialog from stealing music notes; dialog scripts auto-duck the bed while voice clips play. PS1M binary format documented indocs/sequenced-music-format.md. - Multi-scene support:
Scene.Load(N)swaps to additional scenes packed alongside the main one (boss arenas, dream realms, region transitions) - Cutscene authoring with multi-track timelines (camera position + rotation, object position, audio events) — runtime camera follows the authored arc, hands back to the player rig cleanly at the end
- Runtime
\nword-wrap for dialog and narrator text;Audio.GetClipDurationlets dialog scripts auto-hide the box once the voice clip actually finishes (instead of a fixed timeout) - Dockable PS1Godot panel with triangle/VRAM/SPU budget bars, dependency-detection setup section, and primary Run-on-PSX CTA
- PS1 UI prefab templates (
dialog_box,menu_list,hud_bar,toast) authored as drop-in.tscnscenes - One-click PS1Godot: Run on PSX (export + launch PCSX-Redux)
- PS1Lua script language in Godot's Create Script dropdown
What doesn't yet
- Non-trivial nav regions (DotRecast port or manual polygon auth, Phase 2 bullet 7)
- MIDI CC parsing for music — volume/pan/expression/pitch-bend events in the source MIDI are read but ignored. Per-channel mix is set on the binding resource instead.
- Cell subdivision + per-room portal-ref lists for the room/portal renderer (runtime falls back to "render all of a room's tri-refs" cleanly without them)
- WYSIWYG UI canvas editor, dialog tree editor, MIDI event-marker authoring (Phase 3 § UI authoring experience)
- F5-to-play binding, VRAM viewer dock, project templates (Phase 3)
- Phase 0.5 install-buttons on the setup dock
- Zero-setup
PS1Godot.zipdrop (Phase 4)
- Set up your environment →
docs/getting-started/installation.md - Run the bundled demo →
docs/getting-started/quickstart.md - Walk through your first scene →
docs/getting-started/first-scene.md - Understand the pipeline →
CLAUDE.md - See what's next →
ROADMAP.md
Rendered docs: https://buffjesus.github.io/PS1Godot/.
The reference source trees (godot-master/, pcsx-redux-main/,
splashedit-main/) are not included in this repo — clone them
separately if you want to read them. Only psxsplash-main/ is vendored,
because we carry local patches against it (tracked in
docs/psxsplash-improvements.md).
PS1Godot/
├─ godot-ps1/ ← the Godot 4.x .NET project (open this in Godot)
│ ├─ addons/ps1godot/ ← plugin: nodes, shaders, exporter, PS1Lua GDExtension
│ └─ demo/ ← sample scene exercising the pipeline end-to-end
├─ psxsplash-main/ ← vendored PS1 runtime + our local patches
├─ scripts/ ← launch / build helpers (Python `run.py` + .cmd / .sh shims)
├─ docs/ ← format reference, tutorials, upstream-improvement tracker
├─ CLAUDE.md ← architecture + conventions (also loaded by Claude Code)
├─ GLOSSARY.md ← PS1 / PSYQo / splashpack vocabulary
├─ ROADMAP.md ← phased plan, Phase 2.5/2.6 stretch
└─ SETUP.md ← env setup walkthrough (Godot + MIPS toolchain + PCSX-Redux)
TBD. The vendored psxsplash-main/ keeps its upstream license
(psxsplash-main/LICENSE). Our original plugin + scripts + docs will be
declared before first public release.