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)

blockbench-hytale

NPX Install

Tags

SKILL.md Content

Blockbench Hytale

Available Tools

Format & Validation

Cube Properties

Attachments

Animation

Resources

Prompts

Hytale Formats

Constraints

Shading Modes

Quick Start

Check Format

Validate Model

Cube Properties

Set Shading Mode

Enable Double-Sided

Set Stretch

Quads (2D Planes)

Attachments

List Attachments

Mark as Attachment Piece

List Attachment Pieces

Animation

Visibility Keyframe

Set Loop Mode

Common Workflows

Create Character Model

Create Weapon Attachment

Animate Weapon Draw

Tips