# Pakete — AI Game Dev App & CLI · AI Game Developer Wiki

Welche Pakete die AI Game Dev App enthält, wie du sie im Packages-Fenster oder mit gamedev pkg verwaltest und wie Ebenen funktionieren.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/app/packages).

Pakete erweitern die AI Game Dev App um ganze Fähigkeiten: Blender, Musik mit SuperCollider, eine Knowledge Base fürs Projekt, Tripo-3D-Generierung, lokale Bild- und Videomodelle, Cloud-Video- und Audiomodelle und alles, was sich ein Team selbst baut. Diese Seite erklärt, was ein Paket ist, welche Pakete mit der App kommen und wie du sie im Packages-Fenster der Desktop-App und mit dem Befehl `gamedev pkg` verwaltest.

## Was ein Paket ist

Ein Paket ist ein Ordner mit einem Manifest, `aigd-package.json`, und optional etwas JavaScript. Das Modell ist dasselbe wie bei VS-Code-Erweiterungen: Alles, was ein Paket anzeigt, wird in seinem Manifest deklariert und ist sichtbar, bevor sein Code läuft, und der Code startet erst, wenn etwas ihn braucht.

Ein Paket kann Folgendes beitragen:

- **Session-Tools** in der Tools-Zeile, oft gestützt auf einen MCP-Server, sodass der Agent neue Tools bekommt.
- **Slash-Befehle** wie `/blender` oder `/kb`, die im Desktop-Chat und in der CLI funktionieren.
- **Befehle** für die Befehlspalette, **Menüs** und Composer-Toolbar-Buttons, Einträge in der **Statusleiste**.
- **Panels**, **Views** in der Seitenleiste, eigene Fenster und **benutzerdefinierte Editoren** oder Vorschauen für Dateitypen.
- **Einstellungen**, kurze **Tutorials** in der App und **Abhängigkeiten** von anderen Paketen oder Claude-Plugins.
- Reine Daten: Die lokalen Bild- und Videomodelle sind Pakete ohne Code, die ihre Dateien, Downloadgröße, Lizenz und die passende Hardware deklarieren.

Jedes Paket hat eine Id der Form `publisher.name`. First-Party-Pakete verwenden den Publisher `aigd`, zum Beispiel `aigd.blender`.

## Pakete, Claude-Plugins, MCP-Server und Engine-Erweiterungen

Die App kennt vier Arten von Erweiterungen. Sie alle landen als Tools, die der Agent nutzen kann, aber sie werden an unterschiedlichen Stellen verwaltet:

