Inventory Control and Protection

AtlasLobby is strict by default. It is designed for lobby servers where players should only hold configured lobby items.

Inventory Control

Configured in config.yml:

inventory-control:
  enabled: true
  apply-to-all-worlds: true
  allow-bypass-permission: false
  clear-on-join: true
  clear-on-respawn: true
  allow-only-config-items: true
  block-drop: true
  block-pickup: true
  lock-inventory-clicks: true
  block-offhand-swap: true
  blocked-action-sound:
    enabled: true
    sound: BLOCK_NOTE_BLOCK_CHIME
    volume: 0.9
    pitch: 0.55
  sanitize:
    enabled: true
    interval-ticks: 20

What It Blocks

  • Dropping items.
  • Picking up items.
  • Inventory clicking.
  • Inventory dragging.
  • Offhand swapping.
  • Keeping command-given items.
  • Moving configured lobby items into wrong slots.

On join and respawn, AtlasLobby clears the inventory and gives only configured items.

Lobby Item Interaction

Lobby item actions run only on right-click. Left-click is cancelled and plays the blocked-action sound. Dropping is cancelled and plays the same sound.

Protection

Protection is configured in config.yml:

protection:
  enabled: true
  apply-to-all-worlds: true
  allow-bypass-permission: false
  block-break: true
  block-place: true
  pvp: true
  damage: true
  hunger: true
  item-drop: true
  item-pickup: true

Excluding Worlds

inventory-control:
  disabled-worlds:
    - survival

protection:
  disabled-worlds:
    - survival

Enabling Bypass Permissions

Bypass permissions exist, but config disables them by default.

inventory-control:
  allow-bypass-permission: true

protection:
  allow-bypass-permission: true

Then players with atlaslobby.bypass.itemlock or atlaslobby.bypass.protection can bypass those systems.