PS1Scene¶
Root node of a PS1 scene. Carries scene-wide settings — fog, player physics, audio clip list, music sequences, sub-scene array — that end up in the splashpack header.
Where it goes¶
The root of every scene that will export to PSX. One per
.tscn. The exporter walks down from this node; anything not
under a PS1Scene root won't make it into the splashpack.
To promote a fresh Node3D root: select root → Inspector → script
icon → Extends → PS1Scene.
Key fields¶
- Fog — color, near/far, density. The exporter stamps these into the splashpack header; the runtime applies them per-frame. Editor preview requires setting matching fog on the material (a Phase 1 limitation — Phase 1's subviewport work will auto-propagate scene fog to all PS1 materials).
- GteScaling — Godot units per PSX unit. Default
4. Affects how authored transforms map to PSX fixed-point coordinates at export time. - Player — height, radius, move speed, jump height, gravity.
Drives the runtime's CharacterController constants for whichever
PS1Playerends up in the scene. - AudioClips — array of
PS1AudioClipresources referenced by Lua and dialogue graphs. - MusicSequences — array of
.midreferences for sequenced BGM. - SubScenes — array of
.tscnreferences loadable viaScene.Load(N)from Lua.
Hover any field for the in-Inspector tooltip with field-by-field guidance.
Workflows¶
- A
PS1Scenewith no other PS1 nodes still exports cleanly (empty scene). Use this to verify the exporter is healthy before troubleshooting a complex scene. - Sub-scenes are independent
.tscnfiles referenced via theSubScenesarray. They package alongside the main scene in the splashpack but only load whenScene.Load(N)fires.
Related¶
- PS1Godot panel — Run-on-PSX
exports from the active
PS1Scene. reference/splashpack-format.md— what the scene becomes on disk.