SuperCollider
gamedev pkg add aigd.supercollider개요
SuperCollider 3.14.1로 컴퓨터에서 이식성 있는 게임 음악을 작곡하고 렌더링하고 분석하고 내보내세요. 프로젝트 안의 코드로서의 스코어, 오프라인 WAV 렌더, 동기화된 스템과 루프, 샘플 가져오기, 미리 듣기, 그리고 Unity, Godot, Unreal로의 내보내기를 지원합니다.
AI Game Dev 에이전트와 SuperCollider로 이식성 있는 게임 음악을 작곡하고, 렌더링하고, 분석하고, 내보내세요. 에이전트는 프로젝트에 SuperCollider 스코어(.scd)를 작성하고, 컴퓨터에서 오프라인으로 WAV로 렌더링하며, 결과를 미리 들어 볼 수 있게 하고, Unity, Godot 또는 Unreal 프로젝트로 내보냅니다. 모든 작업은 로컬에서 실행되며 AI Game Dev 사용량을 전혀 소모하지 않습니다. 완성된 오디오 파일만이 아니라 음악, 루프, 스템, 이펙트를 버전 관리에 남는 편집 가능한 소스 코드로 원하는 게임 개발자에게 잘 맞습니다.
할 수 있는 일
- 읽고 편집하고 다시 렌더링할 수 있는 SuperCollider 코드로 테마, 루프, 스팅어를 작곡합니다.
- 레이어드 또는 적응형 음악을 위해 동일한 길이와 설정으로 동기화된 스템(예: 퍼커션과 멜로디)을 렌더링합니다.
- 직접 만든 샘플을 사용합니다. WAV를 가져와 스코어에서 재생합니다.
- 렌더 결과를 확인합니다. 길이, 샘플 레이트, 채널, 피크, RMS, 클리핑을 봅니다.
- 앱에서 렌더 결과를 미리 들어 본 뒤 WAV를 엔진의 오디오 폴더로 내보냅니다.
요청 예시
- "8초짜리 부드러운 탐험 테마를 작곡하고 렌더링해서 게임으로 내보내 주세요."
- "48 kHz 스테레오로 2초짜리 매끄러운 퍼커션 루프와 거기에 맞는 베이스 스템을 만들어 주세요."
- "
Recordings/door.wav을 샘플로 가져와서 그것으로 짧은 에코 문 효과음을 만들어 주세요." - "마지막 렌더를 분석해 주세요. 클리핑되는 부분이 있나요?"
작동 방식
이 패키지는 Music 기능을 추가합니다(Tools의 채팅 Audio 그룹에 속하며, Audio와 함께 전환됩니다). 프로젝트의 Models 화면("SuperCollider (music)")에서 에이전트가 이를 사용할 수 있는지 결정합니다. 에이전트는 다음 도구들을 사용할 수 있습니다:
| 도구 | 하는 일 |
|---|---|
status, get_guide | 런타임 상태와 작성 가이드. |
init_project | AudioSource 작성 트리를 만들고 검증된 예제 스코어를 복사하며, 작성한 곡은 절대 덮어쓰지 않습니다. |
import_sample | 프로젝트 WAV를 샘플로 복사하고(리틀 엔디언 PCM, 모노 또는 스테레오, 16/24/32비트, 8–192 kHz) SHA-256을 기록합니다. |
render, get_render_status, cancel_render | 스코어를 이 채팅의 작업으로 오프라인 렌더링하고, 진행 상황을 따라가고, 취소합니다. |
analyze_audio | WAV의 길이, 레이트, 채널, 비트, 피크, RMS, 클리핑. |
preview | 데스크톱 앱에서 열리는 짧고 완전한 미리 듣기 사본입니다(CLI는 그 경로를 반환합니다). |
export_to_game | 완료된 렌더를 게임 프로젝트로 내보냅니다. |
에이전트는 일반 파일 도구로 스코어를 편집합니다. 각 .scd 스코어는 Score을 반환하고, 러너는 비실시간 모드에서 새 scsynth로 이를 렌더링합니다. 렌더 결과는 44100, 48000 또는 96000 Hz의 모노 또는 스테레오 PCM16 WAV이며, 최대 600초이고, 요청한 길이의 정확한 프레임 수로 잘리며, 정규화는 적용되지 않습니다. 시드는 작곡의 언어 측 무작위성을 재현 가능하게 만들지만, 결과가 플랫폼 간에 비트 단위로 동일하다고 보장하지는 않습니다. 이 패키지는 라이브 신시시스를 수행하거나 Quarks나 플러그인을 설치하지 않습니다.
네 개의 예제 스코어는 멜로디 신스 노트(music.scd), 에코 테일이 있는 악기(effect.scd), 스테레오 샘플(sample.scd), 정렬된 퍼커션 스템(loop-stem.scd)을 보여 줍니다.
내보내기 위치
| 프로젝트 | 내보내기 |
|---|---|
| Unity | Assets/Audio, 기존 .meta 파일과 그 GUID를 유지합니다. |
| Godot | res://Audio/; AudioSource에는 .gdignore이 생겨 Godot가 이를 건너뜁니다. |
| Unreal | 연결된 에디터를 통해 /Game/Audio로 가져옵니다. 에디터가 가져오기를 확인하지 않으면 직접 가져올 수 있도록 WAV 경로를 받습니다. |
| 엔진이 없는 프로젝트 | AudioSource/exports의 WAV 파일. |
AudioSource(스코어, 악기, 이펙트, 샘플, 프리셋, audio-project.json, dependencies.lock)은 버전 관리에 보관하고, 렌더 결과는 일회용으로 취급합니다.
데스크톱 앱에서는 Unity, Godot 또는 Unreal 에디터에 연결된 유휴 채팅에 두 가지 팁이 표시됩니다. 하나는 Music을 켜라는 것이고, 그다음은 8초 샘플 테마나 직접 떠올린 아이디어를 제안하는 것입니다. /supercollider [status|guide]은 상태와 가이드를 보여 줍니다.
런타임과 요구 사항
- SuperCollider 3.14.1은 처음 필요할 때 공식 GitHub 릴리스에서 내려받아 고정된 SHA-256과 대조해 검증합니다. Windows x64에서는 ZIP, macOS에서는 DMG를 사용합니다. 패키지를 활성화하는 것만으로는 아무것도 내려받지 않습니다.
- Linux: SuperCollider는 이식 가능한 Linux 빌드를 배포하지 않습니다.
runtimePath을 호환되는 SuperCollider 3.14.1 설치로 지정하거나,stagedArtifact를 검토된 아티팩트 설명자(버전, 플랫폼, URL, SHA-256, 형식tar)로 지정하세요. - 각 작업은 표준 클래스 라이브러리와 플러그인만으로 실행됩니다. 사용자의 SuperCollider 시작 파일과 홈 구성은 로드되거나 변경되지 않습니다. 스코어 코드는 신뢰된 코드이며 보안 샌드박스가 아닙니다.
- AI Game Dev 0.25.11 이상.
라이선스
이 패키지: Apache-2.0. SuperCollider는 해당 프로젝트가 GNU GPL로 배포하는 자유 소프트웨어입니다. 패키지 아바타는 공식 SuperCollider 로고이며, 상표권은 그 소유자에게 있습니다.
버전
| 버전 | 출시일 | 앱 필요 |
|---|---|---|
| 0.1.12최신 | 0.25.11 이상 | |
| 0.1.11 | 0.25.11 이상 | |
| 0.1.10 | 0.25.11 이상 | |
| 0.1.9 | 0.25.11 이상 | |
| 0.1.8 | 0.25.11 이상 | |
| 0.1.7 | 0.25.11 이상 | |
| 0.1.5 | 0.20.0 이상 | |
| 0.1.4 | 0.20.0 이상 | |
| 0.1.2 | 0.20.0 이상 | |
| 0.1.1 | 0.20.0 이상 |
설치
데스크톱 앱에서
Packages 창을 열고(상태 표시줄의 패키지 아이콘) Browse를 선택한 다음 aigd.supercollider를 검색하고 Add to Project를 클릭합니다.
앱이 아직 없나요? Windows, macOS, Linux용 AI Game Dev 무료 다운로드를 받아보세요.
터미널에서
gamedev CLI를 사용해 프로젝트 폴더에서 실행합니다:
gamedev pkg add aigd.supercollider요구 사항
- AI Game Dev 0.25.11 이상
gamedev pkg add aigd.supercollider