Blockbench 3D建模工具指南：立方体与网格建模教程及MCP项目

blockbench-modeling by jasonjgardner/blockbench-mcp-project

82 周安装量

4 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/jasonjgardner/blockbench-mcp-project --skill blockbench-modeling

3D建模设计游戏

🇨🇳中文介绍

Blockbench 建模

在 Blockbench 中使用立方体和网格构建 3D 模型。

可用工具

立方体工具

工具	用途
`place_cube`	创建具有位置、大小、纹理的立方体
`modify_cube`	编辑立方体属性（位置、旋转、UV 等）

网格工具

工具	用途
`place_mesh`	使用顶点创建网格
`create_sphere`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

工具	用途
`add_group`	创建骨骼/组
`list_outline`	查看模型层次结构
`duplicate_element`	复制元素
`rename_element`	重命名元素
`remove_element`	删除元素

放置一个立方体

place_cube: elements=[{
  name: "body",
  from: [-4, 0, -2],
  to: [4, 12, 2]
}], faces=true  # 自动 UV

放置多个立方体

place_cube: elements=[
  {name: "head", from: [-4, 12, -4], to: [4, 20, 4]},
  {name: "arm_left", from: [4, 4, -1], to: [6, 12, 1]},
  {name: "arm_right", from: [-6, 4, -1], to: [-4, 12, 1]}
], group="body"

modify_cube: id="body", rotation=[0, 45, 0], origin=[0, 6, 0]

带纹理的立方体

place_cube: elements=[{name: "block", from: [0,0,0], to: [16,16,16]}],
  texture="stone", faces=true

create_sphere: elements=[{
  name: "ball",
  position: [0, 8, 0],
  diameter: 16,
  sides: 12
}]

create_cylinder: elements=[{
  name: "pillar",
  position: [0, 0, 0],
  diameter: 8,
  height: 24,
  sides: 12,
  capped: true
}]

select_mesh_elements: mesh_id="pillar", mode="face", elements=["top_face"]
extrude_mesh: mesh_id="pillar", mode="faces", distance=4

细分以增加细节

subdivide_mesh: mesh_id="sphere", cuts=2

select_mesh_elements: mesh_id="mesh1", mode="vertex", elements=["v1", "v2"]
move_mesh_vertices: offset=[0, 2, 0]

merge_mesh_vertices: mesh_id="mesh1", threshold=0.1

knife_tool: mesh_id="cube_mesh", points=[
  {position: [0, 8, -4]},
  {position: [0, 8, 4]}
]

创建组层次结构

add_group: name="root", origin=[0, 0, 0], rotation=[0, 0, 0]
add_group: name="body", parent="root", origin=[0, 12, 0]
add_group: name="head", parent="body", origin=[0, 24, 0]

将立方体添加到组中

place_cube: elements=[{name: "torso", from: [-4, 12, -2], to: [4, 24, 2]}],
  group="body"

duplicate_element: id="arm_left", newName="arm_right", offset=[-8, 0, 0]

list_outline  # 返回所有组和元素

# 创建层次结构
add_group: name="root", origin=[0, 0, 0]
add_group: name="body", parent="root", origin=[0, 24, 0]
add_group: name="head", parent="body", origin=[0, 24, 0]
add_group: name="arm_left", parent="body", origin=[5, 22, 0]
add_group: name="arm_right", parent="body", origin=[-5, 22, 0]
add_group: name="leg_left", parent="root", origin=[2, 12, 0]
add_group: name="leg_right", parent="root", origin=[-2, 12, 0]

# 添加几何体
place_cube: elements=[{name: "head", from: [-4, 24, -4], to: [4, 32, 4]}], group="head"
place_cube: elements=[{name: "body", from: [-4, 12, -2], to: [4, 24, 2]}], group="body"
place_cube: elements=[{name: "arm", from: [-1, 0, -1], to: [1, 10, 1]}], group="arm_left"
place_cube: elements=[{name: "arm", from: [-1, 0, -1], to: [1, 10, 1]}], group="arm_right"
place_cube: elements=[{name: "leg", from: [-2, 0, -2], to: [2, 12, 2]}], group="leg_left"
place_cube: elements=[{name: "leg", from: [-2, 0, -2], to: [2, 12, 2]}], group="leg_right"

create_sphere: elements=[{name: "base", position: [0, 8, 0], diameter: 16, sides: 16}]
subdivide_mesh: mesh_id="base", cuts=1
# 选择并移动顶点以塑形
select_mesh_elements: mesh_id="base", mode="vertex"
move_mesh_vertices: offset=[0, 4, 0], vertices=["top_verts"]

使用 list_outline 查看当前模型结构
将组的原点设置在关节/枢轴点以便动画制作
对立方体使用 faces=true 进行自动 UV 映射
在添加几何体之前创建骨骼层次结构
使用带偏移的 duplicate_element 来创建对称部件
网格编辑更灵活，但立方体对于 Minecraft 风格模型更简单

2026 年 1 月 24 日

🇺🇸English

Blockbench Modeling

Build 3D models using cubes and meshes in Blockbench.

Available Tools

Cube Tools

Tool	Purpose
`place_cube`	Create cubes with position, size, texture
`modify_cube`	Edit cube properties (position, rotation, UV, etc.)

Mesh Tools

