Godot plugin

1. Download the plugin and extract the .zip into the project root: it goes to addons/gomo_sounds.
2. In Godot: Project → Project Settings → Plugins and enable Gomo Sounds.
3. The Gomo Sounds dock shows up on the right, and the plugin registers the SfxLibrary autoload (that's what plays sounds in the game).

With an AI assistant connected to the MCP (Claude Code, Cursor...), ask it to "install the Gomo Sounds plugin in the project": it downloads and extracts the .zip for you (after your ok, deleting nothing) and tells you what is left to do in the editor: enable, connect and sync. Never delete the addons folder with the editor open: the loaded plugin loses its own files and the site refuses the sync.

Connect

In the dock, click Connect. The browser opens the site with a code (like ABCD-EFGH): check it matches the dock and approve. The editor never asks for your password, and the key is stored only on your computer (in the editor settings, outside the repository). The code lasts 10 minutes.

The project links to a game on the site that you pick in the dock's Game list. The dock opens with no game picked and never picks one on its own; no game yet? Click Create the game in the dock (it takes the project's name) or create it on the site and click reload. The game id is saved in project.godot, so anyone who clones the repository lands on the same game.

1. Send scenes

The plugin looks for scenes (.tscn) in folders like units, characters, enemies, buildings and entities (the whole project if none exists). Tick the ones to send and click Sync selected. New scenes land in the game's Inbox on the site (the Godot badge at the top of the game screen), for you to place in folders.

Left out: the addons folder, effect, part and UI folders (effects, vfx, components, models, ui...), "base" scenes other scenes inherit from and, by default, scenes that already have sound (an AudioStreamPlayer or an audio file).

2. Make the sounds

With the scenes on the site, create each one's sounds (Attack, Die, Footsteps...) and generate them: from the dock in the editor (pick the sound, describe it and click Generate) or on the site, where you can also edit, trim and hear everything together in the Studio. Generating costs credits; picking and installing don't.

3. Install into the project

Click Install chosen sounds. The plugin shows what will change (new, updated, moved, deleted) before touching any file. Where the sounds go:

Gomo folder (recommended)	res://gomosounds/<entity>/<event>.wav
A sounds folder next to the scene	<scene folder>/sounds/<scene>_<event>.wav
Next to the scene	<scene folder>/<scene>_<event>.wav
Custom location	<chosen folder>/<entity>/<event>.wav

• More than one chosen version: the first has no number and the others get _2, _3...
• Sounds with no scene (Interface, Ambience, folder sounds) always go to the main folder.
• The plugin never deletes or overwrites a file it didn't write, or one you edited (unless you tick replace).
• A catalog (gomo_sounds.tres) records what was installed; moving files inside Godot doesn't break anything.

Play in the game

The SfxLibrary autoload finds the sound from the node's scene and the event name (ignoring case and accents). On a Node3D the sound is 3D, on a Node2D it's 2D, otherwise it plays as a UI sound. The sound keeps playing even if the node is freed (a death, for example).

# the "Attack" event of this node's scene
SfxLibrary.play_event(self, "Attack")

# the first one that exists
SfxLibrary.play_first(self, ["Gun Shot", "Attack"])

# a looping sound that follows the node (footsteps, engine)
var steps := SfxLibrary.attach_event(self, "Walk")
SfxLibrary.stop(steps)

# an Interface sound, by key
SfxLibrary.play("@interface/buttons.click", self)

There's also has_event(node, name) to check whether an event has sound and reload_catalog() to reload after installing with the game running.

Exporting the game

When exporting with a preset that includes only selected scenes or resources, the plugin adds the catalog and the imported sounds by itself. With "all resources", nothing changes.

Command line

For continuous integration, the plugin runs without the editor, with the key in an environment variable:

GOMO_API_KEY=gomo_... godot --headless --path . \
  -s addons/gomo_sounds/tools/sfx_cli.gd -- sync

GOMO_API_KEY=gomo_... godot --headless --path . \
  -s addons/gomo_sounds/tools/sfx_cli.gd -- install

What leaves the project

• Sent to the site: the name and description of each ticked scene, a small thumbnail, the scene path and the project name.
• Never leaves the project: your sounds, scripts, models and textures, and the scenes you didn't tick.

What's new in the plugin