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

Inventory control is 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
  block-death-drops: 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: 2

Setting	Meaning
`enabled`	Turns inventory control on or off.
`apply-to-all-worlds`	Applies item control server-wide unless worlds are excluded.
`allow-bypass-permission`	Allows bypass permission checks when true. Defaults to false.
`clear-on-join`	Clears inventory on join before giving configured items.
`clear-on-respawn`	Clears inventory on respawn before giving configured items.
`allow-only-config-items`	Removes non-configured items during sanitizer passes.
`block-drop`	Blocks item dropping.
`block-pickup`	Blocks item pickup.
`block-death-drops`	Blocks death drops.
`lock-inventory-clicks`	Blocks inventory clicks and moving items.
`block-offhand-swap`	Blocks offhand swapping.
`blocked-action-sound`	Sound played when a blocked action happens.
`sanitize`	Repeatedly fixes inventories and item slots.

What Inventory Control Blocks

When enabled, AtlasLobby can block:

Dropping items.
Picking up items.
Inventory clicking.
Inventory dragging.
Offhand swapping.
Death drops.
Keeping command-given items.
Moving configured lobby items into the 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 also cancelled and plays the same sound.

AtlasLobby menus remain usable while strict inventory control is active. Clicks and drags inside AtlasLobby menus are cancelled by the menu system itself, while their configured actions still run.

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
  restore-food-level: true
  item-drop: true
  item-pickup: true

Setting	Meaning
`enabled`	Turns protection on or off.
`apply-to-all-worlds`	Applies protection server-wide unless worlds are excluded.
`allow-bypass-permission`	Allows bypass permission checks when true. Defaults to false.
`block-break`	Blocks block breaking.
`block-place`	Blocks block placing.
`pvp`	Blocks PvP.
`damage`	Blocks damage.
`hunger`	Blocks hunger loss.
`restore-food-level`	Restores food level.
`item-drop`	Blocks item dropping through protection.
`item-pickup`	Blocks item pickup through protection.

Excluding Worlds

Exclude worlds with disabled-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

When enabled:

atlaslobby.bypass.itemlock can bypass inventory control.
atlaslobby.bypass.protection can bypass protection.