blockbench-hytale

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)