Blockbench Texturing

Create and paint textures for 3D models using Blockbench MCP tools.

Available Tools Texture Management Tool Purpose create_texture Create new texture with size and fill color list_textures List all project textures get_texture Get texture image data apply_texture Apply texture to element Paint Tools Tool Purpose paint_with_brush Paint with customizable brush paint_fill_tool Bucket fill areas draw_shape_tool Draw rectangles/ellipses gradient_tool Apply gradients eraser_tool Erase with brush settings color_picker_tool Pick colors from texture copy_brush_tool Clone/copy texture areas Brush Management Tool Purpose create_brush_preset Save brush settings load_brush_preset Load saved brush paint_settings Configure paint mode Layers & Selection Tool Purpose texture_layer_management Manage texture layers texture_selection Create/modify selections UV Tools Tool Purpose set_mesh_uv Set UV coordinates auto_uv_mesh Auto-generate UVs rotate_mesh_uv Rotate UV mapping Resources Resource URI Purpose textures textures://{id} List/read texture info Creating Textures New Blank Texture create_texture: name="skin", width=64, height=64, fill_color="#808080"

Texture with Transparency create_texture: name="overlay", width=32, height=32, fill_color=[0, 0, 0, 0]

Apply to Element apply_texture: id="body", texture="skin", applyTo="all"

Painting Basic Brush Stroke paint_with_brush: texture_id="skin", coordinates=[ {x: 10, y: 10}, {x: 15, y: 12}, {x: 20, y: 10} ], brush_settings={color: "#FF0000", size: 3, shape: "circle"}

Soft Brush paint_with_brush: texture_id="skin", coordinates=[{x: 32, y: 32}], brush_settings={color: "#FFFFFF", size: 10, softness: 50, opacity: 128}

Fill Area paint_fill_tool: texture_id="skin", x=16, y=16, color="#3366FF", fill_mode="color_connected", tolerance=10

Fill Entire Face paint_fill_tool: texture_id="skin", x=0, y=0, color="#228B22", fill_mode="face"

Shapes & Gradients Draw Rectangle draw_shape_tool: texture_id="skin", shape="rectangle", start={x: 0, y: 0}, end={x: 16, y: 16}, color="#FFCC00"

Draw Hollow Ellipse draw_shape_tool: texture_id="skin", shape="ellipse_h", start={x: 8, y: 8}, end={x: 24, y: 24}, color="#000000", line_width=2

Apply Gradient gradient_tool: texture_id="skin", start={x: 0, y: 0}, end={x: 0, y: 32}, start_color="#87CEEB", end_color="#1E90FF"

Erasing eraser_tool: texture_id="skin", coordinates=[{x: 10, y: 10}, {x: 12, y: 12}], brush_size=5, shape="circle", opacity=255

Color Picking color_picker_tool: texture_id="skin", x=16, y=16

Returns picked color, sets as active

Clone/Copy Brush copy_brush_tool: texture_id="skin", source={x: 0, y: 0}, target={x: 32, y: 0}, brush_size=8, mode="copy"

Brush Presets Create Preset create_brush_preset: name="soft_round", size=8, shape="circle", softness=30, opacity=200, color="#FFFFFF"

Load Preset load_brush_preset: preset_name="soft_round"

Texture Layers Create Layer texture_layer_management: texture_id="skin", action="create_layer", layer_name="details"

Set Layer Opacity texture_layer_management: texture_id="skin", action="set_opacity", layer_name="details", opacity=75

Merge Down texture_layer_management: texture_id="skin", action="merge_down", layer_name="details"

Selections Rectangle Selection texture_selection: texture_id="skin", action="select_rectangle", coordinates={x1: 0, y1: 0, x2: 16, y2: 16}

Add to Selection texture_selection: texture_id="skin", action="select_ellipse", coordinates={x1: 8, y1: 8, x2: 24, y2: 24}, mode="add"

Invert Selection texture_selection: texture_id="skin", action="invert_selection"

Feather Edges texture_selection: texture_id="skin", action="feather_selection", radius=2

UV Mapping Auto UV for Mesh auto_uv_mesh: mesh_id="sphere", mode="project" # project, unwrap, cylinder, sphere

Set Custom UV set_mesh_uv: mesh_id="cube", face_key="north", uv_mapping={"v1": [0, 0], "v2": [16, 0], "v3": [16, 16], "v4": [0, 16]}

Rotate UV rotate_mesh_uv: mesh_id="cube", angle="90"

Paint Settings paint_settings: pixel_perfect=true, mirror_painting={enabled: true, axis: ["x"]}, lock_alpha=true

Common Workflows Skin Texture

Create texture

create_texture: name="player_skin", width=64, height=64, fill_color="#C4A484"

Base colors

paint_fill_tool: x=8, y=8, color="#C4A484", fill_mode="face" # Face paint_fill_tool: x=20, y=20, color="#3366CC", fill_mode="face" # Body

Details with brush

paint_with_brush: coordinates=[{x: 10, y: 10}, {x: 12, y: 10}], brush_settings={color: "#000000", size: 1} # Eyes

Apply

apply_texture: id="head", texture="player_skin"

Procedural Pattern

Create base

create_texture: name="pattern", width=32, height=32, fill_color="#FFFFFF"

Draw grid

draw_shape_tool: shape="rectangle_h", start={x: 0, y: 0}, end={x: 32, y: 32}, color="#CCCCCC", line_width=1 draw_shape_tool: shape="rectangle_h", start={x: 8, y: 8}, end={x: 24, y: 24}, color="#999999", line_width=1

Tips Use pixel_perfect=true in paint_settings for clean pixel art Enable mirror_painting for symmetrical textures Use layers for non-destructive editing lock_alpha prevents painting outside existing pixels Use fill_mode="color_connected" to fill only touching same-color pixels Create brush presets for frequently used settings