Blockbench MCP Plugin

Place Cube

Places a cube of the given size at the specified position. Texture and group are optional.

Modify Cube

Modifies the cube with the given ID. Auto UV setting: saved as an integer, where 0 means disabled, 1 means enabled, and 2 means relative auto UV (cube position affects UV)

Capture Screenshot

Returns the image data of the current view.

Capture App Screenshot

Returns the image data of the Blockbench app.

Set Camera Angle

Sets the camera angle to the specified value.

Create Animation

Creates a new animation with keyframes for bones.

Manage Keyframes

Creates, deletes, or edits keyframes in the animation timeline for specific bones and channels.

Animation Graph Editor

Controls animation curves in the graph editor for fine-tuning animations.

Bone Rigging

Creates and manipulates the bone structure (rig) of a model for animation.

Animation Timeline

Controls the animation timeline, including playback, time scrubbing, and timeline settings.

Batch Keyframe Operations

Performs batch operations on multiple keyframes at once.

Animation Copy/Paste

Copies and pastes animation data between bones or animations.

List Armatures

Lists all armatures in the current project with their basic info.

Get Armature

Gets detailed information about a specific armature including its bones.

Add Armature

Creates a new armature in the project. An armature is a skeletal rig used for mesh deformation.

Remove Armature

Removes an armature and all its bones from the project.

Update Armature

Updates properties of an existing armature.

List Armature Bones

Lists all armature bones, optionally filtered by a specific armature.

Get Armature Bone

Gets detailed information about a specific armature bone.

Add Armature Bone

Creates a new bone and adds it to an armature or parent bone.

Remove Armature Bone

Removes an armature bone from the project.

Update Armature Bone

Updates properties of an existing armature bone.

Update Armature Bones (Batch)

Updates multiple armature bones at once with the same properties.

Select Armature Bones

Selects armature bones by ID. Can select single bone, multiple bones, or bone hierarchy.

Get Vertex Weights

Gets vertex weights for a mesh from all bones affecting it.

Set Vertex Weight

Sets the weight of a specific vertex on a bone.

Set Vertex Weights (Batch)

Sets multiple vertex weights at once on a bone.

Clear Vertex Weights

Clears all vertex weights from a bone for a specific mesh.

Remove Element

Removes the element with the given ID.

Add Group

Adds a new group with the given name and options.

List Outline

Returns a list of all groups and their children in the Blockbench editor.

Duplicate Element

Duplicates a cube, mesh or group by ID or name. You may offset the duplicate or assign a new name.

Rename Element

Renames a cube, mesh or group by ID or name.

Import GeoJSON

Imports a model from a GeoJSON file.

Get Face Material Instances

Gets the material instance names for cube faces. Material instances are used in Bedrock Block format to map faces to materials defined in the minecraft:material_instances component.

Set Face Material Instance

Sets the material instance name for one or more cube faces. Material instances are strings that map to materials defined in the minecraft:material_instances component for Bedrock Block format.

List Material Instances

Lists all unique material instance names used in the project. Returns the material instance names along with which cubes and faces use them.

Bulk Set Material Instances

Sets material instance names on multiple cubes at once. Useful for assigning different material instances to different faces across the project.

Clear Material Instances

Clears (removes) material instance names from cube faces. Useful for resetting material assignments.

Place Mesh

Places a mesh at the specified position. Texture and group are optional.

Extrude Mesh

Extrudes selected faces or edges of a mesh.

Subdivide Mesh

Subdivides selected faces of a mesh to create more geometry.

Create Sphere

Creates a sphere mesh at the specified position with the given parameters. The sphere is created as a mesh with vertices and faces using spherical coordinates.

Select Mesh Elements

Selects vertices, edges, or faces of a mesh for manipulation.

Move Mesh Vertices

Moves selected vertices of a mesh by the specified offset.

Delete Mesh Elements

Deletes selected vertices, edges, or faces from a mesh.

Merge Mesh Vertices

Merges vertices that are within a specified distance of each other.

