Create and paint textures in Blockbench using MCP tools. Use when creating textures, painting on models, using brush tools, filling colors, drawing shapes, applying gradients, managing texture layers, or working with UV mapping. Covers pixel art texturing, procedural painting, and UV manipulation.

Blockbench Texturing Create and paint textures for 3D models using Blockbench MCP tools. Plan UVs Before Texture Detail Inspect the target's box/per face UV mode and effective UV dimensions before painting. UV units can differ from image pixels; formats with per texture uv size use each face's texture dimensions. Preserve deliberate mirrored/repeated UV overlaps, and allocate unique space for asymmetric detail. Preview a checker or directional mark for stretching, orientation and seams. Match pixel density to the user's style and viewing distance; Minecraft pixel art rules do not apply to every format. See [format and delivery guidance](../blockbench use/references/formats and delivery.md). Blockbench's native texture template workflow can lay out UVs, but create texture creates/imports an image and does not generate that layout. auto uv mesh maps faces and does not pack islands. For packed layouts, use a tool actually advertised by the running bundle or the native template/UV workflow; preserve an existing painted atlas before rearranging it. Generate a Native Texture Template For a new atlas, enter a supported Edit mode and establish the intended outliner selection, then open the native action without accepting its defaults: Inspect the returned app screenshot/dialog before using fill dialog . The current native dialog commonly has name , type="template" , resolution (pixel density), rearrange uv , double use (reuse matching faces), power , and padding . Send only fields present in that host's dialog. Example after inspecting its defaults: Choose density, overlap reuse and padding for the target; the template's resolution is not a requested final atlas width. An empty outliner selection may select the whole model, and single texture formats can process all eligible visible elements even with a partial selection. Check the operation's scope before confirming, especially on painted content. Generation may continue asynchronously: verify list textures , actual UVs and get texture after completion before painting. fill dialog: confirm=false cancels the dialog; it is not a way to fill fields and leave it open. See the [native texture generator](https://github.com/JannisX11/blockbench/blob/master/js/texturing/texture generator.js) and [official template workflow](https://blockbench.net/wiki/guides/bedrock modeling/). Paint coordinates are image pixels. Pass an explicit texture id to each paint tool when more than one texture exists. Layers and selections affect native painting; inspect the selected layer and existing selection before painting. layer name names a new/renamed layer; for most layer actions the tool operates on the currently selected layer rather than resolving an arbitrary layer by name. 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 activate texture Select an existing texture 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 get mesh info Read mesh face/vertex keys and existing UVs with include uv=true get cube uv Inspect box/per face UVs, effective face texture, UV dimensions and bitmap dimensions set cube uv Edit box offset/mirroring or per face rectangles, rotations and texture references Resources Resource URI Purpose textures textures://{id} List/read texture info Creating Textures New Blank Texture Texture with Transparency Separate UV Dimensions from Bitmap Resolution In a format with per texture uv size=true , create texture accepts uv width and uv height together as positive numbers. Omit both to preserve the native defaults. The pair also works when importing image data ; it sets logical UV dimensions after image decoding without resizing the bitmap. This static image has four pixels per UV unit on each axis. Multiple textures can have different UV sizes in the same project, so use the face's effective texture dimensions for mapping. list textures exposes uv size , bitmap size , and frame size in the current bundle. Formats with project wide UV dimensions reject per texture overrides; inspect and edit the native project UV size settings instead. Changing logical dimensions can change existing mapping, so preserve the intended pixel density and verify the result. Apply to Element create texture requires layer name whenever fill color is supplied. Texture lookups accept a name or UUID; use the UUID from list textures when names are ambiguous. Painting Basic Brush Stroke Soft Brush Fill Area The native fill API supports exact color matching only; nonzero tolerance is rejected. Face/element fill modes depend on native geometry/UV context. Texture pixel coordinates alone do not identify a model face. Use explicit rectangular painting for a known UV rectangle, or establish and verify the native target context before face filling. Inspect the result; a success message alone does not prove that only the intended face changed. Shapes & Gradients Draw Rectangle Draw Hollow Ellipse Apply Gradient Erasing Color Picking Clone/Copy Brush Brush Presets Create Preset Load Preset Texture Layers Create Layer Set Layer Opacity Merge Down Selections Rectangle Selection Add to Selection Invert Selection Feather Edges UV Mapping Cube UVs Confirm get cube uv and set cube uv are advertised by get capabilities: include tools=true ; older loaded bundles need reloading before these tools are available. Use a cube's actual UUID as id when a group has the same name. Choose the example matching the cube's inspected mode; box offsets and face rectangles are different workflows. Changing modes requires an explicit box uv argument and a format that permits it; native conversion can reset rotations and enable disabled faces. The tool verifies that conversion succeeded and rolls back a refused conversion. Nonzero face rotations require the format's uv rotation support. Explicit rectangles normally disable automatic remapping; Hytale preserves autouv=1 and requires rectangle extents to match the absolute base face dimensions, swapping width/height for 90/270 degree UV rotation. Matching offsets and mirrors are allowed, while changed extents are rejected before Undo. Hytale quads cannot use box UV. See the [Hytale native UV behavior](https://github.com/JannisX11/hytale blockbench plugin/blob/main/src/element.ts). Per face texture accepts an existing texture name/UUID, false for unassigned, or null to disable the face. Single texture and per group texture formats restrict per face assignments; use their existing global/group workflow. Hytale resolves textures through an attachment collection or the project default even when single texture=false ; the tool rejects non null per face assignments there. Reinspect after edits, including effective texture , uv size , bitmap size , and frame size . Convert UVs to pixels within a frame using frame size / uv size on each axis; bitmap size includes the entire animated atlas. For a frame 64 pixels across 16 UV units, a UV coordinate of 4 is frame X=16. Auto UV for Mesh project uses the active preview camera; unwrap creates an independent planar mapping per face and does not pack UV islands. cylinder and sphere use the mesh local origin and each mapped face's effective UV dimensions, so inspect texture assignments first. Pass explicit returned face keys in faces to target only part of a mesh. Set Custom UV Mesh face and vertex keys are generated at runtime; cube direction names are not mesh face IDs. Retain the meshes[] entry returned by place mesh as shown in [the modeling skill](../blockbench modeling/SKILL.md), or inspect an existing mesh using get mesh info with include uv=true . This client orchestration example continues with the quad panel created in the modeling skill. call invokes the named MCP tool, checks isError , and decodes JSON results; variable expressions must be bound to actual returned values before sending tool arguments. UV values use Blockbench texture units, not normalized 0–1 coordinates. For existing faces, use faces.items[].key and that face's vertices perimeter order from inspection; key the UV map with those exact vertex IDs. Read each page using its independent next offset until null , without geometry edits between pages. See the modeling skill's readMeshPages helper; add include uv: true when reading existing UVs. Reinspect after topology changes. Rotate UV Paint Settings Common Workflows Paint an Existing Skin Layout Use the target skin's actual UV template. The following coordinates are only examples for regions already confirmed in that template; a blank image and these strokes do not construct a valid player skin automatically. Procedural Pattern Tips Use pixel perfect=true in paint settings for clean pixel art Enable mirror painting only after confirming the intended symmetry and native target context; disable it for asymmetric detail 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 paint with brush connects points by default; set connect strokes=false for separate stamps such as eyes or spots Inspect both get texture and the rendered model after meaningful paint changes. For tiling blocks, check a repeated arrangement early; for animated assets, inspect surfaces revealed by poses. These practices follow the [Minecraft style guide](https://blockbench.net/wiki/guides/minecraft style guide/) and [Bedrock texturing guide](https://blockbench.net/wiki/guides/bedrock modeling/).

blockbench-texturing