Troubleshooting

Start with /al debug. It gives the fastest overview of your setup and the systems that are currently active.

Run Debug

Use:

/al debug

It shows:

Debug item	What to check
Plugin version	Confirms the jar version.
Server version	Confirms server compatibility.
Java version	Should be Java 21.
Server platform	Confirms the detected server type.
Optional plugins	PlaceholderAPI, Vault, and other connected plugins.
Spawn status	Whether spawn is set.
Lobby worlds	Which worlds AtlasLobby is applying to.
Loaded counts	Menu, item, server, announcement, and cosmetic counts.
Resource pack status	Whether pack config is active and valid.
Saved data info	Current player-data setup.
Protection status	Whether protection is active.
Cosmetic particle status	Whether cosmetic particles are running.
Scoreboard status	Whether scoreboard updates are running.
Config warnings	Warnings to fix first.

Check:

inventory-control:
  enabled: true
  apply-to-all-worlds: true
  allow-bypass-permission: false
  block-drop: true

Then confirm /al reload was run, or restart the server after config changes.

Check:

inventory-control:
  allow-only-config-items: true
  sanitize:
    enabled: true
    interval-ticks: 20

AtlasLobby removes non-configured items during sanitizer passes.

Current behavior should only run actions on right-click. Left-click is cancelled and plays the blocked-action sound:

inventory-control:
  blocked-action-sound:
    sound: BLOCK_NOTE_BLOCK_CHIME
    pitch: 0.55

Make sure your jar includes the latest changes, then reload or restart the server.

Check data/players.yml for the player’s last-daily-claim.

Also confirm the rewards menu has a click cooldown:

menus:
  rewards:
    click-cooldown-seconds: 2

AtlasLobby also prevents repeated reward processing before reward commands run.

Install:

Then run /al debug and check that Vault and your economy plugin are detected.

Check:

resource-pack:
  enabled: true
  url: "https://example.com/pack.zip"

If using sha1, make sure it is exactly 40 hex characters.