---name: blockbench-hytaledescription: 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)