Communitygithub.com

888wing/8bit-music-generator

시드 기반 8비트 음악 및 사운드 이펙트 생성기로, 로컬 Codex 스킬로 작동합니다.

8bit-music-generator란 무엇인가요?

이 스킬은 자연어 설명을 바탕으로 결정론적(deterministic) 8비트 배경 음악(BGM)과 사운드 이펙트(SFX)를 로컬에서 생성하는 Node.js 기반 도구입니다. 게임 개발자와 AI 에이전트(특히 Codex)를 대상으로 하며, Node.js 16 이상이 필요합니다. 사용자는 '전투 브금', '동굴 분위기' 같은 자연어 설명만으로도 적절한 음악 분위기(mood), BPM, 키(key), 마디 수(bars) 등을 자동 추론하여 고품질의 8비트 오디오를 생성할 수 있습니다. 주요 기능으로는 단일 BGM 생성, 시드 패밀리 기반 변주 생성, 6개의 큐로 구성된 완전한 사운드트랙 팩 생성, 다양한 카테고리의 SFX 생성 등이 있습니다. 또한 MIDI 내보내기, 스템(개별 악기 트랙) 분리, Godot 엔진용 AudioStreamRandomizer 리소스(.tres) 생성 등 게임 제작에 유용한 고급 기능을 제공합니다. 시드(seed) 기반 생성이므로 동일한 시드를 사용하면 항상 동일한 결과물을 얻을 수 있어 협업과 버전 관리에 용이합니다.

지원 대상~Claude Code✓Codex CLI✓Cursor
npx skills add 888wing/8bit-music-generator

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Chipgen

번들된 Node 스크립트를 사용하여 결정론적(deterministic) 8비트 음악과 SFX를 로컬에서 생성합니다. Node.js 16 이상이 필요합니다.

스크립트는 이 스킬 폴더 기준 scripts/chipgen.js에 있습니다. node로 실행하고 stdout을 JSON으로 캡처하십시오. 오류는 stderr로 출력됩니다.

새로운 기능 작업, 생성된 매니페스트, 사용자 대상 요약에는 영어 우선 표현을 사용하십시오. 브라우저 UI 편집 시에는 번체 중국어 지원을 보조 로케일로 유지하십시오.

워크플로

  1. 출력 디렉토리를 결정합니다. 사용자가 지정하지 않으면 현재 프로젝트의 generated-audio/를 사용합니다.
  2. 아래의 '요약-매개변수 변환' 규칙을 사용하여 사용자 요청에서 매개변수를 추출합니다. 시드가 제공되지 않으면 하나를 선택하고 결과를 재현할 수 있도록 보고합니다.
  3. 유효한 분위기(mood), 키(key) 또는 SFX 카테고리가 필요할 때 node <skill-dir>/scripts/chipgen.js list를 실행합니다.
  4. 요청된 에셋을 생성합니다. 사용자가 사운드트랙 팩, 장면 세트 또는 "같은 스타일의 다른 장면"을 요청하면 music-pack을 사용합니다.
  5. stdout에서 JSON 매니페스트를 읽고 생성된 파일 경로, 시드, 분위기/카테고리, BPM 및 MIDI/스템/tres 출력물을 보고합니다.

요약-매개변수 변환

자연어 게임 오디오 요약에서 매개변수를 추론합니다. 호환되지 않는 제약 조건이 없는 한 질문을 하기보다 합리적인 첫 번째 추측을 우선합니다.

음악 분위기 선택

  • adventure: 오버월드, 여정, 오프닝, 탐험, 영웅적, 희망찬, 밝은, 타이틀 화면, 지도, 발견, 숲, 하늘, 바다 또는 일반 플랫포머 BGM에 사용합니다.
  • battle: 일반 전투, 추적, 위험, 액션, 시간 제한 챌린지, 적 웨이브, 빠른 아케이드 강도 또는 보스전이 아닌 긴장감 있는 게임 플레이에 사용합니다.
  • boss: 보스, 최종 보스, 라이벌 전투, 클라이맥스, 압도적, 악마적, 고위험, 후반 게임, 레이드 또는 "battle보다 더 강렬하게"에 사용합니다.
  • town: 마을, 마을, 상점, 여관, 본거지, 안전 지대, 아늑한, 우호적인 NPC, 제작, 농장, 가벼운 메뉴 BGM 또는 일상적인 장면에 사용합니다.
  • dungeon: 동굴, 유적, 미스터리, 잠입, 미로, 밤, 하수도, 연구소, 외계인, 유령의, 수중, 눈/얼음(설명이 비극적이기보다 외롭고/차갑고/신비로운 경우)에 사용합니다.
  • sad: 상실, 게임 오버, 추억, 엔딩, 폐허가 된 집, 이별, 죽음, 고독, 우울, 감동적인 컷씬 또는 눈/얼음(설명이 명백히 슬픈 경우)에 사용합니다.

