# Tripo

> Cloud-3D über dein AI Game Dev Abo-Kontingent: 3D-Modelle aus Text, einem Bild oder mehreren Ansichten, Texturen, Retopologie, Aufteilen in Teile, Mesh-Vervollständigung, Formatkonvertierung, Rigging, Animation sowie Bilderzeugung und -bearbeitung. Der Agent wählt die Operation und die Modellvariante für jede Aufgabe.

- Id: `aigd.tripo`
- Quelle: Offiziell (First-Party `aigd.*`)
- Kategorie: 3D
- Herausgeber: AI Game Dev (`aigd`), verifiziert
- Neueste Version: 0.2.20 (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.tripo

## Installieren

Mit der gamedev CLI im Projektordner:

```bash
gamedev pkg add aigd.tripo
```

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

## Versionen

| Version | Veröffentlicht | Erfordert App | Hinweise |
|---|---|---|---|
| 0.2.20 | 2026-11-22 | `>=0.25.11` | neueste |
| 0.2.19 | 2026-11-19 | `>=0.25.11` | - |
| 0.2.18 | 2026-11-13 | `>=0.25.11` | - |
| 0.2.17 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.16 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.15 | 2026-11-06 | `>=0.25.11` | - |
| 0.2.14 | 2026-11-05 | `>=0.25.11` | - |
| 0.2.13 | 2026-11-01 | `>=0.25.11` | - |
| 0.2.8 | 2026-10-24 | `>=0.25.10` | - |
| 0.2.7 | 2026-10-15 | `>=0.20.0` | - |
| 0.2.6 | 2026-10-13 | `>=0.20.0` | - |
| 0.2.5 | 2026-10-05 | `>=0.20.0` | - |

## Beschreibung

````markdown
# Tripo (`aigd.tripo`)

Tripo verbindet den AI Game Dev Agent über den AI Game Dev Server mit der Cloud-3D- und Bilderzeugung von Tripo, bezahlt aus deinem Abo-Kontingent. Es erstellt 3D-Modelle aus Text, einem Bild oder mehreren Ansichten, generiert Texturen, verarbeitet Meshes (Retopologie, Aufteilen in Teile, Vervollständigen fehlender Geometrie, Formatkonvertierung), riggt und animiert Modelle und erstellt und bearbeitet Bilder. In aktuellen App-Versionen wählt der Agent die Operation und die Modellvariante für jede Aufgabe. Die Desktop-App installiert es automatisch. Es eignet sich für Entwickler, die 3D-Assets und Animation ohne lokale GPU wollen.

## Was du erstellen kannst

- 3D-Modelle von Props, Charakteren, Kreaturen und Umgebungen aus einem Text-Prompt, einem Bild oder mehreren Ansichten.
- Texturen für ein vorhandenes 3D-Modell.
- Sauberere Meshes: optimierte Topologie, ein in Teile aufgeteiltes Modell, vervollständigte fehlende Geometrie oder die Konvertierung der Datei in ein anderes 3D-Format.
- Geriggte und animierte Charaktere: prüfen, ob ein Modell geriggt werden kann, ein Skelett hinzufügen, es animieren.
- 2D-Bilder: aus Text, bearbeitet oder als mehrere Ansichten eines Objekts (für Multiview-zu-3D).

## Beispielanfragen

- „Erstelle mit Tripo aus einem Text-Prompt eine hölzerne Schatztruhe und speichere sie im Projekt.“
- „Verwandle `Concepts/robot_front.png` in ein 3D-Modell, rigge es dann und füge eine Geh-Animation hinzu.“
- „Generiere neue Texturen für `Assets/Models/house.glb`.“
- „Teile dieses Fahrzeugmodell in Teile auf und optimiere seine Topologie.“
- „Erstelle Vorder-, Seiten- und Rückansicht dieses Charakterbilds und baue daraus das 3D-Modell.“

## Highlights

|  |  |
|---|---|
| Typ | Code-Paket (Sitzungswerkzeuge für den Agent), Cloud-Generierung |
| 3D | 3D aus Text, aus einem Bild, aus mehreren Ansichten |
| Texturen | Texturen für ein 3D-Modell generieren |
| Mesh | Topologie optimieren, in Teile aufteilen, fehlende Geometrie vervollständigen, Dateiformat konvertieren |
| Riggen & animieren | Rig prüfen, ein Skelett hinzufügen, ein geriggtes Modell animieren |
| 2D | Bild aus Text, ein Bild bearbeiten, mehrere Ansichten erstellen und bearbeiten |
| Kosten | Prozentsätze deines Abo-Kontingents, gegen das Generierungsbudget des Chats geprüft |
| Installation | automatisch durch die Desktop-App |
| Lizenz | Apache-2.0 (das Paket) |

## Operationsgruppen

Desktop installiert `aigd.tripo` automatisch. Seine fünf Operationsgruppen (3D, Texturen, Mesh, Riggen & animieren, 2D) sind keine eigenen Schaltflächen: Die **3D**-Gruppe des Chats in Tools aktiviert die ersten vier, **Images** aktiviert 2D. Welche davon der Agent verwenden darf, wird nur auf dem Models-Bildschirm des Projekts entschieden.

Der Agent wählt die Operation und ihre `variant_id` für jede Aufgabe aus allen Varianten, die der aktuelle Serverkatalog als aktiviert und für den Plan des Nutzers geeignet auflistet; der Nutzer wählt sie nicht aus. Jeder Aufruf prüft den aktuellen Katalog erneut und ersetzt nie ein anderes Modell. Eine Variante, die der Plan nicht enthält, fehlt in den Tools; `status` und `capability_search` nennen den Grund (`PLAN_REQUIRED`: erfordert einen höheren Plan, den nur der Nutzer kaufen kann). Tools können keine Sitzungseinstellungen ändern. Dafür ist ein Host nötig, der `env.features.agentChoosesVariants` anbietet; auf einem älteren Host behält das Paket das bisherige Verhalten bei (eine festgelegte Variante oder eine explizite „Agent wählt“-Allowlist, die in den Einstellungen jeder Gruppe gewählt wird). Ältere Kernel legen nur Einstellungen und Status offen.

## Bezahlung von Aufgaben

Echte Operationen nutzen die öffentliche Kernel-API `paidOperations`. Der Kernel holt ein unveränderliches Server-Angebot ein, prüft es gegen das Generierungsbudget des Chats (standardmäßig läuft eine Aufgabe innerhalb des Budgets ohne Nachfrage; bei „Vor jeder Operation nachfragen“ gibt der Nutzer jede einzeln frei) und übermittelt die genehmigte Anfrage. Eine Aufgabe, die das Budget nicht abdeckt, wird abgelehnt. Sitzungskonfiguration ist keine Zustimmung. Schlüssel und Kontotokens bleiben außerhalb des Pakets; nur unser Server kommuniziert mit Tripo.

## Warten, Wiederherstellung und Wiederholungen

Eine normale Generierung wartet auf den Abschluss und speichert alle Artefakte im selben Tool-Aufruf. Während des Wartens hält der Aufruf das Neuladen der Pakete der App und deren Hintergrunddienst-Update (`aigd.work.hold`) zurück, sodass keines von beiden das Backend mitten im Warten ersetzt. Der Agent kann unterbrochene Arbeit mit `retrieve_result` wiederherstellen oder `jobs` und `recover_jobs` zur Diagnose einsehen und die gespeicherte Berechtigung widerrufen. Download-Wiederholungen erzeugen niemals Assets neu. Unbekannte Übermittlungsergebnisse werden über ihre persistierte Anfrage-Identität wiederhergestellt, statt eine Ersatzaufgabe zu erstellen. Vorhandene Dateien bleiben erhalten.

## Abrechnung

Alle Kostenschätzungen und Salden für Kunden verwenden Kontingent-Prozentsätze. Die Server-Abrechnung belastet die offiziellen Anbieterkosten ohne zusätzlichen Aufschlag. Die tatsächliche Ausführung hängt von der aktuellen Serverbereitschaft, der Abo-Richtlinie und der Kernel-Unterstützung ab. Die mitgelieferte Einstellungsseite enthält keine Simulationssteuerungen.

## Validierung

Die Validierung deckt aktuelle Richtlinienänderungen, Sitzungseigentum, Ablehnung vor dem Übermitteln, verlorene Bestätigungen ohne Wiederholungen und das Abrufen von Artefakten ohne Generierung ab. Isolierte Entwicklungs-Fixtures sind QA-Hilfen und keine Anbieter-Validierung.

## Kompatibilität

Kompatibilität: Die Aktivierung prüft die tatsächlich vorgeschlagenen APIs, unabhängig von der Engine-Version. Der vorherige Kernel für die Sitzungskonfiguration behält seine Legacy-Webview-Steuerelemente; der aktuelle Kernel rendert alle fünf deklarierten Module und verwaltet ihren Lebenszyklus. Ein Kernel ohne die Basis-APIs für Konto/Sitzungskonfiguration registriert keine Provider und protokolliert die Anforderung eines Anwendungs-Updates. Dieser Kompatibilitätspfad ersetzt niemals eine Variante und autorisiert keine Ausgaben.

## Gespeicherte Assets

Jedes Modul deklariert `context.assetOperations` in seinem Manifest. Der Kernel zeigt eine kompakte Assets-Anzahl in den Einstellungen dieses Moduls nur dann an, wenn diese Sitzung Ausgabedateien abgeschlossen hat. „Öffnen“ blendet ein begrenztes Popup ein, niemals eine unaufgeforderte Chat-Karte. Die Liste schließt andere Module und Sitzungen aus. Gespeicherte Dateien öffnen im Projekt-Viewer oder Dateimanager; fehlende oder geänderte Dateien können über das vorhandene dauerhafte Auslieferungsjournal wiederhergestellt werden, ohne die bezahlte Generierung zu wiederholen.
````
