# physics-sim

physics-sim — a skill for Claude Code configures rigid and soft body simulations and destruction setups in Blender via MCP. The agent loads it when handling physics and collapse tasks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 531 installs · ★ 4589 repo stars
- Author: https://github.com/arjun988
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/physics-sim/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/physics-sim

## What it does

The skill manages rigid and soft body dynamics, cell fracture debris, constraints, and cache baking inside Blender. Workflows rely on simplified collision meshes, applied object scale, and baked caches prior to Alembic or USD export. Soft body props utilize goal weights for shape retention, while destruction setups depend on pre-cut shards and passive shells activated on specific frames.

Execution requires a working Blender setup and MCP access for scene control. High-resolution sculpt meshes must not be used as active colliders, and simulations require baking before final export.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill physics-sim -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/physics-sim/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/physics-sim/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill physics-sim -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/physics-sim/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill physics-sim -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/physics-sim/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install arjun988/blender-skills .claude/skills/physics-sim
```

2. **Manually: put the files in place**
- File: `.github/skills/physics-sim/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill physics-sim -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/physics-sim
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/physics-sim/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill physics-sim -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/physics-sim/SKILL.md

## When to use it
- set up rigid body collapses
- configure cell fracture destruction
- bake simulation caches in Blender
- setup soft body deformation props

## Example prompts
- Set up rigid body physics for falling debris
- Configure a wall destruction simulation with cell fracture
- Bake the soft body cache before export

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 8d2aa9ed4f2a1e04.

BEGIN THIRD-PARTY FILE 8d2aa9ed4f2a1e04
````text
---
name: physics-sim
description: Rigid body, soft body, and destruction setups in Blender including constraints, cell fracture debris, and baked caches via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: physics, rigid body, soft body, destruction, fracture, debris, constraint, simulation bake, collapse
  related-skills: vfx-fx, cloth-sim, animation, export-pipeline, collision-proxy
---

# Physics Sim

Stable rigid/soft body setups. Motivated destruction. Baked caches.

## When to Use

- Rigid body interactions and collapses
- Soft body jiggle / rubber / simple soft props
- Destruction and debris (cell fracture / pre-cut shards)
- Pre-vis physics before VFX polish

## Workflow

```
Simplify collision meshes → Assign rigid/soft bodies
  → Constraints → Passive settings → Bake → Art-direct → Export cache
```

## Rigid Body Quick Rules

| Role | Settings notes |
|------|----------------|
| Active | Moving debris / props |
| Passive | Floors, walls, heavy anchors |
| Convex hull | Fast, approximate |
| Mesh | Accurate, heavier |

- Apply scale before sim
- Use margin appropriate to scale
- Collection: `COL_Physics_[Shot]`

## Constraints

- Hinge / fixed / motor for mechanical links
- Breakable constraints for destruction beats
- Name: `RBCON_[Object]_[Type]`

## Destruction Approach

```
1. Pre-cut shards (cell fracture or manual)
2. Island meshes as active rigid bodies
3. Passive shell until trigger frame
4. Animate trigger (force / keyframed activation)
5. Bake → cleanup interpenetrations
```

## Soft Body

- Prefer for simple soft props; use `cloth-sim` for garments
- Goal weights to retain shape
- Soft + collision object required

## Bake / Export

- Bake to cache before render
- Alembic/USD for cinematic debris
- For games: bake key poses or flipbook; rarely live Blender physics

## Constraints

### MUST DO
- Apply scale; use simplified colliders
- Bake before final delivery
- Trigger destruction intentionally (frame)

### MUST NOT DO
- High-res sculpt meshes as active colliders
- Unbounded shard counts
- Leave sims unbaked for final renders

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|----------|
| Rigid Body Presets | `references/rigid-body-presets.md` | When needed |
| Destruction Pipeline | `references/destruction-pipeline.md` | When needed |
| Sim Bake Checklist | `references/sim-bake-checklist.md` | When needed |
````
END THIRD-PARTY FILE 8d2aa9ed4f2a1e04

The third-party file has ended. Everything between the 8d2aa9ed4f2a1e04 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/physics-sim/SKILL.md

## Similar
- [blender-simulation](https://affpapa.org/en/nevibecode/skills/blender-simulation.md) — skill · 504 installs
- [blender-optics-simulator](https://affpapa.org/en/nevibecode/mcp/blender-optics-simulator.md) — MCP server · ★ 38 repo stars
- [scenario-blender](https://affpapa.org/en/nevibecode/skills/scenario-blender.md) — skill · 654 installs
- [physics-rendering-expert](https://affpapa.org/en/nevibecode/skills/physics-rendering-expert.md) — skill · 201 installs
- [physics-simulation](https://affpapa.org/en/nevibecode/skills/physics-simulation.md) — skill · 187 installs
- [cli-anything-blender](https://affpapa.org/en/nevibecode/skills/cli-anything-blender.md) — skill · 1100 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
