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)