Skip to content

PS1 nodes

Custom nodes the plugin adds. Every node here is a Godot scene-tree node tagged for the splashpack exporter — they map one-to-one to data structures the runtime understands.

At a glance

Node Role Parent
PS1Scene Scene root Scene root
PS1MeshInstance Renderable mesh + collision anywhere
PS1SkinnedMesh Skinned mesh + bone animation anywhere
PS1Camera Initial camera transform child of PS1Scene
PS1Player Player spawn + camera rig child of PS1Scene
PS1Animation Named single-track timeline anywhere
PS1Cutscene Multi-track timeline anywhere
PS1AudioClip Audio resource with routing resource (not a node)
PS1TriggerBox World-space trigger volume anywhere
PS1UICanvas Screen-space UI layer child of PS1Scene
PS1Room Convex interior volume child of PS1Scene
PS1PortalLink Portal between two rooms child of PS1Scene
PS1Sky Background skybox child of PS1Scene

Not yet documented (live in godot-ps1/addons/ps1godot/nodes/): sound macros (PS1SoundMacro, PS1SoundFamily), per-channel music authoring (PS1MusicChannel, PS1MusicSequence, PS1Instrument, PS1DrumKit, PS1SampleRegion), nav (PS1NavRegion), UI layout helpers (PS1UIHBox, PS1UIVBox, PS1UIAnchor, PS1UISpacer, PS1UISizeBox, PS1UISlot, PS1UIOverlay, PS1UIModel, PS1UIElement, PS1UIFontAsset), themes (PS1Theme), animation primitives (PS1AnimationKeyframe, PS1AnimationTrack, PS1AudioEvent), and mesh helpers (PS1MeshGroup, PS1MaterialMetadata, PS1Backdrop).

Conventions

  • Hover tooltips on every Inspector field. /// doc-comments on the [Export] properties surface as Godot 4 tooltips — read those for field-by-field detail.
  • Defaults that just work. A freshly-added node renders / plays / collides correctly with no further configuration. Tweak only when you have a specific deviation in mind.
  • PS1 constraints are checked at export. PS1 Doctor warns about VRAM blowouts, missing required nodes, mismatched field combinations. Authoring is forgiving; export is strict.