Plugin do Godot

1. Baixe o plugin e extraia o .zip na raiz do projeto: ele vai pra addons/gomo_sounds.
2. No Godot: Projeto → Configurações do Projeto → Plugins e ative Gomo Sounds.
3. O painel Gomo Sounds aparece à direita, e o plugin registra o autoload SfxLibrary (é ele que toca os sons no jogo).

Com um assistente de IA conectado ao MCP (Claude Code, Cursor...), peça "instala o plugin do Gomo Sounds no projeto": ele baixa e extrai o .zip pra você (depois do seu ok, sem apagar nada) e diz o que falta fazer no editor: ativar, conectar e sincronizar. Nunca apague a pasta addons com o editor aberto: o plugin carregado perde os próprios arquivos e o site recusa a sincronização.

Conectar

No painel, clique em Conectar. O navegador abre no site com um código (do tipo ABCD-EFGH): confira se é o mesmo do painel e aprove. O editor nunca pede a sua senha, e a chave fica guardada só no seu computador (nas configurações do editor, fora do repositório). O código vale por 10 minutos.

O projeto se liga a um jogo do site que você escolhe na lista Jogo do painel. O painel abre sem jogo escolhido e não escolhe nada sozinho; ainda não tem o jogo? Clique em Criar o jogo no painel (ele leva o nome do projeto) ou crie no site e clique em recarregar. O id do jogo fica no project.godot, então quem clonar o repositório já cai no mesmo jogo.

1. Enviar cenas

O plugin procura as cenas (.tscn) em pastas como units, characters, enemies, buildings e entities (se nenhuma existir, o projeto inteiro). Você marca quais mandar e clica em Sincronizar selecionadas. As cenas novas chegam na Entrada do jogo no site (o selo do Godot no topo da tela do jogo), pra você pôr nas pastas.

Ficam de fora: a pasta addons, pastas de efeitos, peças e interface (effects, vfx, components, models, ui...), as cenas "base" que outras herdam e, por padrão, as que já têm som (um AudioStreamPlayer ou um arquivo de áudio).

2. Fazer os sons

Com as cenas no site, crie os sons de cada uma (Atacar, Morrer, Passos...) e gere: pelo painel no editor (escolha o som, descreva e clique em Gerar) ou pelo site, onde também dá pra editar, cortar e ouvir tudo junto no Estúdio. Gerar gasta créditos; escolher e instalar não.

3. Instalar no projeto

Clique em Instalar sons escolhidos. O plugin mostra o que vai mudar (novos, atualizados, movidos, apagados) antes de mexer em qualquer arquivo. Onde os sons ficam:

Pasta do Gomo (recomendado)	res://gomosounds/<entidade>/<evento>.wav
Uma pasta sounds ao lado da cena	<pasta da cena>/sounds/<cena>_<evento>.wav
Ao lado da cena	<pasta da cena>/<cena>_<evento>.wav
Outro lugar	<pasta escolhida>/<entidade>/<evento>.wav

• Mais de uma versão escolhida: a primeira fica sem número e as outras ganham _2, _3...
• Sons sem cena (Interface, Ambiente, sons de pasta) vão sempre pra pasta principal.
• O plugin nunca apaga nem sobrescreve um arquivo que não foi ele que escreveu, ou que você editou (a não ser que você marque pra substituir).
• Um catálogo (gomo_sounds.tres) guarda o que foi instalado; mover os arquivos dentro do Godot não quebra nada.

Tocar no jogo

O autoload SfxLibrary acha o som pela cena do nó e pelo nome do evento (sem diferença de maiúsculas e acentos). Em Node3D o som é 3D, em Node2D é 2D, e fora disso toca como som de interface. O som continua tocando mesmo se o nó for apagado (uma morte, por exemplo).

# o evento "Ataque" da cena deste nó
SfxLibrary.play_event(self, "Ataque")

# o primeiro que existir
SfxLibrary.play_first(self, ["Disparo de Arma", "Ataque"])

# um som em loop que segue o nó (passos, motor)
var passos := SfxLibrary.attach_event(self, "Caminhar")
SfxLibrary.stop(passos)

# um som da Interface, pela chave
SfxLibrary.play("@interface/buttons.click", self)

Também existem has_event(node, nome) pra saber se o evento tem som e reload_catalog() pra recarregar depois de instalar com o jogo aberto.

Exportar o jogo

Ao exportar com um preset que leva só as cenas ou recursos escolhidos, o plugin acrescenta sozinho o catálogo e os sons importados. Com "todos os recursos", nada muda.

Linha de comando

Pra integração contínua, o plugin roda sem o editor, com a chave numa variável de ambiente:

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

O que sai do projeto

• Vai pro site: o nome e a descrição de cada cena marcada, uma miniatura pequena, o caminho da cena e o nome do projeto.
• Nunca sai do projeto: os seus sons, scripts, modelos e texturas, e as cenas que você não marcou.

Novidades do plugin