MCP: o Gomo Sounds no seu assistente de IA

Quanto do jogo já tem som (o que vai pro jogo), em % e por aba, e cada evento que falta com o id. O assistente chama no fim e pergunta se completa o resto.

Busca entidades pelo nome, jogo, evento ou descrição (sem diferenciar acento) e devolve tudo de cada uma: imagem, eventos, cada variação com id, descrição usada, duração, custo, se é a escolhida e a URL do áudio. Acha também os eventos de pasta (música, ambiente, interface), pelo nome, pela descrição ou pela pasta.

A ficha completa de uma entidade pelo id.

Jogos da conta, com quantas entidades, eventos e sons cada um tem, o saldo de créditos, o preço por segundo dos sons (creditsPerSecond) e o preço por minuto da música por nível de qualidade, com a duração máxima do seu plano.

As entidades de um jogo, com quantos eventos já têm som escolhido.

A biblioteca de vozes pras falas dos personagens: cada voz com o nome, de quem é (homem, mulher, menino, menina), o jeito (personagem ou narração), a descrição, os tons que tem (coloquial, conversa, formal) e as amostras pra ouvir. Também as emoções, os idiomas (português e inglês), o tamanho máximo da fala e o preço.

Pastas e subpastas do jogo, com os eventos que as entidades de dentro herdam: duração, loop e, na música, o que está salvo no Compor (modo, estilo, andamento, tom, partes).

O guia completo do assistente: todas as regras (como funcionam jogo, pastas, sons e versões (e a etiqueta de cada coisa do jogo), duração e custo, o sim antes de gastar, Godot, links). O assistente lê no começo de cada conversa, porque alguns apps cortam as instruções do servidor.

Cria um jogo. É o primeiro passo: já nasce com as pastas Ambiente, Efeitos sonoros e Interface. sound_direction é o estilo que toda geração segue; template acrescenta pastas por gênero (strategy, platformer, board, puzzle).

Cria várias músicas de uma vez na pasta Músicas (ou numa subpasta dela), de graça, sem gerar: nome, texto, duração, loop e o formulário da tela (estilo, partes, andamento, tom, compasso, voz), que já aparece no site; o estilo e a voz entram como palavras no texto. Música que já existe é atualizada com o que vier. Devolve a página de cada música e quanto custa gerar cada uma e o lote, por nível de qualidade.

Cria UMA fala (o que um personagem diz) num jogo, na pasta Vozes (o jogo novo já nasce com ela; o antigo ganha na primeira fala), no idioma do jogo. Recebe o nome, o texto exato, o idioma (o do jogo, se omitido), a voz, o tom e a emoção. De graça: ainda não gera nada.

Cria uma entidade: uma coisa do jogo que faz barulho (unidade, construção, bloco, objeto, botão, tela). Ações como Desfazer ou Fase concluída não são entidades, são eventos. Dentro de uma pasta, ela herda os eventos da pasta.

Cria um evento numa entidade (entity_id) ou numa pasta (folder_id). O nome é o que acontece (Mover, Atacar, Clique), nunca "Som": o jogo chama o som por esse nome. Ações sem dono vão na pasta Interface. loop é obrigatório: true pro que se repete enquanto algo acontece (ambiente, música, motor, fogo e movimentos como passos, corrida e asas; passos são um ciclo de 6 a 10 s), false pra uma ação só (golpe, clique, grito), com no mínimo 2 s. O servidor recusa som único abaixo de 2 s e loop abaixo de 6 s.

Apaga um som ou uma música de vez, com as versões, como o botão Apagar do site. Só quando você pede, e o nome confere (um id trocado não apaga o som errado). Versão favorita ou escolhida em outro som fica lá; com geração andando, espera terminar.

A direção de som do jogo (game_id) ou de uma pasta (folder_id): o estilo que toda geração de lá segue.

Cria uma pasta no jogo, em qualquer aba (section: ambience, effects, interface, music) ou dentro de outra pasta, opcionalmente já com entidades. Ambiente por lugar, interface por tela, efeitos por tipo de coisa.

Move entidades pra uma pasta. Sem folder_id, tira da pasta.

public aparece na galeria Explorar; private só o dono vê (exige plano pago).

O mesmo assistente do "Quero refinação máxima!" do site: do nome e do "como é o jogo" (gênero, mundo, tom, estilo de som, câmera, o que tem no jogo) saem a descrição, a direção de som e as pastas de cada aba com os eventos. Nada é criado: você revisa e o create_game cria.

