Configuration Overview

AtlasLobby is configured with YAML. Most behavior is meant to be changed without touching code.

Main Config

config.yml controls global systems:

Section	Purpose
`actions`	Shared action behavior, including recursion protection.
`economy`	AtlasLobby coins. See Coins Economy.
`inventory-control`	Join inventory, item locking, sanitizer, drops, pickups, and clicks.
`scoreboard`	Sidebar scoreboard, title animation, lines, and world filters.
`spawn`	Spawn, lobby, hub, void, and teleport behavior.
`protection`	Block, damage, hunger, PvP, and item protection.
`visibility`	Player visibility modes and toggles.
`resource-pack`	Optional resource pack sending and status tracking.
`server-selector`	Server selector behavior.

Feature Files

File	Purpose
`messages.yml`	Prefix, command messages, errors, and other player-facing text.
`items.yml`	Join and hotbar tools.
`menus.yml`	Chest UI menus.
`servers.yml`	Server selector entries.
`rewards.yml`	Daily reward settings and reward commands.
`announcements.yml`	Announcement and news entries.
`cosmetics.yml`	Particles, hats, gadgets, rarities, and categories.

Reloading

Use:

/al reload

Reload updates:

Config and messages.
Menus and menu items.
Join items.
Server selector entries.
Rewards.
Announcements.
Cosmetics.
Resource-pack settings.
Protection and visibility behavior.
Scoreboard and other live systems.

Reload is designed for normal config edits, so you can update menus, messages, cosmetics, scoreboard lines, rewards, and similar settings without restarting the server.

Configured Permission Defaults

Menus, join items, server entries, and cosmetics can set permission-default next to permission:

permission: "atlaslobby.cosmetic.blue-aura"
permission-default: true

Accepted values:

true
false
op
not_op

When omitted, configured player-facing permissions default to true. Built-in admin permissions continue to default to operators.

Server-Wide Defaults

AtlasLobby defaults inventory control and protection to the whole server:

inventory-control:
  apply-to-all-worlds: true

protection:
  apply-to-all-worlds: true

To exclude worlds, add them to disabled-worlds:

inventory-control:
  disabled-worlds:
    - survival

protection:
  disabled-worlds:
    - survival

Per-World Protection Overrides

Protection can override individual flags per world:

protection:
  worlds:
    world:
      block-break: true
      item-drop: true
    event_world:
      block-break: false
      item-drop: true