Troubleshooting

Run Debug

Use:

/al debug

It shows:

  • Plugin version.
  • Server version.
  • Java version.
  • Platform detection.
  • Optional dependencies.
  • Spawn status.
  • Lobby worlds.
  • Loaded menu, item, server, announcement, and cosmetic counts.
  • Resource pack status.
  • Storage type.
  • Protection status.
  • Particle task status.
  • Scoreboard task status.
  • Validation warnings.

Players Can Drop Items

Check:

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

Also confirm /al reload was run or the server was restarted after config changes.

Players Can Keep Command-Given Items

Check:

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

AtlasLobby removes non-configured items during sanitizer passes.

Lobby Item Runs On Left Click

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

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

Make sure your jar includes the latest changes and reload/restart the server.

Rewards Can Be Claimed Repeatedly

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

menus:
  rewards:
    click-cooldown-seconds: 2

Vault Cosmetic Prices Do Not Work

Install:

  • Vault.
  • An economy plugin that registers with Vault.

Then run /al debug and check Economy hooked: true.

Resource Pack Does Not Send

Check:

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

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