Communitygithub.com

3D-Spiel-Assets

Fertigt für ein 3D-Spiel konkrete, wiedererkennbare GLB-Assets an, statt nur primitiver Geometrie. Der Skill steuert den gesamten Workflow von der Routenauswahl über die Generierung bis zur Integration in das Spiel.

Was ist 3D-Spiel-Assets?

Dieser Skill generiert prozessgesteuert 3D-Assets (GLB-Dateien) für Spiele und integriert sie über eine Asset-Manifest-Datei. Er wählt automatisch den optimalen Generierungsweg: den schnellen `tripo`-Weg (Text-zu-Modell) oder den visuell kontrollierten `gemini_reference`-Weg (Bild-zu-Modell). Der Skill unterstützt Claude Code, Cursor und Codex und kann sowohl über MCP-Tools als auch über ein mitgeliefertes Bash-Skript (`scripts/game-assets-mcp.mjs`) gesteuert werden. Er generiert standardmäßig 1-3 Schlüssel-Assets (z. B. Spieler, Gegner, Sammelobjekte) und erstellt immer eine geometrische Fallback-Geometrie für den Fall, dass ein GLB nicht lädt, sodass das Spiel jederzeit spielbar bleibt. Der Skill vermeidet urheberrechtlich geschütztes Material und verwaltet den gesamten Lebenszyklus: Generierung, Manifest-Verwaltung und Integration in den Spielcode mit Animationen und Kollisionserkennung.

Funktioniert mit~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add 674345386/agent-skills

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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.json bereits 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-URL
  • GAME_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.

  1. Führe pwd aus, wenn du den aktuellen Arbeitsbereichspfad noch nicht kennst.
  2. 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)"
  1. 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_reference oder auto.
  • assets: 1-3 Objekte mit stabiler, kebab-case id, role, name, prompt und optional assetKind.
  • 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.
  1. Lies nach der Rückkehr des Befehls asset_manifest.json aus cwd. Behandle diese Datei als Quelle der Wahrheit.
  2. Binde manifest.assets mit dem Three.js GLTFLoader in den Spielcode ein.
  3. 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 bei y = 0 und 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.assets rigged, rigType oder animations enthält, überprüfe die geladenen gltf.animations, bevor du native Animationen beanspruchst.
  • Wenn native Clips vorhanden sind, erstelle einen THREE.AnimationMixer, ordne Clips anhand von case-insensitiven Substrings wie idle, walk, run und jump zu und rufe mixer.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.md mit dem Namen 3D Asset Pipeline oder 3D 素材流水线 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 erforderlich GAME_ASSETS_API_TOKEN zu überprüfen; frage nur nach GAME_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 zu tripo, 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.

Verwandte Skills