Create Mesh Face

Creates a new face from selected vertices.

Create Cylinder

Creates one or more cylinder meshes with optional end caps.

Knife Tool

Uses the knife tool to cut custom edges into mesh faces.

Paint Fill Tool

Uses the fill/bucket tool to fill areas with color.

Draw Shape Tool

Draws geometric shapes on textures.

Gradient Tool

Applies gradients to textures.

Color Picker Tool

Picks colors from textures and sets them as the active color.

Copy Brush Tool

Uses the copy/clone brush to copy texture areas.

Eraser Tool

Erases parts of textures with customizable settings.

Paint Settings

Configures paint mode settings and preferences.

Paint with Brush

Paints on textures using the brush tool with customizable settings.

Create Brush Preset

Creates a custom brush preset with specified settings.

Load Brush Preset

Loads and applies a brush preset by name.

Texture Selection

Creates, modifies, or manipulates texture selections for painting.

Texture Layer Management

Creates, manages, and manipulates texture layers.

Create Project

Creates a new project with the given name and project type.

Create Texture

Creates a new texture with the given name and size.

Apply Texture

Applies the given texture to the element with the specified ID.

Add Texture Group

Adds a new texture group with the given name.

List Textures

Returns a list of all textures in the Blockbench editor.

Get Texture

Returns the image data of the given texture or default texture.

Create PBR Material

Creates a new PBR material (texture group with is_material=true) and optionally assigns textures to PBR channels. Use this for Minecraft Bedrock resource packs or any format supporting PBR.

Configure Material

Configures an existing PBR material's properties including channel assignments, uniform values, and subsurface scattering.

List Materials

Lists all PBR materials (texture groups with is_material=true) and their assigned textures per channel.

Get Material Info

Gets detailed information about a PBR material including the compiled texture_set.json preview for Bedrock export.

Import Texture Set

Imports a Minecraft Bedrock texture_set.json file and creates a PBR material with the associated textures.

Assign Texture Channel

Assigns a texture to a specific PBR channel within a material.

Save Material Config

Saves the material's texture_set.json file to disk (Bedrock format). Requires the color texture to have a valid file path.

Trigger Action

Triggers an action in the Blockbench editor.

Eval

Evaluates the given expression and logs it to the console. Do not pass `console` commands as they will not work.

Emulate Clicks

Emulates clicks on the given interface elements.

Fill Dialog

Fills the dialog with the given values.

Set Mesh UV

Sets UV coordinates for mesh faces or vertices.

Auto UV Mesh

Automatically generates UV mapping for selected mesh faces.

Rotate Mesh UV

Rotates UV coordinates of selected mesh faces.

Get Hytale Format Info

Returns information about the current Hytale format. Requires the Hytale plugin and a Hytale format project to be active.

Validate Hytale Model

Validates the current Hytale model against Hytale engine constraints (node count, UV sizes, etc.).

Set Hytale Cube Properties

Sets Hytale-specific properties on a cube: shading_mode (flat, standard, fullbright, reflective) and double_sided.

Get Hytale Cube Properties

Gets Hytale-specific properties from a cube (shading_mode, double_sided).

Create Hytale Quad

Creates a Hytale quad (2D plane) with a specified normal direction. Quads are single-face elements useful for flat surfaces.

List Hytale Attachments

Lists all attachment collections in the current Hytale project.

Set Attachment Piece

Marks or unmarks a group as an attachment piece. Attachment pieces attach to like-named bones in the main model.

List Attachment Pieces

Lists all groups marked as attachment pieces.

Create Visibility Keyframe

Creates a visibility keyframe for a bone. Hytale supports toggling node visibility at keyframes.

Set Animation Loop Mode

Sets the loop mode for a Hytale animation. Hytale supports "loop" (continuous) or "hold" (freeze on last frame).

Set Cube Stretch

Sets the stretch values for a cube. Hytale uses stretch instead of float sizes for better UV handling.

Get Cube Stretch

Gets the stretch values for a cube.