Communitygithub.com

888wing/8bit-music-generator

Gerador determinista de música e efeitos sonoros 8-bit com semente, integrado como skill local para Codex.

O que é 8bit-music-generator?

Este skill fornece um script Node.js local (`scripts/chipgen.js`) que gera música e efeitos sonoros (SFX) no estilo 8-bit de forma determinística baseada em sementes numéricas. É ideal para desenvolvedores de jogos que precisam de assets de áudio procedurais e reproduzíveis diretamente no terminal, sem depender de serviços externos. O skill mapeia descrições em linguagem natural para parâmetros de geração (humor, tom, compassos, BPM) usando regras bem definidas. Suporta geração de faixas individuais, pacotes de música completos (com 6 faixas temáticas de uma mesma semente), e efeitos sonoros categorizados. Para projetos Godot, pode exportar diretamente recursos `AudioStreamRandomizer`. Funciona em qualquer plataforma que suporte Node.js 16 ou superior, incluindo Codex, Cursor e Claude Code. A saída inclui arquivos WAV, MIDI e stems, permitindo edição posterior. As sementes usadas são reportadas, garantindo reproducibilidade total dos resultados.

Funciona com~Claude Code✓Codex CLI✓Cursor
npx skills add 888wing/8bit-music-generator

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

  1. Resolva o diretório de saída. Se o usuário não especificar um, use generated-audio/ no projeto atual.
  2. 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.
  3. Execute node <caminho-skill>/scripts/chipgen.js list quando precisar de humores, tonalidades ou categorias de SFX válidos.
  4. Gere os assets solicitados. Use music-pack quando o usuário pedir um pacote de trilha sonora, conjunto de cenas ou "diferentes cenas mas mesmo estilo".
  5. 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 adventure para 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 battle para 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 boss para chefe, chefe final, batalha de rival, clímax, opressivo, demoníaco, alto risco, fim de jogo, raide ou "tornar mais intenso que batalha".
  • Use town para cidade, vila, loja, estalagem, base segura, zona segura, aconchegante, NPC amigável, artesanato, fazenda, BGM de menu leve ou cenas do cotidiano.
  • Use dungeon para 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 sad para 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, D ou E quando nenhuma tonalidade exata for especificada. Mapeie descrições brilhantes/heroicas/acolhedoras para C, F ou G. Use random quando 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 sad a menos que a emoção exija, ou defina sad próximo de 92 BPM.
  • Para BGM final ou pronto para produção, inclua --midi --stems. Para exploração, inclua --variants 5 a 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 coin para pegar, coletar, recompensa, gema, item adquirido, pontuação ou confirmar-positivo.
  • Use confirm para menu OK, aceitar, clique UI positivo, pequeno sucesso ou continuar diálogo.
  • Use cancel para voltar, negar, inválido, erro de UI, menu fechado ou feedback negativo.
  • Use jump para pulo, salto, quique, mola, movimento UI para cima ou elevação de personagem.
  • Use dash para investida, esquiva, movimento rápido, explosão de velocidade ou passo aéreo.
  • Use land para aterrissagem, pisão, passada pesada, toque no chão ou pequeno impacto corporal.
  • Use laser para tiro, projétil, zás, raio, lançamento de magia, blaster ou ataque mágico rápido.
  • Use slash para espada, lâmina, garra, golpe, corte, ataque corpo a corpo ou whoosh-golpe rápido.
  • Use hit para dano, soco, impacto, ferimento, inimigo atingido ou contato corporal.
  • Use block para escudo, parry, defesa, golpe em armadura, desvio ou impacto de metal/pedra.
  • Use explosion para explosão, quebra, colisão, explosão, destruição, barril, bomba ou grande impacto.
  • Use powerup para melhoria, subida de nível, desbloqueio, buff, cura, item raro, floreio de sucesso ou transformação.
  • Use heal para cura, restauração, poção, reviver, faísca mágica ou efeito positivo suave.
  • Use teleport para teletransporte, desaparecer, distorção, portal, renascer ou mudança de fase.
  • Use door para porta, interruptor, alavanca, portão, mecanismo, fechadura ou painel UI pesado.
  • Use chest para baú de tesouro, revelação de recompensa, fanfarra de item, abertura de saque ou pegar item raro.
  • Use blip para cursor de UI, movimento de menu, pequena seleção, digitação, notificação, bipe discreto ou feedback de interface neutro.
  • Use alert para aviso, alarme, detecção, exclamação, vida baixa ou perigo cronometrado.
  • Use fall para cair, falhar, derrubar, perder, resposta errada, transição para baixo ou vinheta de game over.
  • Use defeat para morte, jogador perdeu, game over, inimigo derrotado ou fracasso dramático.
  • Use whoosh para 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 recurso AudioStreamRandomizer do Godot.
  • --res-prefix PREFIX: Prefixo de recurso usado dentro do .tres do 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.

Habilidades Relacionadas