# SuperCollider

> Komponiere, rendere, analysiere und exportiere portable Spielmusik mit SuperCollider 3.14.1 auf deinem Computer: Scores als Code in deinem Projekt, Offline-WAV-Renders, synchronisierte Stems und Loops, Sample-Import, Vorschau und Export nach Unity, Godot oder Unreal.

- Id: `aigd.supercollider`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: Audio
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 0.1.12 (veröffentlicht am 2026-11-22)
- Lizenz: Apache-2.0
- Erfordert die AI Game Dev App: `>=0.25.11`
- Nativer Code: nein
- Bewertung: noch nicht bewertet
- HTML-Seite: https://ai-game.dev/de/packages/aigd.supercollider

## Installieren

Mit der gamedev CLI im Projektordner:

```bash
gamedev pkg add aigd.supercollider
```

In der Desktop-App: Öffne das Fenster Packages (das Paket-Symbol in der Statusleiste), wähle **Browse**, suche nach `aigd.supercollider` und klicke auf **Add to Project**. Mehr: https://ai-game.dev/docs/wiki/app/packages

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 0.1.12 | 2026-11-22 | `>=0.25.11` | neueste |
| 0.1.11 | 2026-11-19 | `>=0.25.11` | - |
| 0.1.10 | 2026-11-13 | `>=0.25.11` | - |
| 0.1.9 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.8 | 2026-11-06 | `>=0.25.11` | - |
| 0.1.7 | 2026-11-01 | `>=0.25.11` | - |
| 0.1.5 | 2026-10-13 | `>=0.20.0` | - |
| 0.1.4 | 2026-10-09 | `>=0.20.0` | - |
| 0.1.2 | 2026-10-05 | `>=0.20.0` | - |
| 0.1.1 | 2026-10-01 | `>=0.20.0` | - |

## Beschreibung

````markdown
# SuperCollider (`aigd.supercollider`)

