Installation

Requirements

  • A Paper or Spigot server running Minecraft 1.21+.
  • Java 21.

Optional integrations (AtlasLobby runs fine without any of them):

  • PlaceholderAPI — adds external placeholders to menus, scoreboard and messages.
  • Vault + an economy plugin — only needed if you want to put a price on cosmetics.
  • LuckPerms (or any permissions plugin) — for managing permissions.

Install

  1. Stop the server.
  2. Drop the AtlasLobby.jar into your plugins/ folder.
  3. Start the server once so the default config files generate.
  4. Run /setspawn in-game where you want the lobby spawn.
  5. Edit the generated YAML files to taste.
  6. Run /al reload to apply config changes — no restart needed.

First Test Checklist

  • /setspawn
  • /spawn, /lobby, /hub
  • Join and confirm inventory clears and configured hotbar items appear.
  • Right-click lobby items.
  • Try dropping and moving hotbar items. They should be blocked by default.
  • /serverselector
  • /profile
  • /rewards
  • /cosmetics
  • /al debug

Generated Files

  • config.yml
  • messages.yml
  • items.yml
  • menus.yml
  • servers.yml
  • rewards.yml
  • announcements.yml
  • cosmetics.yml
  • data/players.yml

Player data is persisted in data/players.yml.

Next Configuration