Chipgen
Use o script Node.js incluso para gerar música e efeitos sonoros 8-bit determinísticos localmente. Requer Node.js 16 ou superior.
O script está em scripts/chipgen.js relativo à pasta deste skill. Execute-o com node e capture a saída padrão como JSON. Erros são escritos na saída de erro padrão (stderr).
Use terminologia em português para novas funcionalidades, manifestos gerados e resumos voltados ao usuário. Mantenha o suporte a Chinês Tradicional como idioma secundário ao editar a interface do navegador.
Fluxo de Trabalho
- Resolva o diretório de saída. Se o usuário não especificar um, use
generated-audio/no projeto atual. - Escolha os parâmetros a partir da solicitação do usuário usando as regras de descrição-para-parâmetros abaixo. Se uma semente não for fornecida, escolha uma e informe-a para que o resultado possa ser reproduzido.
- Execute
node <caminho-skill>/scripts/chipgen.js listquando precisar de humores, tonalidades ou categorias de SFX válidos. - Gere os assets solicitados. Use
music-packquando o usuário pedir um pacote de trilha sonora, conjunto de cenas ou "diferentes cenas mas mesmo estilo". - Leia o manifesto JSON da saída padrão e informe os caminhos dos arquivos gerados, semente, humor/categoria, BPM e quaisquer saídas MIDI/stems/tres.
Descrição-para-Parâmetros
Infira parâmetros a partir de descrições de áudio de jogo em linguagem natural. Prefira uma primeira abordagem razoável a fazer perguntas, a menos que a solicitação tenha restrições incompatíveis.
Seleção de humor musical
- Use
adventurepara mundo aberto, jornada, abertura, exploração, heroico, esperançoso, brilhante, tela de título, mapa, descoberta, floresta, céu, mar ou BGM geral de plataforma. - Use
battlepara combate regular, perseguição, perigo, ação, desafio cronometrado, ondas de inimigos, intensidade arcade rápida ou jogabilidade tensa que não seja uma luta contra chefe. - Use
bosspara chefe, chefe final, batalha de rival, clímax, opressivo, demoníaco, alto risco, fim de jogo, raide ou "tornar mais intenso que batalha". - Use
townpara cidade, vila, loja, estalagem, base segura, zona segura, aconchegante, NPC amigável, artesanato, fazenda, BGM de menu leve ou cenas do cotidiano. - Use
dungeonpara caverna, ruínas, mistério, furtividade, labirinto, noite, esgoto, laboratório, alienígena, assombrado, subaquático, neve/gelo quando a descrição disser solitário/frio/misterioso em vez de trágico. - Use
sadpara perda, game over, memória, final, lar destruído, despedida, morte, solidão, melancolia, cena emocionante ou neve/gelo quando a descrição for explicitamente triste.
Quando uma descrição misturar humores, escolha primeiro a função da jogabilidade, depois a emoção. Exemplo: "batalha de chefe triste" deve ser boss; "fase de neve solitária mas não muito lenta" deve ser geralmente dungeon com um BPM na faixa superior, não sad.
Tonalidade, compassos e BPM
- Use solicitações explícitas de tonalidade diretamente. Mapeie descrições "menor" para
A,DouEquando nenhuma tonalidade exata for especificada. Mapeie descrições brilhantes/heroicas/acolhedoras paraC,FouG. Userandomquando o usuário quiser surpresa ou não der direção tonal. - Use 8 compassos para prévias rápidas, loops curtos, vinhetas ou muitos candidatos. Use 16 compassos para BGM de loop normal. Use 32 compassos para pedidos de ambiente/fundo mais longos.
- Se o BPM não for especificado, deixe o gerador escolher dentro da faixa do humor. Se o usuário pedir mais rápido/mais lento, defina o BPM próximo ao topo/base da faixa de humor selecionada. Se o usuário disser "não muito lento", evite
sada menos que a emoção exija, ou definasadpróximo de 92 BPM. - Para BGM final ou pronto para produção, inclua
--midi --stems. Para exploração, inclua--variants 5a menos que o usuário peça um único resultado.
Seleção de pacote de música
Use music-pack quando a solicitação pedir uma trilha sonora pequena completa, um pacote de cenas, um conjunto de cues ou música para várias cenas de jogo em um estilo coerente.
music-pack gera seis cues de uma família de sementes e uma tonalidade resolvida:
- Tema:
adventure, 16 compassos - Cidade:
town, 16 compassos - Dungeon:
dungeon, 16 compassos - Batalha:
battle, 8 compassos - Chefe:
boss, 16 compassos - Final:
sad, 8 compassos
Isso não é o mesmo que --variants. Variantes mantêm uma cena fixa e alteram apenas as sementes derivadas. Um pacote de música muda a função da cena enquanto mantém o centro tonal e a família de sementes coerentes.
Seleção de categoria SFX
- Use
coinpara pegar, coletar, recompensa, gema, item adquirido, pontuação ou confirmar-positivo. - Use
confirmpara menu OK, aceitar, clique UI positivo, pequeno sucesso ou continuar diálogo. - Use
cancelpara voltar, negar, inválido, erro de UI, menu fechado ou feedback negativo. - Use
jumppara pulo, salto, quique, mola, movimento UI para cima ou elevação de personagem. - Use
dashpara investida, esquiva, movimento rápido, explosão de velocidade ou passo aéreo. - Use
landpara aterrissagem, pisão, passada pesada, toque no chão ou pequeno impacto corporal. - Use
laserpara tiro, projétil, zás, raio, lançamento de magia, blaster ou ataque mágico rápido. - Use
slashpara espada, lâmina, garra, golpe, corte, ataque corpo a corpo ou whoosh-golpe rápido. - Use
hitpara dano, soco, impacto, ferimento, inimigo atingido ou contato corporal. - Use
blockpara escudo, parry, defesa, golpe em armadura, desvio ou impacto de metal/pedra. - Use
explosionpara explosão, quebra, colisão, explosão, destruição, barril, bomba ou grande impacto. - Use
poweruppara melhoria, subida de nível, desbloqueio, buff, cura, item raro, floreio de sucesso ou transformação. - Use
healpara cura, restauração, poção, reviver, faísca mágica ou efeito positivo suave. - Use
teleportpara teletransporte, desaparecer, distorção, portal, renascer ou mudança de fase. - Use
doorpara porta, interruptor, alavanca, portão, mecanismo, fechadura ou painel UI pesado. - Use
chestpara baú de tesouro, revelação de recompensa, fanfarra de item, abertura de saque ou pegar item raro. - Use
blippara cursor de UI, movimento de menu, pequena seleção, digitação, notificação, bipe discreto ou feedback de interface neutro. - Use
alertpara aviso, alarme, detecção, exclamação, vida baixa ou perigo cronometrado. - Use
fallpara cair, falhar, derrubar, perder, resposta errada, transição para baixo ou vinheta de game over. - Use
defeatpara morte, jogador perdeu, game over, inimigo derrotado ou fracasso dramático. - Use
whooshpara movimento aéreo, preparação de balanço, transição, passagem rápida ou movimento abstrato.
Para SFX de jogabilidade repetidos, gere --variants 5. Para sons de UI, gere 3-5 candidatos e mantenha durações curtas escolhendo blip, coin ou hit em vez de random.
Comandos
Listar valores suportados:
node <skill-dir>/scripts/chipgen.js list
Gerar BGM:
node <skill-dir>/scripts/chipgen.js music \
--mood battle \
--key A \
--bars 16 \
--seed 42 \
--stems \
--midi \
--out generated-audio/bgm
Gerar candidatos BGM de uma família de sementes:
node <skill-dir>/scripts/chipgen.js music \
--mood boss \
--key A \
--bars 16 \
--seed 42 \
--variants 5 \
--midi \
--out generated-audio/bgm
Gerar um pacote de música de seis cues:
node <skill-dir>/scripts/chipgen.js music-pack \
--key C \
--seed 42 \
--stems \
--midi \
--out generated-audio/bgm-pack
Gerar um SFX:
node <skill-dir>/scripts/chipgen.js sfx \
--cat coin \
--seed 123 \
--out generated-audio/sfx
Gerar um pool de variações SFX para Godot:
node <skill-dir>/scripts/chipgen.js sfx \
--cat hit \
--seed 88 \
--variants 5 \
--tres generated-audio/sfx/hit_pool.tres \
--res-prefix res://assets/audio/sfx/ \
--out generated-audio/sfx
Parâmetros
Os humores suportados são adventure, battle, town, dungeon, sad e boss.
As categorias SFX suportadas são coin, confirm, cancel, jump, dash, land, laser, slash, hit, block, explosion, powerup, heal, teleport, door, chest, blip, alert, fall, defeat, whoosh e random.
Opções úteis:
--bpm N: Substituir BPM gerado.--bars N: Duração da música. Use 8, 16 ou 32 a menos que o usuário peça o contrário.--sr N: Taxa de amostragem. O padrão é 44100.--midi: Exportar MIDI para música.--stems: Exportar stems de música separados.--variants N: Gerar uma família de sementes. Para música, mantenha humor, tonalidade resolvida, compassos e BPM fixos enquanto deriva novas sementes. Para SFX, mantenha a categoria fixa.--no-mix: Pular WAV mixado.--no-normalize: Desabilitar normalização de SFX.--tres PATH: Escrever um recursoAudioStreamRandomizerdo Godot.--res-prefix PREFIX: Prefixo de recurso usado dentro do.tresdo Godot gerado.
Padrões
Para BGM pronto para jogo, prefira --stems --midi a menos que o usuário queira apenas uma prévia rápida.
Para exploração musical, gere 5-10 candidatos a partir de uma semente base. Na saída do CLI, variantIndex: 0 é a semente base e os itens posteriores usam variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0 com o índice começando em 1. Mantenha mood, key resolvida, bars e bpm fixos para que os candidatos pareçam relacionados em vez de aleatórios.
Para uma trilha sonora compacta de jogo, prefira music-pack --stems --midi. Ele produz cues de Tema, Cidade, Dungeon, Batalha, Chefe e Final a partir de uma família de sementes.
Para SFX destinados a reprodução repetida no jogo, prefira --variants 5 e mantenha a mesma categoria com diferentes variantes semeadas.
Para projetos Godot, use assets/audio/bgm e assets/audio/sfx quando esses diretórios existirem. Lembre ao usuário que as importações WAV do Godot podem precisar do modo de loop ativado para BGM em loop.