premium banner

State Controller Block

State Controller Block lets you automate and coordinate block states using timers and conditions. Target nearby blocks, read their states, and switch them in sequences or logic chains to build trap doors, systems, and world automation—no scripting required

Description

State Controller Block

Overview

State Controller Block (SCB) is a configurable automation block that controls the states of nearby blocks using timers and conditions.

It directly manipulates exposed block states.\ No signals. No wiring. No power system.

ℹ️ Full documentation: https://halekio.gitbook.io/state-controller-block/

🎥 Video Showcase

✨ Features

  • Control 1 block per direction (Up, Down, North, South, East, West)
  • Exact targeting distance of 1--9 blocks
  • Reads and displays exposed states of target blocks
  • Fully configurable state sequencing
  • Per-state timers with fine precision
  • Infinite or limited loop execution
  • Advanced conditional logic system

🎯 Targeting

Each direction is configured independently.

  • Select a face (Up, Down, North, South, East, West)
  • Set an exact distance (1--9 blocks)
  • Only the block at that exact position is affected
  • UI displays available states when the block supports them

⏱ State Sequences

For each targeted block you can:

  • Duplicate states
  • Rearrange order freely
  • Assign a duration to each state
  • Set duration to 0 to skip a state

Loop Options

  • Infinite loop (default)
  • Set a specific number of loops
  • Sequence stops after configured loops complete

Off Behavior

When the SCB is turned Off:

  • Optionally define a fallback state
  • If none is defined, the block freezes in its current state
  • When turned back On, the sequence resumes

🔒 Conditional System

Conditions apply to the SCB as a whole.

Most conditions operate as:

While condition is true → perform sequence

Exceptions:\ Block Placed and Block Broken\ When triggered, they latch ON for the duration of the sequence.

⚙ Condition Types

Player Nearby

  • Target: SCB or face + distance
  • Range: configurable sphere around condition target

NPC Nearby

  • Target: SCB or face + distance
  • Range: configurable sphere
  • Type filter: All, NonHostile, Hostile, Neutral, Friendly, Revered, Ignored

Item on Ground

  • Target: SCB or face + distance
  • Range
  • Item List (comma-separated Item IDs)

Block Placed

  • Target: SCB or face + distance
  • Range
  • Block List (comma-separated Block IDs)

Block Broken

  • Target: SCB or face + distance
  • Range
  • Block List (comma-separated Block IDs)

Block State

  • Target: face + distance only
  • State selected from dropdown of that block

Time of Day

  • From time
  • To time
  • 24-hour selection

🏗 Designed For Builders

  • No scripting required
  • Fully visual configuration
  • Composable logic blocks
  • Compatible with current and future state-enabled blocks

Version: 0.1.0\ Compatibility: Hytale Server API (Java)

Donations

If you enjoy this mod and want to support future updates, you can Ko-fi