HynfinityIndexer

HynfinityIndexer

Hytale Server 0.7.x (built and tested against 0.7.6)

A storage system for Hytale: link your chests into one storage network and search, sort, deposit and withdraw items from a single storage terminal.

Place a central Indexer (the storage terminal), wire your chests together with transparent Glass Pipes, and manage your whole item storage from one screen — while you watch each item physically travel inside the pipes in real time. Chest network, item sorting, mass storage, inventory management: all from one block.

Quick Start

1. Download the latest HynfinityIndexer-*.jar from Releases
2. Drop it in your server's mods/ directory
3. Start the server
4. Craft an Indexer and some Glass Pipes at a Workbench (Tinkering)

Features

Central Indexer — your storage terminal

• One terminal that aggregates every chest reachable through its pipe network
• Browse, search and sort the whole storage in a single UI — items are grouped and counted across all chests; hover one to see which chests hold it
• Withdraw with a click; right-click pulls a full stack
• Chest-like screen: drag items from your inventory, Shift+click to store, double-click to store every identical stack
• Deposit all / Quick stack to empty your inventory into storage
• Reception + dispatch buffers so transfers queue cleanly under load
• Live, flicker-free updates shared by every player at the same Indexer
• Locked slots: "Lock slots" mode, then click inventory slots to lock them (amber). Deposit all, Quick stack and double clicks never take a locked slot, hotbar included; the hotbar starts locked. Locks are saved with the player.

Glass Pipes — see your items move

• Transparent conduits: the items travelling through are rendered as real, in-world entities riding inside the tube — no guesswork, you see the flow
• Connection-aware shape (straight / corner / T / hub) with animated states
• Connect Indexer ↔ pipes ↔ chests; the network is discovered automatically

Smart routing

• Automatic network discovery (BFS) across pipes, chests, and the Indexer
• Congestion-aware, per-arc directed routing: packets route around busy pipes, so parallel runs roughly double throughput
• Anti ping-pong + ring-deadlock backoff keep items flowing under heavy load
• Configurable pipe speed, per-network limits, and concurrency

Crafting

Item	Recipe	Output	Bench
Glass Pipe	2× Copper Bar + 1× Cyan Crystal	×8	Workbench (Tinkering)
Indexer	6× Iron Bar + 4× Cyan Crystal	×1	Workbench (Tinkering)

Commands

Command	Description	Permission
/indexer status	Version, config summary, network + known-indexer counts	—
/indexer network	List every active network (Indexer position, pipes, chests, validity)	—
/indexer reload	Re-read config.json and apply it live (transfers in flight are kept); an invalid file is refused whole	—

Alias: /hynfinityindexer.

Configuration

config.json is created on first run in the plugin data folder. It carries a configVersion; an older file is migrated in place on load (missing keys get their default, the previous file is kept as config.v<N>.json.bak).

Every value is checked against the range below. Nothing is silently clamped: an invalid file at startup disables the Indexer (it refuses to open, the reason is in the server log) until it is fixed and /indexer reload succeeds; an invalid file on reload is refused and the running config stays. Unknown keys (typos) are reported in the log.

Setting	Default	Range	Effect
indexerBufferReceptionSize	3	3–36	Reception buffer slots. A smaller size takes effect once the extra slots are empty and no Buffers window is open
indexerBufferEnvoiSize	3	3–36	Dispatch buffer slots (same rule)
pipeSpeedTicksPerBlock	5	1–100	Ticks a packet takes to cross one pipe block (lower = faster)
pipeCapacityPacketsPerSecond	1	1–20	Packets admitted per second into each pipe arc (pipe, direction)
transferItemLimitPerDirectionPerPipe	1	1–64	Items carried by one packet. 1 is the intended one-by-one transport; raising it speeds the network up
maxChestsPerNetwork	32	1–256	Chests a network tracks beyond which more are ignored
maxPipesPerNetwork	128	1–1024	Pipes a network follows beyond which more are ignored
maxConcurrentTransfers	16	1–128	Packets in flight at once per Indexer
networkRecalcCooldownTicks	10	0–200	Debounce of network rebuilds: the first block change rebuilds at once, further ones within this many ticks are merged into one rebuild (0 = rebuild on every change)
allowMultipleIndexersPerNetwork	false	—	false: placing an Indexer on a network that has one, or a pipe joining two Indexer networks, is refused with a message. true: each Indexer keeps its own network and treats the other Indexer as a boundary
dropItemsOnNetworkFailure	true	—	Drop in-transit items to the world if a network breaks (vs. lose them)
routingCostAlpha / routingCostBeta / routingCostOccupied	3.0 / 2.0 / 50.0	≥ 0	Route weights: pipe saturation, reserved arcs, arc currently holding a packet
deadlockBackoffTicks	80	20–1200	A packet blocked this long backs off toward its source
stuckAbortTicks	300	40–6000	A packet with no route this long is dropped and its transfer aborted
debugMode	false	—	Verbose logging (routing, BFS, per-transfer). Off: only lifecycle and problems are logged

The defaults are the intended pace: items cross the pipes one at a time, slowly and visibly. pipeSpeedTicksPerBlock, pipeCapacityPacketsPerSecond and transferItemLimitPerDirectionPerPipe let an admin speed a server up on purpose.

Compatibility

Mod version	Hytale Server
0.7.6-*	0.7.x (ServerVersion: ^0.7.0)
0.5.x-*	0.5.6 – 0.5.9 — does not run on 0.6+ (world crash at boot)

Server 0.7 breaking changes handled in 0.7.6-*:

• Chunks are split into 32³ sections stored as ECS entities: the old World.getChunk* / WorldChunk block accessors are gone. All block reads, block-entity lookups and interaction-state writes now go through block/WorldBlocks.kt (ChunkStore.getChunkSectionReferenceAtBlock, BlockModule.getBlockEntity, BlockOperations.setBlockInteractionState).
• Block-entity saves are marked per block (BlockStateInfo.markNeedsSaving) instead of per chunk; missing block entities are recreated with BlockEntity.ensureBlockEntity.
• Player inventory is read through InventoryComponent (hotbar first, then storage); the legacy Inventory is deprecated for removal.
• PageManager.clearCustomPageAcknowledgements → clearLegacyCustomPageAcknowledgements.

Existing worlds keep their Indexers, buffers and in-transit items: the component IDs (IndexerBuffer, PipeTransit) and codecs are unchanged.

Analytics

This mod reports anonymous server statistics to HStats (server + mod counts and versions — no usernames, no IPs, no world data). It's a tiny, best-effort ping and can be disabled server-wide via the hstats-server-uuid.txt file HStats creates in the server directory (enabled=false).