Tool	Purpose
`place_mesh`	Create mesh with vertices
`create_sphere`	Create sphere mesh
`create_cylinder`	Create cylinder mesh
`extrude_mesh`	Extrude faces/edges/vertices
`subdivide_mesh`	Add geometry detail
`select_mesh_elements`	Select vertices/edges/faces
`move_mesh_vertices`	Move selected vertices
`delete_mesh_elements`	Remove geometry
`merge_mesh_vertices`	Weld nearby vertices
`create_mesh_face`	Create face from vertices
`knife_tool`	Cut edges into faces

Element Tools

Tool	Purpose
`add_group`	Create bone/group
`list_outline`	View model hierarchy
`duplicate_element`	Copy elements
`rename_element`	Rename elements
`remove_element`	Delete elements

Cube Modeling

Place a Cube

place_cube: elements=[{
  name: "body",
  from: [-4, 0, -2],
  to: [4, 12, 2]
}], faces=true  # Auto UV

Place Multiple Cubes

place_cube: elements=[
  {name: "head", from: [-4, 12, -4], to: [4, 20, 4]},
  {name: "arm_left", from: [4, 4, -1], to: [6, 12, 1]},
  {name: "arm_right", from: [-6, 4, -1], to: [-4, 12, 1]}
], group="body"

Modify Cube

modify_cube: id="body", rotation=[0, 45, 0], origin=[0, 6, 0]

Cube with Texture

place_cube: elements=[{name: "block", from: [0,0,0], to: [16,16,16]}],
  texture="stone", faces=true

Mesh Modeling

Create Sphere

create_sphere: elements=[{
  name: "ball",
  position: [0, 8, 0],
  diameter: 16,
  sides: 12
}]

Create Cylinder

create_cylinder: elements=[{
  name: "pillar",
  position: [0, 0, 0],
  diameter: 8,
  height: 24,
  sides: 12,
  capped: true
}]

Extrude Face

select_mesh_elements: mesh_id="pillar", mode="face", elements=["top_face"]
extrude_mesh: mesh_id="pillar", mode="faces", distance=4

Subdivide for Detail

subdivide_mesh: mesh_id="sphere", cuts=2

Move Vertices

select_mesh_elements: mesh_id="mesh1", mode="vertex", elements=["v1", "v2"]
move_mesh_vertices: offset=[0, 2, 0]

Merge Close Vertices

merge_mesh_vertices: mesh_id="mesh1", threshold=0.1

Knife Cut

knife_tool: mesh_id="cube_mesh", points=[
  {position: [0, 8, -4]},
  {position: [0, 8, 4]}
]

Organization

Create Group Hierarchy

add_group: name="root", origin=[0, 0, 0], rotation=[0, 0, 0]
add_group: name="body", parent="root", origin=[0, 12, 0]
add_group: name="head", parent="body", origin=[0, 24, 0]

Add Cubes to Groups

place_cube: elements=[{name: "torso", from: [-4, 12, -2], to: [4, 24, 2]}],
  group="body"

Duplicate Element

duplicate_element: id="arm_left", newName="arm_right", offset=[-8, 0, 0]

View Hierarchy

list_outline  # Returns all groups and elements

Common Patterns

Minecraft Character

# Create hierarchy
add_group: name="root", origin=[0, 0, 0]
add_group: name="body", parent="root", origin=[0, 24, 0]
add_group: name="head", parent="body", origin=[0, 24, 0]
add_group: name="arm_left", parent="body", origin=[5, 22, 0]
add_group: name="arm_right", parent="body", origin=[-5, 22, 0]
add_group: name="leg_left", parent="root", origin=[2, 12, 0]
add_group: name="leg_right", parent="root", origin=[-2, 12, 0]

# Add geometry
place_cube: elements=[{name: "head", from: [-4, 24, -4], to: [4, 32, 4]}], group="head"
place_cube: elements=[{name: "body", from: [-4, 12, -2], to: [4, 24, 2]}], group="body"
place_cube: elements=[{name: "arm", from: [-1, 0, -1], to: [1, 10, 1]}], group="arm_left"
place_cube: elements=[{name: "arm", from: [-1, 0, -1], to: [1, 10, 1]}], group="arm_right"
place_cube: elements=[{name: "leg", from: [-2, 0, -2], to: [2, 12, 2]}], group="leg_left"
place_cube: elements=[{name: "leg", from: [-2, 0, -2], to: [2, 12, 2]}], group="leg_right"

Smooth Organic Shape

create_sphere: elements=[{name: "base", position: [0, 8, 0], diameter: 16, sides: 16}]
subdivide_mesh: mesh_id="base", cuts=1
# Select and move vertices to shape
select_mesh_elements: mesh_id="base", mode="vertex"
move_mesh_vertices: offset=[0, 4, 0], vertices=["top_verts"]

Tips

Use list_outline to see current model structure
Set group origins at joint/pivot points for animation
Use faces=true for auto UV mapping on cubes
Create bone hierarchy before adding geometry
Use duplicate_element with offset for symmetrical parts
Mesh editing is more flexible but cubes are simpler for Minecraft-style models

Weekly Installs

Repository

jasonjgardner/b…-project

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

gemini-cli73

codex73

github-copilot71

opencode71

kimi-cli61

amp61

前端打磨（Polish）终极指南：提升产品细节与用户体验的系统化检查清单

47,700 周安装