Protected Items

Protected Items

Overview

Protected Items lets server operators mark any item as protected. A protected item stays with the player no matter what — it cannot be dropped, lost on death, placed, used, or moved into external storage.

The protection flag is stored in the item's Persistent Data Container (PDC), so it survives server restarts and transfers between inventories.

Commands

| Command | Permission | Description | |---------|-----------|-------------| | `/protected add` | `protecteditems.use` | Mark the held item as protected | | `/protected remove` | `protecteditems.use` | Remove protection from the held item | | `/protected check` | `protecteditems.use` | Check whether the held item is protected | | `/protected list` | `protecteditems.use` | List your own protected items | | `/protected list <player>` | `protecteditems.admin` | List protected items in another player's inventory | | `/protected listall` | `protecteditems.admin` | List all protected items across the server |

All commands require the item to be in the player's main hand (except `list` and `listall`). Commands can only be executed by players, not from the console.

Permissions

| Permission | Default | Description | |-----------|---------|-------------| | `protecteditems.use` | op | Allows using the `/protected` command | | `protecteditems.admin` | op | Allows `/protected list <player>` and `/protected listall` | | `protecteditems.bypass-store` | op | Allows placing protected items into any container |

Protected Item Behavior

Drop

Attempts to drop a protected item are cancelled. The player receives a message.

Death

Protected items are not dropped on death. They are restored to the player's inventory upon respawn. If there is not enough space, they are dropped near the player.

Block Placement

Placing a protected item as a block is cancelled.

Right-Click Use

Right-click usage of consumable/throwable items (eggs, snowballs, spawn eggs, etc.) is cancelled when the item is protected.

Containers

Protected items can be moved into regular containers (chests, barrels, hoppers, etc.). However, they can be stored in ender chests.

Players with the `protecteditems.bypass-store` permission can place protected items into any container (useful for distributing items to other players).

Item Frames

Protected items cannot be placed into item frames.

Localization

The plugin supports English and Russian. The language is selected automatically based on each player's Minecraft client language setting. If the player's locale is not supported, English is used as the fallback.