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.