Skip to content

Plain language glossary

AstorisTheBrave edited this page Aug 10, 2026 · 3 revisions

Plain-language glossary

Chunk

A standard Minecraft area that is 16 blocks wide and 16 blocks long. The world is stored and processed in many chunks.

Region file

A Java world storage file that can contain up to 32 by 32 chunks. Its filename ends in .mca.

Worker

One Minecraft server process in the planned Elah system. A worker would be responsible for one or more parts of the world.

Machine

A physical computer or virtual machine that can run one or more workers.

Cell

The planned unit of responsibility in Elah. A cell contains a group of world storage areas. Exactly one worker should be allowed to authoritatively change an active cell.

Owner

The worker that currently has permission to make authoritative changes to a cell.

Ownership epoch

A number that increases when responsibility changes. An old worker with an old number can be rejected instead of accidentally changing current data.

Handoff

The planned process for moving a player's authoritative state from one worker to another as the player crosses a boundary.

Control plane

The part that manages workers, health, ownership, and administrative decisions. Normal player movement and gameplay traffic should not pass through it.

Shepherd

The planned Elah scheduler. Shepherd would decide where Minecraft cells belong by combining ownership, topology, gameplay pressure, machine capacity, and operator rules.

Runtime Provider

A future adapter that can report capacity and start, inspect, drain, or stop workers using native processes, Docker, or an external infrastructure system. It cannot assign cell ownership.

COLD, WARM, and HOT workers

A COLD worker is not running. A WARM worker is ready but owns no cells. A HOT worker actively owns and serves one or more cells.

Guaranteed, burst, and preemptible capacity

Guaranteed capacity is reserved for a cluster. Burst capacity is shared spare capacity available up to a limit. Preemptible capacity is temporary capacity that may be reclaimed after Elah safely drains its cells.

Resource envelope

Hard limits on the workers and infrastructure resources one cluster may consume. It is a scheduling boundary, not a bill.

Fail closed

Stop without producing a trusted result when safety cannot be proven. For example, Observer produces no report if the world changes during its scan.

Split brain

A dangerous situation where two machines both believe they are the authoritative owner of the same data.

Snapshot

A stable point-in-time view of files. A snapshot lets a tool inspect data without the files changing underneath it.

Oracle

An independent implementation used in tests to check that Elah's result agrees with separately known facts. The Observer Laboratory uses pinned PrismarineJS tools as a development-only oracle.

Clone this wiki locally