Storage

Turn any ItemsAdder custom block or furniture into a storage container. Supports shared storage, shulker-style portable containers, and trash disposal modes.

Turns any custom block or furniture into a storage container. Three modes are available.

Type	Behaviour
`STORAGE`	Shared container - all players see the same inventory
`SHULKER`	Contents travel inside the item when broken and are restored on re-place
`DISPOSAL`	Trash can - contents are silently deleted when the GUI is closed

Configuration

behaviours:
  storage:
    type: STORAGE
    rows: 3 # optional, default: 3
    inventory_type: furnace # optional, replaces rows when set
    title: "<gold>Community Chest</gold>" # optional, defaults to the block/furniture's name
    open_variant: my_open_storage # optional
    open_sound: # optional
      name: entity.villager.celebrate # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER
    close_sound: # optional
      name: entity.villager.ambient # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER

behaviours:
  storage:
    type: SHULKER
    rows: 3 # optional, default: 3
    inventory_type: furnace # optional, replaces rows when set
    title: "<dark_purple>Portable Storage</dark_purple>" # optional, defaults to the block/furniture's name
    open_variant: my_open_storage # optional
    open_sound: # optional
      name: entity.villager.celebrate # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER
    close_sound: # optional
      name: entity.villager.ambient # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER

behaviours:
  storage:
    type: DISPOSAL
    rows: 1 # optional, default: 3
    title: "<red>Trash Can</red>" # optional, defaults to the block/furniture's name
    open_variant: my_open_storage # optional
    open_sound: # optional
      name: entity.villager.celebrate # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER
    close_sound: # optional
      name: entity.villager.ambient # or a custom sound
      volume: 1.0 # optional, default: 1.0
      pitch: 1.0 # optional, default: 1.0
      category: MASTER # optional, default: MASTER

For name, use a value from Sounds.json or a custom sound with namespace:value.

Supports MiniMessage formatting, PlaceholderAPI placeholders, and ItemsAdder font images.

Inventory type

By default, storage opens a chest-style inventory whose height is controlled by rows (1–6, default: 3). Set inventory_type to open a typed inventory instead — rows is ignored when this is set.

Value	GUI shape
`furnace`	Furnace (input + fuel + output)
`blast_furnace`	Blast furnace
`smoker`	Smoker
`brewing_stand`	Brewing stand (3 bottles + 2 slots)
`dispenser`	Dispenser (3×3)
`dropper`	Dropper (3×3)
`hopper`	Hopper (1×5)

behaviours:
  storage:
    type: STORAGE
    inventory_type: furnace
    title: "<gray>Custom Furnace</gray>"

Open variant

You can optionally set open_variant to make the custom block, furniture, or complex furniture change into another variant while at least one player has the storage open.

This is useful for things like:

chests that visually open
barrels with an opened model
containers with a different active state

behaviours:
  storage:
    type: STORAGE
    open_variant: my_open_storage

open_variant should be the ID of another custom block, furniture, or complex furniture, using either:

id
namespace:id

When the inventory is closed by all players, the storage returns to its normal variant.

Configuration

Inventory type

Open variant

On this page