name: blockbench-hytale
description: Create Hytale models and animations using Blockbench MCP tools. Use when working with Hytale character/prop formats, creating attachments, setting shading modes, using quads, or animating with visibility keyframes. Requires the Hytale Blockbench plugin to be installed.
Blockbench Hytale
Create models for Hytale using Blockbench with the Hytale plugin.
Prerequisite: Hytale plugin must be installed in Blockbench.
Available Tools
Format & Validation
| Tool |
Purpose |
hytale_get_format_info |
Get format type, block size, node count |
hytale_validate_model |
Check against Hytale constraints |
Cube Properties
| Tool |
Purpose |
hytale_set_cube_properties |
Set shading_mode, double_sided |
hytale_get_cube_properties |
Get Hytale cube properties |
hytale_set_cube_stretch |
Set stretch values [x, y, z] |
hytale_get_cube_stretch |
Get stretch values |
hytale_create_quad |
Create 2D plane with normal |
Attachments
| Tool |
Purpose |
hytale_list_attachments |
List attachment collections |
hytale_set_attachment_piece |
Mark group as attachment piece |
hytale_list_attachment_pieces |
List all piece groups |
Animation
| Tool |
Purpose |
hytale_create_visibility_keyframe |
Toggle bone visibility in animation |
hytale_set_animation_loop |
Set loop mode (loop/hold/once) |
Resources
| Resource |
URI |
Purpose |
| hytale-format |
hytale://format |
Format info |
| hytale-attachments |
hytale://attachments/{id} |
Attachment collections |
| hytale-pieces |
hytale://pieces/{id} |
Attachment pieces |
| hytale-cubes |
hytale://cubes/{id} |
Cubes with Hytale properties |
Prompts
| Prompt |
Arguments |
Purpose |
hytale_model_creation |
format_type |
Character/prop modeling guide |
hytale_animation_workflow |
animation_type |
Animation creation guide |
hytale_attachments |
- |
Attachments system guide |
Hytale Formats
| Format |
Block Size |
Use Case |
hytale_character |
64px |
Humanoids, creatures |
hytale_prop |
32px |
Items, weapons, decorations |
Constraints
- Max nodes: 255 (groups + extra cubes)
- Animation FPS: 60
- UV size: Must match texture resolution
Shading Modes
| Mode |
Effect |
standard |
Normal lighting (default) |
flat |
No lighting/shadows |
fullbright |
Always fully lit (emissive) |
reflective |
Reflective material |
Quick Start
Check Format
hytale_get_format_info
# Returns: formatType, blockSize, nodeCount, features
Validate Model
hytale_validate_model
# Returns: valid, nodeCount, issues
Cube Properties
Set Shading Mode
hytale_set_cube_properties: cube_id="crystal", shading_mode="fullbright"
Enable Double-Sided
hytale_set_cube_properties: cube_id="cloth", double_sided=true
Set Stretch
hytale_set_cube_stretch: cube_id="arm", stretch=[1.2, 1.0, 1.0]
Quads (2D Planes)
Create single-face planes:
hytale_create_quad: name="leaf",
position=[0, 16, 0],
normal="+Y", # +X, -X, +Y, -Y, +Z, -Z
size=[8, 8],
double_sided=true
Attachments
List Attachments
hytale_list_attachments
Mark as Attachment Piece
hytale_set_attachment_piece: group_name="hand_right", is_piece=true
This bone will attach to hand_right on the base model.
List Attachment Pieces
hytale_list_attachment_pieces
Animation
Visibility Keyframe
Toggle bone visibility during animation:
hytale_create_visibility_keyframe:
bone_name="weapon_sheathed",
time=0.5,
visible=false
hytale_create_visibility_keyframe:
bone_name="weapon_drawn",
time=0.5,
visible=true
Set Loop Mode
hytale_set_animation_loop: animation_id="walk", loop_mode="loop"
hytale_set_animation_loop: animation_id="attack", loop_mode="once"
hytale_set_animation_loop: animation_id="death", loop_mode="hold"
Common Workflows
Create Character Model
# 1. Create project (use bedrock format, Hytale format activates automatically)
create_project: name="goblin", format="bedrock"
# 2. Build bone hierarchy
add_group: name="root", origin=[0, 0, 0]
add_group: name="body", parent="root", origin=[0, 12, 0]
add_group: name="head", parent="body", origin=[0, 24, 0]
add_group: name="arm_left", parent="body", origin=[6, 22, 0]
add_group: name="arm_right", parent="body", origin=[-6, 22, 0]
add_group: name="hand_right", parent="arm_right", origin=[-8, 16, 0]
# 3. Add geometry
place_cube: elements=[{name: "torso", from: [-4, 12, -2], to: [4, 24, 2]}], group="body"
# 4. Set Hytale properties
hytale_set_cube_properties: cube_id="eyes", shading_mode="fullbright"
# 5. Validate
hytale_validate_model
Create Weapon Attachment
# 1. Create attachment structure
add_group: name="hand_right", origin=[0, 0, 0]
# 2. Add weapon geometry
place_cube: elements=[{name: "blade", from: [-0.5, 0, -0.5], to: [0.5, 24, 0.5]}], group="hand_right"
# 3. Mark as attachment piece
hytale_set_attachment_piece: group_name="hand_right", is_piece=true
# 4. Add glowing effect
hytale_set_cube_properties: cube_id="rune", shading_mode="fullbright"
Animate Weapon Draw
# Start with sheathed weapon visible
hytale_create_visibility_keyframe: bone_name="sword_sheathed", time=0, visible=true
hytale_create_visibility_keyframe: bone_name="sword_drawn", time=0, visible=false
# At draw point, swap
hytale_create_visibility_keyframe: bone_name="sword_sheathed", time=0.3, visible=false
hytale_create_visibility_keyframe: bone_name="sword_drawn", time=0.3, visible=true
Tips
- Always run
hytale_validate_model before export
- Keep node count under 255
- Use stretch instead of fractional cube sizes
- Set group origins at joint/pivot points
- Use
fullbright shading for glowing elements
- Mark equipment bones as
is_piece=true for attachments
- Use visibility keyframes for state changes (weapons, damage)
- Animation runs at 60 FPS (time 1.0 = 60 frames)
By