# 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](C:\Users\JessePersonal\Documents\Codex\minecraft-bag-tabs\API.md).