SKILL.md
Blockbench Plugin Development
Overview
Blockbench runs on desktop and the web, exposing host APIs and bundled rendering/UI libraries to plugins. Verify the target host version and its types before choosing APIs; plugin variable isolation does not imply unrestricted native-module or filesystem access. Prefer the current generated API reference and the target checkout when older wiki examples disagree with the host. Set variant and min_version to the environments actually verified.
For model format decisions, UV units, rig distinctions and export handoffs, see format and delivery guidance. A format feature flag advertises host behavior; it does not implement missing validation or runtime serialization in a custom codec.
Quick Reference
| Task | Approach |
|---|---|
| Create clickable command | new Action() - add to menus/toolbars |
| Show form/dialog | new Dialog() with form fields |
| Add sidebar panel | new Panel() with Vue component |
| Modify model elements | Use Undo.initEdit() → modify → Undo.finishEdit() |
| Custom import/export | new Codec() + new ModelFormat() |
| React to changes | Blockbench.on('event_name', callback) |