요약이 분위기를 혼합하는 경우, 먼저 게임 플레이 기능을 선택한 다음 감정을 선택합니다. 예: "슬픈 보스전"은 boss여야 합니다. "외로운 눈 레벨이지만 너무 느리지 않은"은 일반적으로 sad가 아닌 상위 범위 BPM의 dungeon입니다.

음악 키, 마디, BPM

  • 명시적인 키 요청은 직접 사용합니다. 정확한 키가 지정되지 않은 "minor" 요약은 A, D 또는 E에 매핑합니다. 밝고/영웅적이고/아늑한 요약은 C, F 또는 G에 매핑합니다. 사용자가 놀라움을 원하거나 조율 방향을 전혀 제시하지 않으면 random을 사용합니다.
  • 빠른 미리보기, 짧은 루프, 스팅거 또는 많은 후보에는 8마디를 사용합니다. 일반 루핑 BGM에는 16마디를 사용합니다. 더 긴 앰비언트/배경 요청에는 32마디를 사용합니다.
  • BPM이 지정되지 않은 경우 생성기가 분위기 범위 내에서 선택하도록 둡니다. 사용자가 더 빠르게/느리게 요청하면 선택한 분위기 범위의 상단/하단 근처로 BPM을 설정합니다. 사용자가 "너무 느리지 않게"라고 말하면 감정이 요구하지 않는 한 sad를 피하거나 sad를 92 BPM 근처로 설정합니다.
  • 최종 또는 프로덕션 준비 BGM의 경우 --midi --stems를 포함합니다. 탐색의 경우 --variants 5를 포함합니다(사용자가 단일 결과를 요청하지 않는 한).

음악 팩 선택

요청이 완전한 소규모 사운드트랙, 장면 팩, 큐 세트 또는 여러 게임 장면을 위한 일관된 스타일의 음악을 요청할 때 music-pack을 사용합니다.

music-pack은 하나의 시드 패밀리와 하나의 결정된 키에서 6개의 큐를 생성합니다:

  • 테마: adventure, 16마디
  • 마을: town, 16마디
  • 던전: dungeon, 16마디
  • 전투: battle, 8마디
  • 보스: boss, 16마디
  • 엔딩: sad, 8마디

이는 --variants와 다릅니다. 변형(variants)은 하나의 장면을 고정하고 파생 시드만 변경합니다. 음악 팩은 조율 중심과 시드 패밀리를 일관되게 유지하면서 장면 기능을 변경합니다.

SFX 카테고리 선택

  • coin: 획득, 수집, 보상, 보석, 아이템 획득, 점수 또는 긍정 확인에 사용합니다.
  • confirm: 메뉴 OK, 수락, 긍정 UI 클릭, 작은 성공 또는 대화 계속에 사용합니다.
  • cancel: 뒤로, 거부, 유효하지 않음, UI 오류, 닫힌 메뉴 또는 부정적 피드백에 사용합니다.
  • jump: 점프, 홉, 바운스, 스프링, UI 상향 이동 또는 캐릭터 상승에 사용합니다.
  • dash: 돌진, 회피, 빠른 이동, 속도 폭발 또는 공중 걸음에 사용합니다.
  • land: 착지, 스톰프, 무거운 발자국, 지면 접촉 또는 작은 신체 충돌에 사용합니다.
  • laser: 발사, 발사체, 짜잔, 광선, 주문 시전, 블래스터 또는 빠른 마법 공격에 사용합니다.
  • slash: 검, 칼날, 발톱, 휘두르기, 베기, 근접 공격 또는 빠른 휙-때림에 사용합니다.
  • hit: 데미지, 펀치, 충돌, 피해, 적 타격 또는 신체 접촉에 사용합니다.
  • block: 방패, 패리, 가드, 갑옷 타격, 반사 또는 금속/돌 충돌에 사용합니다.
  • explosion: 폭발, 부서짐, 충돌, 폭발, 파괴, 통, 폭탄 또는 큰 충격에 사용합니다.
  • powerup: 업그레이드, 레벨 업, 잠금 해제, 버프, 치유, 희귀 아이템, 성공 팡파르 또는 변신에 사용합니다.
  • heal: 치유, 회복, 물약, 부활, 마법 반짝임 또는 부드러운 긍정 효과에 사용합니다.
  • teleport: 순간이동, 사라짐, 워프, 포털, 리스폰 또는 위상 변화에 사용합니다.
  • door: 문, 스위치, 레버, 게이트, 메커니즘, 자물쇠 또는 무거운 UI 패널에 사용합니다.
  • chest: 보물 상자, 보상 공개, 아이템 팡파르, 전리품 열기 또는 희귀 획득에 사용합니다.
  • blip: UI 커서, 메뉴 이동, 작은 선택, 타이핑, 알림, 낮은 키의 삐 소리 또는 중립적인 인터페이스 피드백에 사용합니다.
  • alert: 경고, 알람, 감지, 느낌표, 낮은 체력 또는 시간 제한 위험에 사용합니다.
  • fall: 낙하, 실패, 드롭, 패배, 오답, 하향 전환 또는 게임 오버 스팅거에 사용합니다.
  • defeat: 죽음, 플레이어 패배, 게임 오버, 적 격파 또는 극적인 실패에 사용합니다.
  • whoosh: 공중 이동, 휘두름 준비, 전환, 빠른 통과 또는 추상적인 움직임에 사용합니다.

