101 lines
3.8 KiB
Markdown
101 lines
3.8 KiB
Markdown
# 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).
|