ForbiddenChest

ForbiddenChest – Prevent Items from Entering Containers
A lightweight & powerful item-restriction plugin

✨ Description
Do you want to stop players from placing certain items into any type of chest, ender chest, or hopper?
ForbiddenChest is the perfect solution!

This plugin blocks restricted items from entering containers through every possible method —
even Shift+Click, Drag, Hotbar Swap, Number Keys, Hopper Transfers and more.

Completely prevents item–storage exploits
Highly customizable
Perfect for SMP, PvP, Factions, Economy servers and more

Features

• Fully blocks restricted items from these containers:
– Chests
– Ender Chests
– Hoppers
– Barrels
– Shulker Boxes
(All configurable)

• Prevents ALL transfer methods:
Normal Click
Shift+Click
Dragging
Number-Key Swaps
Hotbar Swaps
Even Hopper → Container item movement

• Fully configurable
– Custom blocked item list
– Custom blocked container list
– Custom messages & deny sounds

• Admin permission:
`forbiddenchest.bypass`
Players with this permission are not restricted.

• Ultra lightweight
Fast, stable and optimized for all sizes of servers.

⚙️ Config File

# ─────────────────────────────────────────────
#  GENERAL SETTINGS
# ─────────────────────────────────────────────

blocked-items:
  - DIAMOND
  - NETHERITE_INGOT
  - TNT
  - EMERALD

blocked-containers:
  chest: true
  ender_chest: true
  hopper: true
  barrel: true
  dispenser: true
  dropper: true

deny-place:
  enabled: true
  sound: ENTITY_VILLAGER_NO
  message: "&cYou cannot place this item inside this container!"

# ─────────────────────────────────────────────
#  AUTO TRANSFER FEATURE (ONLY ENDER CHEST)
# ─────────────────────────────────────────────

autotransfer:
  enabled: true
  delay-seconds: 60

  countdown:
    enabled: true
    interval-seconds: 10
    message: "&eWarning! Your restricted items will be moved in &c{time} &eseconds!"

  items:
    - DIAMOND
    - EMERALD
    - TNT
    - NETHERITE_INGOT

  final-message: "&cYour blocked items were moved out of your Ender Chest!"
  dropped-message: "&cYour inventory was full. Blocked items were dropped at your feet."

# ─────────────────────────────────────────────
#  ADVANCED SETTINGS
# ─────────────────────────────────────────────

permissions:
  bypass: forbiddenchest.bypass
  reload: forbiddenchest.reload

logging:
  enabled: true
  log-file: plugins/ForbiddenChest/logs.txt
  log-actions: true # Log every blocked placement / hopper pickup

hopper-protection:
  enable: true # Prevent blocked items from being sucked into any hopper
  enable-minecart: true # Also block hopper minecarts

# ─────────────────────────────────────────────
#  OPTIONAL MESSAGES PER CONTAINER
# ─────────────────────────────────────────────

messages:
  chest: "&cYou cannot put blocked items in this chest!"
  ender_chest: "&cBlocked items cannot stay in Ender Chest!"
  hopper: "&cHoppers cannot take blocked items!"
  barrel: "&cBlocked items cannot enter barrel!"
  dispenser: "&cBlocked items cannot enter dispenser!"
  dropper: "&cBlocked items cannot enter dropper!"

Permission

forbiddenchest.bypass

Compatibility
Paper / Spigot 1.21 +
Stable and fully tested.

Feedback & Suggestions
Have a feature request or bug report? I’d be happy to improve the plugin in future updates.

Thank you for using ForbiddenChest!