Restricted Inventory

Quick rating

Restricted Inventory

No reviews yet

Restrict player inventory slots to specific items or item tags. Configure which slots accept which items via JSON config — server-wide or per-client. Restricted slots display a visual preview of what belongs there.

QoL & Tweaks
Mod Loaders
Forge
NeoForge
Fabric
Minecraft
26.2

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Unknown
Server Unknown

About

Project Details

Type
Mod
License
MIT License
Latest Version
restrictedinventory-20.1.4+1.20.1-fabric
Authors
CurseForge
Modrinth

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

CurseForge ID
Modrinth ID

Resources

External Links

About

Description

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

Commands

All commands use the /restrictedinventory prefix.

Command Description Permission
/restrictedinventory config Opens the Restriction Config Screen Admin (OP level 4), or any player when useClientRestriction is enabled

Permission rules

  • When useClientRestriction is false (server-wide mode): only server operators (OP level 4) can open the config screen.
  • When useClientRestriction is true (per-client mode): every player can open their own config screen.

Restriction Config Screen

The config screen is the in-game GUI for editing slot restrictions. Open it with /restrictedinventory config.

Item / Tag picker (top panel)

  • Items tab — lists every registered item at ¾ scale. Hover for the item name and registry ID. Click to select.
  • Tags tab — lists every registered item tag. Each tag cycles through its members as a live preview. Hover for the tag ID. Click to select.
  • Scroll with the mouse wheel or drag the scrollbar on the right.

Slot grid (middle panel)

  • Displays all 36 player inventory slots (0–35) laid out in the standard inventory arrangement.
  • Each slot shows a cycling preview of its current restriction, or is empty if unrestricted.
  • Left-Click a slot to select it (highlighted in white). The selected slot will receive the item or tag chosen in the picker.
  • Right-Click a slot to remove the item or tag chosen.
  • Hover a slot to see its current restriction value as a tooltip.

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.

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

Commands

All commands use the /restrictedinventory prefix.

Command Description Permission
/restrictedinventory config Opens the Restriction Config Screen Admin (OP level 4), or any player when useClientRestriction is enabled

Permission rules

  • When useClientRestriction is false (server-wide mode): only server operators (OP level 4) can open the config screen.
  • When useClientRestriction is true (per-client mode): every player can open their own config screen.

Restriction Config Screen

The config screen is the in-game GUI for editing slot restrictions. Open it with /restrictedinventory config.

Item / Tag picker (top panel)

  • Items tab — lists every registered item at ¾ scale. Hover for the item name and registry ID. Click to select.
  • Tags tab — lists every registered item tag. Each tag cycles through its members as a live preview. Hover for the tag ID. Click to select.
  • Scroll with the mouse wheel or drag the scrollbar on the right.

Slot grid (middle panel)

  • Displays all 36 player inventory slots (0–35) laid out in the standard inventory arrangement.
  • Each slot shows a cycling preview of its current restriction, or is empty if unrestricted.
  • Left-Click a slot to select it (highlighted in white). The selected slot will receive the item or tag chosen in the picker.
  • Right-Click a slot to remove the item or tag chosen.
  • Hover a slot to see its current restriction value as a tooltip.

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.

Screenshots

Gallery

  • Screenshot 2026-06-18 223044.png
    Screenshot 2026-06-18 223044.png Screenshot 2026-06-18 223044.png
  • Screenshot 2026-06-09 221612.png
    Screenshot 2026-06-09 221612.png Screenshot 2026-06-09 221612.png
  • Screenshot 2026-06-09 221338.png
    Screenshot 2026-06-09 221338.png Screenshot 2026-06-09 221338.png
  • Inventory showing slot index
    Inventory showing slot index Iventory showing slot index when Tab key is pressed
  • Inventory with restricted slots
    Inventory with restricted slots All slots is restricted to different items.
  • Config Screen
    Config Screen Player/Admin can set per slot restricted item/tag with config screen

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

~1,000
Total Downloads
CurseForge
<1,000
Modrinth
<1,000
Last Updated
CurseForge
Created
CurseForge
Modrinth
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works