prop-model

Prop Model — Generate One Static 3D Prop and Wire It

One prop, one mesh, one MeshInstance3D. This is the bread-and-butter call of the 3D-asset family — most game-world objects are static props. The skill exists to keep two things tight: the prompt shape that produces a clean isolated mesh on the first try, and the wire-in pattern that gets the asset into the scene without leaving orphans in res://assets/models/.

The backing tool is onyx_generate_3d. Default model is hunyuan (Hunyuan 3D v3.1 Pro — best quality). Use trellis when speed matters (Trellis 2 is ~2× faster, slightly lower fidelity). meshy is the legacy fallback — only pick it if the user asks by name.

When to use

• "Make me a treasure chest."
• "Generate a viking axe."
• "I need a wooden barrel for the cellar."
• "Create a sci-fi crate."
• Any single, static, non-character, non-modular object the player will see in 3D space.

When NOT to use

• Character / humanoid → onyx:3d-assets/character-model (needs T-pose + rig pass).
• A set of matching pieces (walls, floors, doors, pillars) → onyx:3d-assets/environment-kit (style-locked family).
• Trees, rocks, foliage → onyx:3d-assets/organic-model (organic forgives AI artifacts; cheaper recipe).
• Cars, ships, mechs → onyx:3d-assets/vehicle-model (hard-surface specifics).
• Walls / floors / repeating geometry → onyx:asset-pipeline/asset-strategy Pipeline 2 (textures + CSG).
• "I just need a placeholder" → propose a primitive (BoxMesh / CylinderMesh) instead. Generation is metered.

Steps

1. Search before generating

onyx_search_assets(query="<prop name>", assetType="3d_model", source="all")

If a fitting model exists, propose reuse:

Found assets/models/treasure_chest_01.glb. Reuse this, or generate fresh?

2. Pick a polycount target

Use case	Tris	Pass via
Hero prop (sword on hip, key item)	3k–8k	options: { target_polycount: 5000 }
Background prop (crate, barrel, sack)	200–800	options: { target_polycount: 600 }
Mid-range interactive (chest, lantern)	1k–3k	options: { target_polycount: 2000 }
Cinematic showcase (throne, statue)	10k–30k	options: { target_polycount: 20000 }