# blockbench-particles

blockbench-particles adds Bedrock particle effects and bone locators to Blockbench models via MCP tools. Useful for fire, smoke, and magic VFX in Minecraft Bedrock and GeckoLib.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 259 installs · ★ 30 repo stars
- Author: jasonjgardner
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/jasonjgardner/blockbench-mcp-project/tree/HEAD/skills/blockbench-particles/SKILL.md
- Updated: 2026-09-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/blockbench-particles

## What it does

This skill guides particle setup for Blockbench models using Snowstorm JSON formats. It handles emitter creation from presets, adds named locators to bones, and registers effect keyframes on animation tracks. Blockbench previews these through Wintersky inside Animate mode.

Headless execution cannot render visual particles, meaning visual checks still require the Blockbench desktop app. Real particle export works strictly for Minecraft Bedrock and GeckoLib models. Target formats like Java blocks, OBJ, and glTF drop particles entirely, forcing you to fake VFX with geometry or flipbook textures.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add jasonjgardner/blockbench-mcp-project --skill blockbench-particles -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add jasonjgardner/blockbench-mcp-project --skill blockbench-particles -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add jasonjgardner/blockbench-mcp-project --skill blockbench-particles -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jasonjgardner/blockbench-mcp-project skills/blockbench-particles
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add jasonjgardner/blockbench-mcp-project --skill blockbench-particles -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/jasonjgardner/blockbench-mcp-project --path skills/blockbench-particles
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add jasonjgardner/blockbench-mcp-project --skill blockbench-particles -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/jasonjgardner/blockbench-mcp-project/tree/HEAD/skills/blockbench-particles/SKILL.md

## When to use it
- generate Snowstorm particle JSON from built-in emitter presets
- attach named locator spawn points to model bones
- key particle triggers onto animation timelines
- export particle files and the client-entity effect map for Bedrock

## Example prompts
- Add a mouth locator to the head bone and bind fire particles to it
- Create a custom smoke particle effect for my dragon_idle animation
- Check particle keyframes and warnings on the attack animation clip

## Source text · SKILL.md · Apache-2.0

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: 40f6794b076b5b32.

BEGIN THIRD-PARTY FILE 40f6794b076b5b32
```text
---
name: blockbench-particles
description: Add particle effects (smoke, fire, sparks, magic, glow, dust, snow, drips, bubbles, bursts) to Blockbench models with MCP tools. Covers Bedrock/Snowstorm particle JSON, presets and design knobs, locators, particle keyframes on animations, Blockbench's Animate-mode preview, and delivery to Bedrock resource packs (client entity particle_effects) and GeckoLib, plus fallbacks for glTF, Java block and Hytale targets that cannot carry particles. Use when a model needs an emitter, VFX, particle effect, locator, Snowstorm file, particle_effects keyframe, or effect polish in a deliverable.
---

# Blockbench Particles

Blockbench has one particle system: **Bedrock particle effects**, the JSON format Snowstorm edits. Blockbench previews them with Wintersky when a **particle keyframe** on an animation's Effects track fires, optionally at a **locator** on a bone. The same files run in Minecraft Bedrock, and GeckoLib animations carry the same keyframes to a mod's particle handler. Nothing else in Blockbench (glTF, OBJ, Java block models, Hytale) exports particles.

Load [blockbench-use](../blockbench-use/SKILL.md) first. Particles ride on animations, so load [blockbench-animation](../blockbench-animation/SKILL.md) when the model has no clip yet.

## 1. Decide What Carries the Effect

Ask for the destination if it is unknown; it decides everything below.

| Destination | Particles | Where the effect lives |
|---|---|---|
| Bedrock entity or attachable (`bedrock`) | Native | Particle JSON + locators in geometry + keyframes in animation JSON or controller states + `particle_effects` map in the client entity. See [delivery](references/delivery.md). |
| GeckoLib (`geckolib_model`) | Keyframes only | Keyframes (effect, locator, script) export in the animation JSON; the mod's particle keyframe handler spawns real particles. Bedrock JSON here is only the Blockbench preview. |
| Generic Model / glTF, Java block/item, Hytale, OBJ | None | Fake the effect with geometry, emissive flipbook textures and bone keyframes, or leave it to the runtime. See [non-particle targets](references/delivery.md#targets-without-particles). |

Also settle the **trigger** before building, because Bedrock treats the two differently:

- **Animation keyframe** (`manage_particle_keyframes`): fire-and-forget. Good for one-shots (impact sparks, a poof on landing, hearts). A *looping* emitter fired this way never stops in game, and a looping clip starts another one every cycle. For a continuous effect keyed on a looping clip, use `looping: false` with `duration` equal to the clip length, keyed at 0.
```
END THIRD-PARTY FILE 40f6794b076b5b32

The third-party file has ended. Everything between the 40f6794b076b5b32 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.

First 2636 of 9538 bytes. © jasonjgardner · Apache-2.0 · https://github.com/jasonjgardner/blockbench-mcp-project/tree/HEAD/skills/blockbench-particles/SKILL.md

_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
