Restricted Inventory

Lock player inventory slots to specific items or item tags.

Ever wanted to keep a dedicated slot for your sword, always have slot 0 as your torch, or enforce item organization across your server? Restricted Inventory lets you do exactly that — configure any inventory slot (0–35) to only accept a specific item or item tag, server-wide or per player.

Features

Slot restrictions — Lock any hotbar or inventory slot to a specific item (e.g. minecraft:torch) or an entire item tag (e.g. #minecraft:swords)
Server or per-client mode — Apply the same rules to all players from the server config, or let each player define their own restrictions in their client config
Visual feedback — Restricted slots display a ghost preview of the required item so players always know what goes where
Slot index overlay — Hold Tab in any inventory screen to reveal each slot's index number, making config setup a breeze
Smart item routing — Picked-up items automatically go to their designated slots first before filling unrestricted ones

Configuration

Restrictions are defined in a simple JSON config file. Both specific items and item tags are supported.

{
  "useClientRestriction": false,
  "restrictedSlots": {
    "0": "minecraft:torch",
    "1": "#minecraft:swords",
    "8": "minecraft:totem_of_undying"
  }
}

Slot range	Location
0–8	Hotbar (survival mode only)
9–35	Main inventory

Note: Slot indices 0–8 correspond to the hotbar in survival mode. In creative mode, the hotbar uses a different inventory layout and slot restrictions will not apply there.

Compatibility Note

This mod hooks into vanilla's slot placement and item pickup logic via Mixin. Mods or block entities that insert items directly into the player inventory (bypassing standard slot logic) may not respect the restrictions. Mods that also modify Slot, Inventory, or AbstractContainerScreen may conflict.