Pakete

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:

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:

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.

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).
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.

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.

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:

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:

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:

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.
• Baue eigene in Pakete erstellen.
• Der Beitrag Pakete, Claude-Plugins und MCP-Server zeigt das Packages-Fenster und einen MCP-Server eines Projekts in Aktion.