mcpField
M
minecraft-model

minecraft-model

github.com/hairyfCreative & media2648 installsUpdated 2w ago
Repository

About minecraft-model

A workflow skill for creating Minecraft models: an image model first establishes the design, structure, and texture reference, then Blockbench MCP is used to build the model. The process covers modeling, texturing, animation, and screenshot-based verification.

Key features

  1. 01Generate a design image and three views first
  2. 02Control Blockbench through MCP
  3. 03Create bone hierarchies and place cubes
  4. 04Paint textures and add animations
  5. 05Capture screenshots and inspect hierarchy for iteration

Use cases

  1. 01Turn a concept image into a Minecraft model
  2. 02Build textures and animations for a model
  3. 03Compare screenshots with the design and refine the model

MCP support

Requires Blockbench MCP to create projects, model geometry, apply textures, add animations, and capture screenshots through MCP tools. The workflow instructs users to install and start it if its tools are unavailable.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/hairyf/skills --skill minecraft-model

After installing, type/minecraft-modelin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
core-design-prompts.md
core-workflow.md
features-animation.md
features-modeling.md
features-texturing.md

Details

From the project README

Minecraft Model

Workflow modeled on the ai-kit model tool (https://ai-kit.xingduansuzhao.com/model): design the model with an image model first (this yields both the structure scheme and the texture reference), then let the agent build it in Blockbench through the Blockbench MCP server.

Prerequisite

默认假设:用户已安装并启动 Blockbench MCP(Blockbench 已打开、MCP 插件已加载、AI 工具已配置 MCP 服务)。

If the MCP tools are unavailable (e.g. place_cube, add_group, list_outline are missing from the tool list), stop and remind the user to install and start Blockbench MCP before continuing. Do not work around a missing MCP by hand-writing model files.

Workflow

  1. Design — two image-model calls in one session (e.g. the imagine/imagegen skill): first generate the vanilla-Minecraft design image, review it (AI by default; involve the user if they're unhappy), then ask for the three views in the same session using core-design-prompts. The result provides both the cube structure and the texture map for modeling.
  2. Build — drive Blockbench via MCP: create the project, build the bone hierarchy, place cubes, paint/apply the texture, and add animations. Follow core-workflow with the tool patterns in features-modeling, features-texturing, and features-animation.
  3. Verify — capture screenshots with MCP (capture_screenshot), inspect the hierarchy with list_outline, and iterate until the model matches the design.

References

TopicDescriptionReference
Design promptsVanilla pre-prompt (EN/ZH), design prompt + review gate, three views in the same sessioncore-design-prompts
End-to-end workflowDesign → build → texture → animate → verify, with a worked snail examplecore-workflow
Modeling toolsProject creation, groups/bones, cubes, meshesfeatures-modeling
Texturing & PBRTextures, painting, UV mapping, PBR materialsfeatures-texturing
Animation toolsKeyframes, rigging, timeline controlfeatures-animation

Comments

Markdown supported