Skip to main content
Configuration is a flat map of SHARD_* keys. On Kubernetes that map is the environment; everywhere else it is the environment with config.yml merged over it. The file wins. The file accepts two shapes, in the same file at the same time. Sections are the readable one and what the starter template uses; the flat keys are what the environment uses and what anybody copying a value out of a Helm chart will paste.

Identity

The shard refuses to start if shard.world names a world that is not loaded. A shard owning a region of a world it cannot see would accept players and drop them into nothing.

Licence

Every shard and the proxy check license.key when they start, and again every 15 minutes. The two days count from the last successful check and are kept in plugins/atlas/license-state.properties; deleting that file does not extend them, it ends them.

Databases

The grid

These decide which region a given block belongs to.
Identical on every shard and every proxy. A server that disagrees routes players to a shard that does not own where they are standing. Leaving the size and counts unset is the safest way to keep them in step, and every node names any live shard whose grid differs from its own.

Tuning

The defaults are the tested ones. There is no reward for changing them until something specific is wrong.
Atlas removes Paper’s chunk send rate limit by default. Entities are only sent once their chunk is, so the limit is what makes mobs appear a second after a crossing. On a metered link, set keep.

Audit

On by default, because a server that was not logging when the grief happened cannot be made to have been logging afterwards.

Where new players start

Proxy only, and flat keys only — set them in the environment or at the top level of the proxy’s config.yml.

Cross-geo

Only meaningful with more than one geo. These are flat keys only.