PerfectAutomation

A full item automation system for Hytale. Build conveyor networks, automate smelting, break blocks, and transport items between chests — all without writing a single line of code.

Installation

1. Download PerfectAutomation-1.0.0.jar
2. Place it in your server's UserData/Mods/ folder
3. Start the server — config files auto-generate
4. Use /automation give PA_Conveyor 10 to get started

Blocks Overview

PerfectAutomation adds 24 unique blocks organized into categories:

Transport

Routing

Storage / IO

Processing

World Interaction

How Networks Work

When you place automation blocks next to each other, they automatically form a network. Items flow through connected blocks based on their type and direction.

Network Rules

• Adjacent blocks (touching faces) are part of the same network
• Breaking a block in the middle splits the network into two
• Placing a block between two networks merges them
• Each block has a direction (shown when placed) — this is the output direction
• Items in broken blocks are saved to the lost & found

Basic Setup Example

[Chest] <- [Importer] -> [Conveyor] -> [Conveyor] -> [Exporter] -> [Chest]

The Importer pulls from the chest behind it. Items travel along conveyors. The Exporter deposits into the chest in front.

Commands

Configuration

Config file: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectAutomation/config.json

{
  "lang": "EN",
  "autoSaveSeconds": 300,
  "tickRates": {
    "conveyor": 2,
    "machine": 2,
    "source": 2,
    "collector": 2
  },
  "limits": {
    "maxNetworkSize": 256,
    "maxItemsInTransit": 128
  }
}

Furnace Recipes

The Auto Furnace smelts these items by default (configurable):

Conveyor

The basic transport block. Moves one item at a time in the direction it faces. Comes in straight, corner, slope and slope-down variants.

• Direction: Arrow on top shows output direction
• Buffer: 1 item
• Variants: PA_Conveyor, PA_Conveyor_Corner, PA_Conveyor_Slope, PA_Conveyor_SlopeDown

Importer

Pulls items from the chest behind it (opposite of arrow direction) and injects them into the network.

• Input: Chest behind (opposite of arrow)
• Output: Arrow direction
• Buffer: 1 item

Exporter

Takes items from the network and deposits them into the chest in front (arrow direction).

• Input: Network (any adjacent block)
• Output: Chest in arrow direction

Auto Furnace

Automatically smelts ores into bars. Items enter from any adjacent network block and exit in the arrow direction.

• Input: Any adjacent network block
• Output: Arrow direction
• Buffer: 2 items
• Recipes: Configurable in config.json

Breaker

Breaks the block behind it (opposite of arrow) and injects the result into the network in the arrow direction.

• Breaks: Block behind (opposite of arrow)
• Output: Arrow direction (any adjacent network block)
• Buffer: 3 items
• Cooldown: 2 seconds between breaks
• Note: Will not break automation blocks

Hopper

Pulls items from the chest above it and pushes them in the arrow direction.

• Input: Chest directly above
• Output: Arrow direction
• Buffer: 2 items

Splitter

Distributes items round-robin across its side and back outputs (left, right, behind relative to arrow).

• Input: Arrow direction (front)
• Outputs: Left, Right, Behind (round-robin)

Trash Bin

Destroys any item that enters its buffer. Use at the end of overflow lines.

• Input: Any adjacent network block
• Output: None (items are destroyed)

FAQ

Items disappeared when I broke a block!

Items in broken blocks are saved to the lost & found. Use /automation claim to get them back.

My network shows the wrong number of blocks

The auto-cleanup runs every 5 seconds. Wait a moment and check again with /automation stats.

The Breaker isn't working

Make sure the block to break is behind the Breaker (opposite of the arrow). The arrow shows where items go, not where it breaks.