Back to Details

blockbench-texturing

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Blockbench Texturing

Blockbench 纹理制作

Create and paint textures for 3D models using Blockbench MCP tools.
使用Blockbench MCP工具为3D模型创建和绘制纹理。

Available Tools

可用工具

Texture Management

纹理管理

ToolPurpose
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
工具用途
create_texture
创建指定尺寸和填充颜色的新纹理
list_textures
列出项目中所有纹理
get_texture
获取纹理图像数据
apply_texture
将纹理应用到模型元素

Paint Tools

绘画工具

ToolPurpose
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
工具用途
paint_with_brush
使用可自定义的画笔进行绘画
paint_fill_tool
桶填充指定区域
draw_shape_tool
绘制矩形/椭圆
gradient_tool
应用渐变效果
eraser_tool
使用画笔设置进行擦除
color_picker_tool
从纹理中拾取颜色
copy_brush_tool
克隆/复制纹理区域

Brush Management

画笔管理

ToolPurpose
create_brush_preset
Save brush settings
load_brush_preset
Load saved brush
paint_settings
Configure paint mode
工具用途
create_brush_preset
保存画笔设置
load_brush_preset
加载已保存的画笔预设
paint_settings
配置绘画模式

Layers & Selection

图层与选区

ToolPurpose
texture_layer_management
Manage texture layers
texture_selection
Create/modify selections
工具用途
texture_layer_management
管理纹理图层
texture_selection
创建/修改选区

UV Tools

UV工具

ToolPurpose
set_mesh_uv
Set UV coordinates
auto_uv_mesh
Auto-generate UVs
rotate_mesh_uv
Rotate UV mapping
工具用途
set_mesh_uv
设置UV坐标
auto_uv_mesh
自动生成UV
rotate_mesh_uv
旋转UV映射

Resources

资源

ResourceURIPurpose
textures
textures://{id}
List/read texture info
资源URI用途
textures
textures://{id}
列出/读取纹理信息

Creating Textures

创建纹理

New Blank Texture

新建空白纹理

create_texture: name="skin", width=64, height=64, fill_color="#808080"
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]
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"
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"}
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}
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
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"
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_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
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"
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
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
color_picker_tool: texture_id="skin", x=16, y=16

Returns picked color, sets as active

返回拾取的颜色并设为当前激活颜色

undefined
undefined

Clone/Copy Brush

克隆/复制画笔

copy_brush_tool: texture_id="skin",
  source={x: 0, y: 0}, target={x: 32, y: 0},
  brush_size=8, mode="copy"
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"
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"
load_brush_preset: preset_name="soft_round"

Texture Layers

纹理图层

Create Layer

创建图层

texture_layer_management: texture_id="skin", action="create_layer",
  layer_name="details"
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
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"
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}
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"
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"
texture_selection: texture_id="skin", action="invert_selection"

Feather Edges

羽化边缘

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

UV Mapping

UV映射

Auto UV for Mesh

为网格自动生成UV

auto_uv_mesh: mesh_id="sphere", mode="project"  # project, unwrap, cylinder, sphere
auto_uv_mesh: mesh_id="sphere", mode="project"  # project, unwrap, cylinder, sphere

Set Custom UV

设置自定义UV

set_mesh_uv: mesh_id="cube", face_key="north",
  uv_mapping={"v1": [0, 0], "v2": [16, 0], "v3": [16, 16], "v4": [0, 16]}
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

旋转UV

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

Paint Settings

绘画设置

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

Common Workflows

常见工作流

Skin Texture

皮肤纹理制作

undefined
undefined

Create texture

创建纹理

create_texture: name="player_skin", width=64, height=64, fill_color="#C4A484"
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
paint_fill_tool: x=8, y=8, color="#C4A484", fill_mode="face" # 脸部 paint_fill_tool: x=20, y=20, color="#3366CC", fill_mode="face" # 身体

Details with brush

用画笔添加细节

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

Apply

应用纹理

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

Procedural Pattern

程序化图案制作

undefined
undefined

Create base

创建基础纹理

create_texture: name="pattern", width=32, height=32, fill_color="#FFFFFF"
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
undefined
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
undefined

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
  • 在paint_settings中设置
    pixel_perfect=true
    以获得清晰的像素艺术效果
  • 启用
    mirror_painting
    功能制作对称纹理
  • 使用图层进行非破坏性编辑
  • lock_alpha
    可防止在现有像素范围外绘画
  • 使用
    fill_mode="color_connected"
    仅填充相邻的同色像素
  • 为常用设置创建画笔预设