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