Skip to content
Hytale Server Modding Hytale Server Modding

Block System Overview

Block System Overview

Section titled “Block System Overview”

The Block System manages all block types, block states, and block-related operations in Hytale. Blocks are the fundamental building units of the world.

Package Locations

Section titled “Package Locations”
ComponentPackage
BlockTypecom.hypixel.hytale.server.core.asset.type.blocktype.config.BlockType
BlockStatecom.hypixel.hytale.server.core.universe.world.meta.BlockState
BlockStateRegistrycom.hypixel.hytale.server.core.universe.world.meta.BlockStateRegistry
TickProcedurecom.hypixel.hytale.server.core.asset.type.blocktick.config.TickProcedure

Core Components

Section titled “Core Components”
ComponentDescription
BlockTypeAsset definition for block behavior and appearance
BlockStatePer-block instance data for stateful blocks (deprecated)
BlockStateRegistryRegistration of custom block state types
TickProcedureBlock tick behavior (growth, decay, etc.)

Sub-Pages

Section titled “Sub-Pages”
Block Types BlockType assets, properties, enums, and how to access/set blocks
Block States Per-block instance data and custom state registration (deprecated API)
Block Events React to block breaks, placements, mining, and interactions
Block Physics Support system, requirements, and physical behavior
Block Ticking Time-based behavior like growth and decay

Quick Reference

Section titled “Quick Reference”

Getting Blocks

Section titled “Getting Blocks”
Reading blocks from the world
// Get by ID
BlockType stone = BlockType.getAssetMap().get("Rock_Stone");


// Get from world position
World world = Universe.get().getDefaultWorld();
BlockType type = world.getBlockType(x, y, z);


// Get block ID (numeric)
int blockId = world.getBlock(x, y, z);


// Special block references
BlockType.EMPTY   // Air block
BlockType.UNKNOWN // Unknown block placeholder

Setting Blocks

Section titled “Setting Blocks”
Writing blocks to the world
// Simple set
world.setBlock(x, y, z, blockType);


// With settings
SetBlockSettings settings = new SetBlockSettings();
settings.setNotifyNeighbors(true);
settings.setUpdateLighting(true);
settings.setTriggerBlockUpdate(true);
world.setBlock(x, y, z, blockType, settings);

Handling Events

Section titled “Handling Events”
Block event handling
getEventRegistry().register(BreakBlockEvent.class, event -> {
    BlockType blockType = event.getBlockType();
    Vector3i position = event.getPosition();


    // Cancel to prevent breaking
    event.setCancelled(true);
});


getEventRegistry().register(PlaceBlockEvent.class, event -> {
    BlockType blockType = event.getBlockType();
    // Handle placement
});

Best Practices

Section titled “Best Practices”
  1. Use groups: Organize related blocks with the Group property
  2. Minimize states: Only use block states when truly needed
  3. Optimize hitboxes: Use appropriate hitbox complexity
  4. Consider support: Define support requirements for physics
  5. Batch updates: Group block changes when possible
  6. Check loaded: Verify chunks are loaded before block access
Section titled “Related”