Um som por entidade de uma pasta (ex.: Passos pra cada unidade). '{entity}' e '{description}' no prompt viram o nome e a descrição de cada uma. loop é obrigatório, como no create_event. Sem max_credits só mostra a lista e o custo; com max_credits igual ao custo, cria os eventos e gera. Evento sem som escolhido fica com todas as variações novas escolhidas. Aceita channels, como o generate_sounds.

Gera variações pro evento. Gasta créditos: segundos × preço por segundo × variações. Sem prompt, usa a descrição do evento. Se o evento ainda não tem som escolhido, todas as variações novas ficam escolhidas e o jogo sorteia uma (auto_choose=false desliga); escolha que você já fez não muda. channels: auto (mono pro que o jogo posiciona, estéreo nos fundos de Ambiente e em música), mono ou stereo; fica guardado no evento.

Gera UMA versão de música pra um evento da aba Música: o texto vai pro gerador exatamente como foi escrito (em inglês, palavras separadas por vírgula: estilo, clima, instrumentos, andamento), a duração, o loop, o nível de qualidade (rascunho ao máximo, com preço por minuto) e instrumental ou com letra. Também o modo Compor (partes, andamento, tom, compasso, estilo, voz); o estilo e a voz viram palavras no próprio texto. Espera até 10 minutos; com wait=false só põe na fila e devolve o id pro job_status (pra várias músicas: a conta gera uma por vez e as outras esperam a vez). Antes da primeira música, a pessoa aceita o aviso de direitos no site.

Uma versão nova a partir de outra: regera só um trecho (repaint, com início e fim em segundos), estende (extend, com os segundos a mais) ou gera uma parecida (cover, com o quão perto). Cobra os segundos gerados no nível da versão de origem; a letra, o andamento e o tom são os da origem, e a nota entra no fim do texto dela como foi escrita.

Onde estão as gerações: os ids do generate_music/derive_music com wait=false (ou, sem ids, todas as da conta que ainda não terminaram). Cada uma está esperando a vez, na fila do motor, gerando, pronta (com as versões novas, escolhidas se o som não tinha nenhuma) ou com erro (o motivo; falha não cobra).

Gera de 1 a 4 versões de uma fala. Gasta créditos: os segundos estimados da fala (caracteres ÷ caracteres por segundo, no mínimo 1 s) × preço por segundo × versões, com o mesmo "sim" ao custo do generate_sounds. As versões nunca são escolhidas sozinhas: você ouve no site e escolhe as que vão pro jogo.

Marca a variação escolhida. mode: add (junta às escolhidas), remove (tira), only (só ela).

Usa a mesma variação em outros eventos (event_ids), ou em todos com o mesmo nome (same_name), sem gerar de novo.

Registra o seu sim pro gasto: vale até gastar o total, por até 6 horas (um lote inteiro de músicas cabe num sim só). O assistente mostra o plano com o total ("Posso gerar isso por 63 créditos?") e só chama depois da sua resposta; sem ela, gerar é recusado. No plugin, o botão Gerar não precisa disso.

Devolve um link pra baixar um áudio da SUA conta (a audio URL de find_sounds ou get_entity). O link abre em qualquer navegador por 24 horas, sem entrar na conta. Sons do Explorar são de outras pessoas e não saem pelo MCP: baixe pelo site (de graça, com conta) ou gere os seus.

Devolve o link do .zip com os sons escolhidos do jogo e o manifest.json. O link abre em qualquer navegador por 24 horas.

Pro plugin da engine: os sons escolhidos do jogo no formato neutro (manifest.json), cada um com o link de download (24 horas) e o caminho sugerido no projeto.

Pro plugin da engine: manda as cenas do projeto (até 20 por vez) pra Entrada do jogo. Cena que já é entidade só atualiza a imagem; mandar de novo não duplica.

Pro plugin da engine: avisa o site que os sons escolhidos acabaram de ser instalados no projeto.

O kit pra pôr o plugin do Godot no projeto: versão atual, se o plugin conectado está em dia (o assistente confere antes de pedir pra sincronizar ou instalar), link do .zip, pasta, se o plano permite conectar e os passos. O assistente baixa e extrai (com o seu ok, sem apagar nada); você ativa o plugin, conecta e clica em Sincronizar.

O que o plugin mandou do projeto: quando foi a última sincronização, as cenas que esperam na Entrada (com a aba sugerida pelo caminho) e as que já são entidades. O assistente confere aqui que a sincronização chegou.

Põe as cenas da Entrada numa aba, igual a arrastar no site: automático (pelo caminho da cena no projeto) ou numa aba e pasta escolhidas. Cada cena vira uma entidade pronta pra receber eventos.

Aceita os Termos de Uso e a Política de Privacidade vigentes, como o botão do site. Quando os Termos mudam, o assistente pergunta se você aceita (com os links) e só chama depois do seu sim.