Komponiere, rendere, analysiere und exportiere portable Spielmusik mit dem AI Game Dev Agenten und [SuperCollider](https://supercollider.github.io). Der Agent schreibt SuperCollider-Scores (`.scd`) in deinem Projekt, rendert sie offline zu WAV auf deinem Computer, lässt dich das Ergebnis in der Vorschau anhören und exportiert es in dein Unity-, Godot- oder Unreal-Projekt. Alles läuft lokal und verbraucht nichts von deinem AI Game Dev-Kontingent. Es eignet sich für Game-Entwickler, die Musik, Loops, Stems und Effekte als bearbeitbaren Quellcode wollen, der in der Versionskontrolle bleibt, nicht nur als fertige Audiodateien.

## Was du tun kannst

- Komponiere Themes, Loops und Stinger als SuperCollider-Code, den du lesen, bearbeiten und erneut rendern kannst.
- Rendere synchronisierte Stems (zum Beispiel Percussion und Melodie) mit derselben Länge und denselben Einstellungen, für geschichtete oder adaptive Musik.
- Verwende deine eigenen Samples: Importiere ein WAV und spiele es aus einem Score ab.
- Prüfe einen Render: Dauer, Samplerate, Kanäle, Peak, RMS und Clipping.
- Höre dir einen Render in der App als Vorschau an und exportiere das WAV anschließend in den Audio-Ordner deiner Engine.

## Beispielanfragen

- „Komponiere ein sanftes achtsekündiges Explorationsthema, rendere es und exportiere es ins Spiel.“
- „Erstelle einen 2 Sekunden langen nahtlosen Percussion-Loop in 48 kHz Stereo und einen passenden Bass-Stem.“
- „Importiere `Recordings/door.wav` als Sample und baue daraus einen kurzen widerhallenden Türeffekt.“
- „Analysiere den letzten Render: Clippt irgendetwas?“

## So funktioniert es

Das Paket fügt die Fähigkeit **Musik** hinzu (Teil der Audio-Gruppe des Chats unter Tools; sie schaltet sich mit Audio um). Der Bildschirm „Models“ des Projekts („SuperCollider (music)“) entscheidet, ob der Agent sie verwenden darf. Der Agent erhält diese Tools:

| Tool | Was es bewirkt |
|---|---|
| `status`, `get_guide` | Laufzeitstatus und die Authoring-Anleitung. |
| `init_project` | Erstelle den `AudioSource`-Authoring-Baum und kopiere getestete Beispiel-Scores, ohne deine Kompositionen zu überschreiben. |
| `import_sample` | Kopiere ein Projekt-WAV in die Samples (Little-Endian-PCM, mono oder stereo, 16/24/32-Bit, 8–192 kHz) und zeichne seinen SHA-256 auf. |
| `render`, `get_render_status`, `cancel_render` | Rendere einen Score offline als Job dieses Chats, verfolge ihn und brich ihn ab. |
| `analyze_audio` | Dauer, Rate, Kanäle, Bits, Peak, RMS und Clipping eines WAV. |
| `preview` | Eine kurze, vollständige Vorschau-Kopie, geöffnet in der Desktop-App (die CLI gibt ihren Pfad zurück). |
| `export_to_game` | Exportiere einen fertigen Render in das Spielprojekt. |

Der Agent bearbeitet die Scores mit seinen normalen Dateiwerkzeugen. Jeder `.scd`-Score gibt ein `Score` zurück; der Runner rendert ihn mit einer frischen `scsynth` im Non-Real-Time-Modus. Renders sind Mono- oder Stereo-PCM16-WAV mit 44100, 48000 oder 96000 Hz, höchstens 600 Sekunden, auf die exakte Frame-Anzahl der angeforderten Dauer zugeschnitten, ohne Normalisierung. Ein Seed macht die sprachseitige Zufälligkeit der Komposition wiederholbar; es wird nicht versprochen, dass die Ergebnisse plattformübergreifend bitidentisch sind. Das Paket führt keine Live-Synthese durch und installiert keine Quarks oder Plugins.

Vier Beispiel-Scores zeigen melodische Synth-Noten (`music.scd`), ein Instrument mit Echo-Ausklang (`effect.scd`), ein Stereo-Sample (`sample.scd`) und einen ausgerichteten Percussion-Stem (`loop-stem.scd`).

### Wohin exportiert wird

| Projekt | Export |
|---|---|
| Unity | `Assets/Audio`, dabei werden eine vorhandene `.meta`-Datei und ihre GUID beibehalten. |
| Godot | `res://Audio/`; `AudioSource` erhält eine `.gdignore`, damit Godot sie überspringt. |
| Unreal | Über den verbundenen Editor nach `/Game/Audio` importiert; wenn der Editor den Import nicht bestätigt, erhältst du den WAV-Pfad, um ihn selbst zu importieren. |
| Projekte ohne Engine | WAV-Dateien in `AudioSource/exports`. |

Halte `AudioSource` (Scores, Instrumente, Effekte, Samples, Presets, `audio-project.json`, `dependencies.lock`) in der Versionskontrolle; Renders sind entbehrlich.

In der Desktop-App erscheinen in einem inaktiven Chat, der mit einem Unity-, Godot- oder Unreal-Editor verbunden ist, zwei Tipps: zuerst einer zum Aktivieren von Musik, dann einer, der ein achtsekündiges Beispielthema oder deine eigene Idee anbietet. `/supercollider [status|guide]` zeigt den Status und die Anleitung.

## Laufzeit und Voraussetzungen

- **SuperCollider 3.14.1**, beim ersten Bedarf von der offiziellen GitHub-Release heruntergeladen und gegen einen festgelegten SHA-256 geprüft: die ZIP unter Windows x64, das DMG unter macOS. Das Aktivieren des Pakets lädt nichts herunter.
- **Linux:** SuperCollider veröffentlicht keinen portablen Linux-Build. Setze `runtimePath` auf eine kompatible SuperCollider-3.14.1-Installation oder `stagedArtifact` auf einen geprüften Artefakt-Deskriptor (Version, Plattform, URL, SHA-256, Format `tar`).
- Jeder Job läuft nur mit der Standard-Klassenbibliothek und Plugins; deine SuperCollider-Startdateien und die Home-Konfiguration werden nicht geladen oder verändert. Score-Code ist vertrauenswürdiger Code, keine Sicherheits-Sandbox.
- AI Game Dev 0.25.11 oder neuer.

## Lizenz

Dieses Paket: Apache-2.0. SuperCollider ist freie Software, die von seinem Projekt unter der GNU GPL veröffentlicht wird. Das Paket-Avatar ist das offizielle SuperCollider-Logo; die Marke gehört ihrem Inhaber.
````
