bag-tabs/README.md

Bag Tabs

Bag Tabs is a NeoForge mod for Minecraft 1.21.1 that adds a tab strip to inventory screens for bags and other portable storage items you are carrying.

The goal is simple: if you are carrying a bag, you should be able to open it directly from your inventory without moving it into your hand first.

What It Does

• Adds a tab bar to supported inventory screens.
• Shows one tab for each carried bag or portable storage item the mod recognizes.
• Checks supported Curios-equipped storage items as well as the normal player inventory.
• Lets you click a tab to open that bag directly.
• Keeps the tab bar visible while you move between supported bag screens.
• Highlights the currently open bag.
• Supports drag-and-drop insertion onto supported bag tabs when the bag can accept the carried stack.

Included Content

• A built-in Bag Tabs bag item.
• 27 inventory slots, like a single chest.
• Dyeable bag colors.
• Curios-compatible in the back and belt slots when Curios is installed.
• Crafting recipe.
• Creative tab with the base bag, all dyed variants, and the Bag Namer tool.
• JEI entries for the dyed bag variants.

Tab Features

• Bag tabs use the bag item icon for normal mode.
• Compact mode replaces the icon with the bag name.
• Dyed bags tint their tab background.
• Pinned tabs always appear first.
• Pinned tabs can be reordered by drag-and-drop.
• Tabs can be locked to disable pinning and reordering.
• Overflow arrows appear automatically when more tabs exist than can be shown.
• Mouse wheel scrolling works over the dock.
• Fullness indicators can be shown on tabs and toggled in dock settings.

Dock Features

• Dock to the GUI bottom, top, left, or right.
• Dock to the screen bottom, top, left, or right.
• Floating horizontal and floating vertical modes.
• Per-player, per-world saved settings.
• Global default settings plus per-screen overrides.
• Remembered scroll position per screen.
• Adjustable X/Y offset.
• Adjustable max visible tabs.
• Optional compact layout.
• Optional fullness indicator.
• Draggable in-game dock settings popup with live preview.

Bag Opening Behavior

Bag Tabs supports two kinds of bag opening:

• Direct support for bags with native or compatibility-backed integration.
• A fallback hotbar method for unsupported portable storage items that still look like bags or containers.

When a bag is not fully supported, the tooltip says:

• Mod not supported: uses hotbar method to open

If no warning is shown, the bag is using native or compatibility-backed support.

Current Compatibility

Bag Tabs currently includes compatibility support for:

• Bag Tabs bags
• Traveler's Backpack
• Sophisticated Backpacks
• Dank Storage
• Curios-equipped storage items are also detected when Curios is installed

Other portable storage items may still appear as tabs and may still open through the fallback hotbar method.

Bag Namer

Bag Tabs includes a Bag Namer tool that can rename portable storage items.

• Works on supported bags and inventory-like items.
• Uses an in-world style GUI with input and output slots.
• Does not close after each rename, so items can be renamed in batches.
• Drops its contents if you leave the screen.

Controls

• Left-click tab: open bag
• Right-click tab: pin or unpin
• Drag pinned tab: reorder pinned tabs
• Mouse wheel over dock: scroll visible tabs
• \ by default: open last bag

Notes

• Bag Tabs is designed to stay attached to existing inventory screens rather than replacing them.
• Unsupported bags may behave differently depending on how their mod handles right-click opening.
• Some mods may still need dedicated compatibility if they do not expose normal item-use behavior.
• Mod authors can integrate directly through the Bag Tabs API described in API.md.