Satie · InstallWorldsby Attractor Labs

Satie in Godot

Export the scene and recordings, then let Godot’s audio players follow your nodes and gameplay.

Headless Godot 4.5 tested

Read as Markdown

1. Export into the project

  1. Ask your coding agent to use satie_setup for godot, inspect the scene, compose and realize the audio.
  2. Have the agent call satie_export with engine set to godot. Run the returned download commands as written; they create satie/scene.json, satie/satie.gd and satie/audio/.
  3. Add satie/satie.gd as an autoload named Satie. Open the project in the editor once so the recordings are imported before exporting a build.

project.godot · autoload section

[autoload]
Satie="*res://satie/satie.gd"

2. Bind nodes and send events

Hosts bind by node name under the current scene. Use bind for a different name. The calls below belong in the corresponding gameplay callbacks, with names declared by your scene.

GDScript

Satie.bind("door", $Door)
Satie.fire("door_open", $Door.global_position)
Satie.set_host_surface("player", "gravel")
Satie.host_event("player", "step")
Satie.signal_value("engine_load", 0.7)
Satie.state("combat")

What the export carries

The loader plays positioned sources through AudioStreamPlayer3D and beds through AudioStreamPlayer. It carries recordings, hosts, distance levels, recurrence, events, surface banks, states and supported follow bindings.

This placement export does not carry Satie rooms/reverb, occlusion, per-voice effects, paths, entities or the editor mixer. Add Godot reverb zones where needed and review notCarried in the export. To change the authored scene, export it again. Headless checks on Godot 4.5 cover a 19-voice scene; they do not replace listening in your game.

Integration reference

Support and validation

Godot 4.5 headless checks with a 19-voice scene; listening in the game remains necessary.

Carries recordings, hosts, distance, recurrence, events, surfaces, states and supported follow bindings. Rooms/reverb, occlusion, per-voice effects, paths, entities and the editor mixer are not carried. Review notCarried and add Godot reverb zones as needed.

Not yet validated: Other Godot versions and shipping devices