Was macht 3D-Spiel-Assets?
Verwende diesen Skill, wenn ein 3D-Spiel konkrete, wiedererkennbare GLB-Assets benötigt, nicht nur primitive Geometrie. Der Skill steuert den gesamten Workflow: Routenauswahl, Generierung eines kleinen, fokussierten Asset-Sets, Schreiben/Lesen von asset_manifest.json und Einbinden der GLBs in das Spiel mit Fallbacks.
Erforderliches Verhalten
- Enthält die Spielaufforderung explizite oder implizite Entitäten wie einen Spieler, Charakter, Gegner, Sammelobjekt, Fahrzeug, Waffe, Hindernis, Boss, Maskottchen, Schlüsselrequisite oder Umgebungsobjekt, ist die GLB-Generierung ein erforderlicher Schritt, wenn das Tool verfügbar ist.
- Generiere standardmäßig nur 1-3 Schlüssel-Assets. Priorisiere zuerst den Spieler/Hauptcharakter, dann den spielkritischen Gegner, das Sammelobjekt, Fahrzeug, Hindernis oder die Schlüsselrequisite. Generiere keine dekorativen Füllobjekte.
- Verwende primitive Three.js-Geometrie nur als temporären Platzhalter, während Assets ausstehen, und als Laufzeit-Fallback, falls ein GLB nicht lädt.
- Generiere vorhandene Assets nicht neu, es sei denn, der Benutzer fordert dies explizit. Wenn
asset_manifest.jsonbereits ladbare Assets enthält, verwende es wieder. - Vermeide urheberrechtlich geschützte Charaktere, Markennamen, Logos und Prominenten-Ähnlichkeiten. Schreibe in originelle Designs um.
Routenauswahl
Verwende tripo für den schnellen Weg: direkter Text-Prompt zum Tripo3D-Text-zu-Modell. Am besten geeignet für generische Requisiten, Gegner, Sammelobjekte, Fahrzeuge, Hindernisse und schnelle Iteration.
Verwende gemini_reference, wenn visuelle Kontrolle wichtig ist: Gemini erstellt zunächst ein Referenzbild mit reinweißem Hintergrund, dann erstellt Tripo Bild-zu-Modell das GLB. Bevorzuge diesen Weg, wenn der Benutzer Gemini, Nano Banana, T-Pose, weißen Hintergrund, Referenzbild, Bild-zu-Modell, Charakterbogen, Stilkonsistenz erwähnt oder wenn die Silhouette eines Schlüsselcharakters kontrolliert werden muss.
Verwende auto nur, wenn du damit einverstanden bist, dass der Server aus dem Prompt wählt. Im Zweifelsfall wähle die Route selbst und gib sie explizit an.
Umgebung
Der Generierungs-Client ist in diesem Skill unter scripts/game-assets-mcp.mjs gebündelt (Node >= 20, keine Abhängigkeiten). Er kommuniziert mit der standardmäßigen Remote-Asset-API unter http://54.81.110.182:3001.
GAME_ASSETS_API_URL– optionale Überschreibung der Asset-API-Basis-URLGAME_ASSETS_API_TOKEN– benutzerspezifisches Zugriffstoken
Fehlt das Token und erfordert der Dienst eine Authentifizierung, fordere den Benutzer auf, GAME_ASSETS_API_TOKEN vor der Generierung zu setzen. Frage nur nach GAME_ASSETS_API_URL, wenn der Benutzer den Standarddienst überschreiben muss. Frage niemals nach Tripo- oder Gemini-API-Schlüsseln; diese befinden sich auf dem Server.
Tool-Workflow
Wenn MCP-Tools mit dem Namen mcp__game_assets__* in deiner Sitzung verfügbar sind, bevorzuge sie. Andernfalls führe den gebündelten Client über Bash aus. Beide bieten dieselben zwei Operationen.
- Führe
pwdaus, wenn du den aktuellen Arbeitsbereichspfad noch nicht kennst. - Wenn du 3 oder mehr Assets planst oder dies die erste Asset-Generierung im Thread ist, überprüfe die Bereitschaft (
<skill-dir>ist das Verzeichnis dieses Skills):
node <skill-dir>/scripts/game-assets-mcp.mjs readiness --cwd "$(pwd)"
- Generiere 1-3 Assets (maximal 4 pro Batch). Übergib Parameter als ein JSON-Objekt:
node <skill-dir>/scripts/game-assets-mcp.mjs generate --cwd "$(pwd)" --params '{
"gamePrompt": "...",
"route": "tripo",
"assets": [{ "id": "...", "role": "player", "name": "...", "prompt": "..." }]
}'
route:tripo,gemini_referenceoderauto.assets: 1-3 Objekte mit stabiler, kebab-caseid,role,name,promptund optionalassetKind.force: nur, wenn der Benutzer explizit die Neugenerierung von Assets angefordert hat.- Der Befehl blockiert, während der Remote-Job abgefragt wird (normalerweise 1-3 Minuten pro Batch) und gibt ein JSON-Ergebnis aus; Exit-Code 1 bedeutet, dass der Batch fehlgeschlagen ist.
- Lies nach der Rückkehr des Befehls
asset_manifest.jsonauscwd. Behandle diese Datei als Quelle der Wahrheit. - Binde
manifest.assetsmit dem Three.jsGLTFLoaderin den Spielcode ein. - Halte für jedes generierte Asset einen lokalen primitiven Fallback bereit. Das Spiel muss spielbar bleiben, wenn ein GLB nicht lädt.
Beispiel --params JSON:
{
"cwd": "/absoluter/pfad/zum/projekt",
"gamePrompt": "3D-Läufer mit einer Astronautenkatze, die Kristalle sammelt und Patrouillenrobotern ausweicht",
"route": "gemini_reference",
"assets": [
{
"id": "astronauten-katze",
"role": "player",
"name": "Astronautenkatze",
"assetKind": "character",
"prompt": "originelle Low-Poly-Astronautenkatze als Held, runder Helm, kompakte lesbare Silhouette, blau-weißer Anzug, freundlicher Arcade-Spielcharakter"
},
{
"id": "energie-kristall",
"role": "collectible",
"name": "Energiekristall",
"assetKind": "prop",
"prompt": "heller cyanfarbener facettierter Energiekristall zum Aufsammeln, saubere Silhouette, Spiel-Sammelobjekt"
}
]
}
Laufzeit-Integrationsregeln
- Normalisiere jedes geladene GLB mit
THREE.Box3().setFromObject(): skaliere auf Zielgröße, zentriere horizontal, platziere die Unterseite beiy = 0und wende einen stabilen Ausrichtungs-Offset an. - Trenne visuelle Darstellung von Spiel-Hitboxen. Kollisionen sollten stabile Spieldimensionen verwenden, nicht rohe Modellgrenzen oder Mesh-Ursprünge.
- Wenn
manifest.assetsrigged,rigTypeoderanimationsenthält, überprüfe die geladenengltf.animations, bevor du native Animationen beanspruchst. - Wenn native Clips vorhanden sind, erstelle einen
THREE.AnimationMixer, ordne Clips anhand von case-insensitiven Substrings wieidle,walk,runundjumpzu und rufemixer.update(delta)in jedem Frame auf. - Wenn keine nativen Clips vorhanden sind, verwende als Fallback-Animation Bobbing/Kippen/Rotation der gesamten Gruppe oder explizit gekennzeichnete prozedurale Clips.
- Füge einen kurzen Abschnitt
README.mdmit dem Namen3D Asset Pipelineoder3D 素材流水线hinzu, der beschreibt, welche Assets generiert wurden, welche Route verwendet wurde und welche Laufzeit-Animationsquelle verwendet wird.
Fehlerbehandlung
- Asset-API nicht erreichbar (Bereitschaft meldet
unreachable): Erkläre, dass die Remote-Modellgenerierung nicht verfügbar ist, bitte den Benutzer, den Standard-Asset-Dienst, den Netzwerkzugriff und falls erforderlichGAME_ASSETS_API_TOKENzu überprüfen; frage nur nachGAME_ASSETS_API_URL, wenn der Standarddienst überschrieben werden muss. Behalte primitive Fallbacks bei und setze das spielbare Spiel fort. - Server fehlt Gemini-Schlüssel auf dem
gemini_reference-Weg: Wechsle zutripo, falls akzeptabel, oder teile dem Benutzer mit, dass der Serverbetreiber den Gemini-Schlüssel konfigurieren muss. - Tripo-Guthaben auf Null: Wiederhole nicht in einer Schleife. Behalte Fallbacks und protokolliere die übersprungene Stufe in der README.
- Teilweiser Erfolg: Verwende generierte Assets, die erfolgreich waren, und Fallback-Geometrie für den Rest.