add-3d-models

Add and author GLB 3D models in Decentraland scenes using GltfContainer, an asset catalog, and Blender.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/stom66/dcl-bowling --skill add-3d-models-stom66
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-3d-models
Source: https://github.com/stom66/dcl-bowling/tree/main/agent/skills/add-3d-models
Command: npx skills add https://github.com/stom66/dcl-bowling --skill add-3d-models-stom66

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Placing 3D models in a Decentraland scene involves many silent failure modes — models extending beyond parcel bounds, wrong collider masks, missing Animator components, Z-up exports loading tipped over — and this Skill encodes the rules and workflows to get models placed, colliding, and animating correctly the first time. ## Core Features & Use Cases - Model placement with GltfContainer: Enforces bounding-box audits, safe placement zones, correct collision mask patterns, Animator setup, and composite vs. TypeScript placement rules. - OpenDCL catalog integration: Search and download from 8,800+ free GLB models with dimensions, triangle counts, and animation metadata, then wire them into the scene. - Blender authoring and editing: Create, retexture, optimize, or convert models by driving Blender headless via CLI or live through the Blender MCP, with low-poly, PBR, palette-texture, and collider rules plus ready-made bpy scripts. - Use Case: A user asks to add a tree line to their scene — the Skill checks the catalog, downloads a GLB, computes its real bounding box accounting for node scale, places it within safe parcel margins, and sets the correct collision masks. ## Quick Start Add a tree model from the free catalog to my Decentraland scene at position 8,0,8 with proper colliders.

Frequently Asked Questions about add-3d-models

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a 3D model to a Decentraland scene?▼

Use GltfContainer with the src pointing to a local GLB file under assets/Models/, either in TypeScript for runtime-spawned entities or in assets/scene/main.composite for models present at scene load. Always verify the model's bounding box and set collision masks before placing it.

Where can I find free 3D models for Decentraland?▼

The OpenDCL catalog offers over 8,800 free GLB models searchable by keyword, with dimensions, triangle counts, and animation clips listed per model. Download with curl into assets/Models/ and reference the local path in GltfContainer, since remote URLs are not supported.

Why is my GLB model invisible in the Decentraland scene?▼

Common causes are a wrong file path, a position outside the 16x16 m parcel bounds, zero or tiny scale, or a Z-up export that loads tipped over. Entities fully outside scene parcels are not rendered and produce no error message.

What collision mask should I use for GltfContainer?▼

If the GLB has _collider meshes, use visibleMeshesCollisionMask 0 and invisibleMeshesCollisionMask 3; if it has none, use visible 3 and invisible 0. Never set both masks to non-zero, as mixing the patterns breaks pointer detection.

Can I create or edit Decentraland models in Blender?▼

Yes, either headless via blender --background --python scripts or live through the Blender MCP when its tools are connected. Models must stay low-poly, use Principled BSDF PBR materials, contain no lights or cameras, and export as binary GLB with Y-up orientation.

Why does my model play the wrong animation or loop forever?▼

The engine silently loops the first animation clip when no Animator component is present. Always check whether the GLB contains animations and add an Animator with explicit states; when exporting from Blender, use ACTIVE_ACTIONS mode so unrelated actions do not leak into the GLB.