| Art | Was sie erweitert | Wo du sie verwaltest |
| --- | --- | --- |
| Paket | Die App selbst: Tools, Befehle, Panels, Editoren, Modelle | Packages-Fenster, `/packages`, `gamedev pkg` |
| Claude-Plugin | Der Claude-Agent: Skills, Befehle, Agenten, Plugin-MCP-Server | **Settings**, **Claude Plugins** oder `/plugin` |
| MCP-Server | Tools von jedem MCP-Server, lokal oder remote, für das aktuelle Projekt | **Settings**, **MCP servers** oder `/mcp` |
| Engine-Erweiterung | Mehr Tools im Unity-, Unreal- oder Godot-Plugin | Extensions-Aktion in der Seitenleiste oder `/install-extension` (siehe [Erweiterungen](https://ai-game.dev/docs/extensions)) |

Ein MCP-Server, den du in den Settings hinzufügst, gehört zu dem Projekt, das beim Hinzufügen geöffnet war, und ist in anderen Projekten nie sichtbar. Ein neues Plugin oder ein neuer MCP-Server gilt ab der nächsten Nachricht für den bereits geöffneten Chat.

## Pakete, die mit der App kommen

Beim ersten Start installiert die App ihre Standardpakete für dich, auf Benutzerebene, sodass sie in jedem Projekt verfügbar sind:

| Paket | Was es hinzufügt |
| --- | --- |
| `aigd.blender` | Blender: Der Agent baut und bearbeitet 3D-Modelle in einem echten Blender |
| `aigd.supercollider` | Musik: Spielmusik mit SuperCollider komponieren, rendern und exportieren |
| `aigd.knowledge` | Knowledge Base: Markdown-Notizen im Projekt, die der Agent liest und aktualisiert |
| `aigd.tripo` | Tripo: 3D-, Textur-, Mesh-, Rig- und Animations-Tools |
| `aigd.sdcpp` | Lokale Bild- und Videogenerierung mit stable-diffusion.cpp |

Ein Standardpaket, das du entfernst, wird nie wieder hinzugefügt. Ein Paket zu installieren heißt nicht, dass jeder Chat es mitführt: Du schaltest seine Tools pro Session in der Tools-Zeile ein. Die lokalen Bild- und Videomodelle und die Cloud-Modellfamilien sind separate Pakete; alle findest du im [Paketkatalog](https://ai-game.dev/de/docs/wiki/app/packages-catalog).

## Das Packages-Fenster

Öffne es über das Paket-Symbol in der Statusleiste unten rechts im Fenster („Open Packages“). Oben zeigt es das Projekt und seine Ebenen, darunter diese Tabs:

- **Installed**: die in diesem Projekt aktiven Pakete mit Status, Version und Ebene.
- **Browse**: die Paket-Registry von AI Game Developer durchsuchen.
- **Claude plugins**: die Claude-Plugins, die Pakete für dieses Projekt benötigen.
- **Models**: die lokalen Bild- und Videomodelle, die du herunterladen kannst; wird angezeigt, wenn das Projekt die Generierungs-Runtime hat.

In der Kopfzeile gibt es **Check for updates** und **Reload**, was die Pakete des Projekts neu startet. Wähle ein Paket aus, um Details, Ebenen, Einstellungen und Fehler zu sehen.

## Ein Paket installieren

### In der Desktop-App

1. Öffne das Packages-Fenster und wähle **Browse**.
2. Suche zum Beispiel `hello` und wähle das Paket aus.
3. Wähle unter dem Hinzufügen-Button die Ebene: **User**, **Project** oder **Local** (siehe [Ebenen](https://ai-game.dev/de/docs/wiki/app/packages#levels)).
4. Klicke auf **Add to Project** (oder **Add to User**, **Add to Local**).

Um ein Paket von außerhalb der Registry hinzuzufügen, gib es in das Hinzufügen-Feld ein. Es akzeptiert eine Registry-ID (`aigd.blender`, optional mit einem Versionsbereich wie `aigd.blender@^1.2`), einen GitHub-Link oder `owner/repo`, ein npm-Paket (`npm:<name>` oder dessen npmjs.com-Link) oder einen Ordnerpfad.

### In der CLI

Führe `gamedev pkg` im Projektordner aus (oder übergib `--cwd <path>`), oder verwende `/packages` in der interaktiven CLI. Die Standardebene ist `--project`.

```bash
gamedev pkg list                          # the packages in effect for this project
gamedev pkg list --user                   # the user level alone
gamedev pkg add aigd.blender --user       # from the registry, for every project
gamedev pkg add github:owner/repo         # from GitHub, for this project
gamedev pkg add npm:some-package --local  # from npm, this machine only
```

Ein Registry-Paket, das ohne Bereich hinzugefügt wird, wird als `^<installed version>` geschrieben, damit es kompatible Updates erhält.

## Ebenen: User, Project, Local

Pakete und ihre Einstellungen werden auf drei Ebenen deklariert. Eine höhere Ebene überschreibt eine niedrigere: Local gewinnt gegenüber Project, Project gewinnt gegenüber User.

| Ebene | Gilt für | Deklariert in | In Git eingecheckt |
| --- | --- | --- | --- |
| User | Jedes Projekt auf diesem Computer | `~/.ai-game-dev/packages.json` | Nein |
| Project | Alle, die das Projekt öffnen | `<project>/.ai-game-dev/packages.json` | Ja |
| Local | Nur dieses Projekt auf diesem Computer | `<project>/.ai-game-dev/packages.local.json` | Nein (die App trägt sie in `.ai-game-dev/.gitignore` ein) |

Jede Ebene hat außerdem eine Lock-Datei daneben (`packages-lock.json`, `packages-lock.local.json`), die die exakten Versionen festschreibt, sodass Teammitglieder, die denselben Projekt-Lock teilen, dieselben Bytes installieren.

Verwende **Project** für Pakete, die das ganze Team braucht, **User** für deine persönlichen Tools und **Local** für maschinenspezifische Entscheidungen, etwa einen Pfad zu einem Tool, das auf deinem Computer installiert ist.

## Ein Paket in einem Projekt ausschließen

Um ein Paket auf User-Ebene in einem Projekt zu deaktivieren, wähle es aus und klicke in der Ebenenzeile auf **Exclude**, oder:

```bash
gamedev pkg exclude aigd.blender            # off in this project (written to the project file)
gamedev pkg include aigd.blender            # undo
```

Die Projektdatei enthält dann `"aigd.blender": false`; andere Projekte sind nicht betroffen.

## Pakete aktualisieren

Automatische Updates sind standardmäßig aktiviert. Die App prüft kurz nach dem Start, alle vier Stunden und wenn du auf **Check for updates** klickst. Sie installiert die neueste Version innerhalb des Bereichs, den die jeweilige Ebene deklariert und die mit deiner App kompatibel ist, und zeigt pro Durchlauf eine Benachrichtigung an, etwa "Updating 1 package… (1/1)", gefolgt von "Updated 1 package".

- Schalte automatische Updates für ein einzelnes Paket über seinen **Auto-update**-Schalter im Packages-Fenster aus, oder mit `gamedev pkg auto-update off <id>`. Die Wahl gilt pro Computer.
- Jetzt aktualisieren mit `gamedev pkg update` (alle) oder `gamedev pkg update <id>`.
- Pakete aus einem lokalen Ordner und auf einen Tag festgelegte GitHub-Quellen werden nie automatisch aktualisiert.

Ein Paket, das eine neuere App benötigt, sagt das ("requires AI Game Dev >=X, you have Y"); aktualisiere zuerst die App.

## Ein Paket entfernen

Wähle es aus und klicke auf **Remove**, oder:

```bash
gamedev pkg remove <id>              # remove it from the project level
gamedev pkg remove <id> --user       # remove it from the user level
```

Ein Paket, das nur als Abhängigkeit eines anderen installiert wurde, hat kein Remove, sondern nur Exclude; es verschwindet von selbst, wenn es niemand mehr braucht.

## Paketeinstellungen

Wähle ein Paket aus und öffne **Settings**. Neben jeder Einstellung wählst du die Ebene, in die sie geschrieben wird; der Chip zeigt, woher der aktuelle Wert stammt. Manche Einstellungen sind Ordnerauswahlfelder mit **Browse…** und einer Prüfung des freien Speicherplatzes, andere bieten Auswahlmöglichkeiten, die von der App stammen.

In der CLI:

```bash
gamedev pkg settings aigd.blender                 # every key, its value and level
gamedev pkg settings <id> <key> <value> --local   # write a value at a level
gamedev pkg settings <id> <key> --unset --project # clear the value at a level
```

Ein Wert wird vor dem Speichern gegen seinen deklarierten Typ geprüft; ein abgelehnter Wert ändert nichts und beendet den Vorgang mit Code 1.

## Abhängigkeiten

Ein Paket kann von anderen Paketen und von Claude-Plugins abhängen. Die App installiert sie für dich und hält pro Projekt eine Version jedes Pakets. Das Packages-Fenster listet eine Abhängigkeit als "installed for `<id>`" mit ihrer Ebene auf. Claude-Plugins, die ein Paket benötigt, werden pro Projekt in einen app-eigenen Cache installiert und nur in den Sitzungen dieses Projekts geladen, nie in dein eigenes Claude Code.

## Sicherheit und Fehler

Pakete laufen mit den Berechtigungen deines Benutzers, wie VS Code-Erweiterungen: Es gibt keine Sandbox. Installiere Pakete nur aus Quellen, denen du vertraust. Pakete aus der AI Game Dev-Registry werden vor dem Entpacken gegen ihre veröffentlichten Prüfsummen verifiziert.

Wenn ein Paket fehlschlägt, zeigt seine Karte eine Warnungsanzahl und seine Registerkarte **Errors** listet die Details auf. Fehler von Drittanbieter-Paketen werden nirgendwohin gesendet; Fehler von First-Party-`aigd`-Paketen aus unserer Registry werden uns nur mit deiner Zustimmung zur Absturzberichterstattung gemeldet. Installierte Pakete starten ohne Netzwerkverbindung.

## Nächste Schritte

- Alle verfügbaren Pakete findest du im [Paketkatalog](https://ai-game.dev/de/docs/wiki/app/packages-catalog).
- Baue eigene in [Pakete erstellen](https://ai-game.dev/de/docs/wiki/app/creating-packages).
- Der Beitrag [Pakete, Claude-Plugins und MCP-Server](https://ai-game.dev/de/blog/ai-game-dev-packages-plugins-mcp) zeigt das Packages-Fenster und einen MCP-Server eines Projekts in Aktion.

---

Source (HTML): https://ai-game.dev/de/docs/wiki/app/packages

Machine-translated (de) from the English page: https://ai-game.dev/docs/wiki/app/packages