반복되는 게임 플레이 SFX의 경우 --variants 5를 생성합니다. UI 사운드의 경우 3-5개의 후보를 생성하고 blip, coin 또는 hit을 선택하여 random 대신 지속 시간을 짧게 유지합니다.

명령어

지원되는 값 나열:

node <skill-dir>/scripts/chipgen.js list

BGM 생성:

node <skill-dir>/scripts/chipgen.js music \
  --mood battle \
  --key A \
  --bars 16 \
  --seed 42 \
  --stems \
  --midi \
  --out generated-audio/bgm

하나의 시드 패밀리에서 BGM 후보 생성:

node <skill-dir>/scripts/chipgen.js music \
  --mood boss \
  --key A \
  --bars 16 \
  --seed 42 \
  --variants 5 \
  --midi \
  --out generated-audio/bgm

6-큐 음악 팩 생성:

node <skill-dir>/scripts/chipgen.js music-pack \
  --key C \
  --seed 42 \
  --stems \
  --midi \
  --out generated-audio/bgm-pack

하나의 SFX 생성:

node <skill-dir>/scripts/chipgen.js sfx \
  --cat coin \
  --seed 123 \
  --out generated-audio/sfx

Godot용 SFX 변형 풀 생성:

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

매개변수

지원되는 분위기(mood): adventure, battle, town, dungeon, sad, boss.

지원되는 SFX 카테고리: coin, confirm, cancel, jump, dash, land, laser, slash, hit, block, explosion, powerup, heal, teleport, door, chest, blip, alert, fall, defeat, whoosh, random.

유용한 옵션:

  • --bpm N: 생성된 BPM을 재정의합니다.
  • --bars N: 음악 길이. 사용자가 달리 요청하지 않는 한 8, 16 또는 32를 사용합니다.
  • --sr N: 샘플 레이트. 기본값은 44100입니다.
  • --midi: 음악용 MIDI 내보내기.
  • --stems: 개별 음악 스템(stems) 내보내기.
  • --variants N: 시드 패밀리를 생성합니다. 음악의 경우 분위기, 결정된 키, 마디 및 BPM을 고정하고 새 시드를 파생합니다. SFX의 경우 카테고리를 고정합니다.
  • --no-mix: 혼합된 WAV를 건너뜁니다.
  • --no-normalize: SFX 정규화를 비활성화합니다.
  • --tres PATH: Godot AudioStreamRandomizer 리소스를 작성합니다.
  • --res-prefix PREFIX: 생성된 Godot .tres 내부에 사용되는 리소스 접두사.

기본값

게임 준비 BGM의 경우 사용자가 빠른 미리보기만 원하지 않는 한 --stems --midi를 선호합니다.

음악 탐색의 경우 하나의 기본 시드에서 5-10개의 후보를 생성합니다. CLI 출력에서 variantIndex: 0은 기본 시드이고 이후 항목은 인덱스 1부터 시작하여 variantSeed = (baseSeed + 0x9E3779B9 * index) >>> 0를 사용합니다. 후보가 무작위가 아닌 관련성 있게 느껴지도록 mood, 결정된 key, bars 및 bpm을 고정합니다.

컴팩트한 게임 사운드트랙의 경우 music-pack --stems --midi를 선호합니다. 하나의 시드 패밀리에서 테마, 마을, 던전, 전투, 보스 및 엔딩 큐를 생성합니다.

반복적인 게임 내 재생을 위한 SFX의 경우 --variants 5를 선호하고 동일한 카테고리에서 다른 시드 변형을 유지합니다.

Godot 프로젝트의 경우 해당 디렉토리가 존재할 때 assets/audio/bgm 및 assets/audio/sfx를 사용합니다. Godot WAV 가져오기에서 루핑 BGM에 대해 루프 모드를 활성화해야 할 수 있음을 사용자에게 상기시킵니다.

관련 스킬