Integrated UI

A NeoForge mod for Minecraft 1.21.1 that adds backpacks, carried container items (shulker boxes, sacks, and similar) and Curios/Accessories slots to the survival inventory screen.

This mod integrates a variety of different inventory UI elements from different mods into a unified and cohesive user interface. while the emphasis is on cross mod compatibility, this can be used without any of the mentioned optional dependencies. When used in an otherwise vanilla environment it will still add the functionality to view shulker box inventories along side your main inventory.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.214 or later
• Required on both the client and the server, except for the client-only integrations listed under Optional dependencies.

Features

Integrated inventory screen

• Replaces the vanilla survival inventory screen.
• Keeps the 2x2 crafting grid, armor slots, offhand slot, recipe book and status effects. Other mods still see it as the player's inventory menu.
• Adds a band of extra slots between the crafting area and the main inventory to display held containers and backpacks.
• Adds an equipment panel on the left for Curios or Accessories slots.
• Status effects move right to make room for the band's scroll tab. They switch to compact mode or are hidden when there isn't enough space.

The band

Shows one of the following at a time:

1.  Equipped Backpacked backpacks, in Backpacked's order.
2.  A Quark backpack worn in the chest slot.
3.  Container items in the player's inventory. These are grouped by kind (shulker boxes before sacks), then by color (undyed first, then in dye order), then by position in the inventory.

• Previous/next buttons and a position counter (such as 2/5) appear in the band header when there is more than one thing to show.
• Keybinds for previous/next: Page Up and Page Down by default. They work only inside the inventory screen and can be rebound under the "Integrated UI" category.
• The band remembers what each player last looked at and shows it again the next time they open their inventory, including after respawning or changing dimension.
• Grids taller than the visible row limit scroll vertically, using the mouse wheel or the scrollbar tab on the right edge of the window. Grids wider than 9 columns scroll horizontally, using Shift + mouse wheel or the scrollbar.
• The number of visible rows is set in the client config (1 to 11, default 3). Fewer rows are shown if the screen is too short.
• The band is colored to match what it shows:
  • Shulker boxes and other dyed items use their dye color, taken from the c:dyed/<color> tags.
  • Some undyed items use a fixed color; other undyed items use the color of their block.
  • Backpacked backpacks use Backpacked's sprites.
  • The Quark backpack uses Quark's leather texture.
• Rename button in the header: edits the name in place. A blank name removes the custom name, and names are limited to 50 characters.
• Open button in the header: opens the item in its own full screen (Backpacked's backpack screen, or the container item's screen).

Container items

• A container item is any item that stores its contents in the vanilla container data component and keeps them when its block is broken. This includes vanilla shulker boxes, Supplementaries sacks, and any other mod's items built the same way.
• The following are never shown in the band:
  • Items with a vanilla lock
  • Items in the integrated_ui:band_excluded tag (by default, the Supplementaries safe)
  • Items with no more than the configured minimum number of slots (default: 1)
• Optionally, only items on a config whitelist of item ids and #tags are shown.
• While the item is on the cursor or in the crafting grid (for example, while dyeing it), its slots stay visible but are locked and shaded. If the item leaves the inventory, the band moves on to the next container.

Opening container items in their own screen

• Right-clicking a container item in the player's inventory with an empty cursor opens it in its own screen. This works in any container screen that shows the player's inventory (a chest's, for example) but not in the creative inventory.
• Only items in the integrated_ui:opens_own_screen tag can be opened this way. By default the tag contains #c:shulker_boxes and #supplementaries:sacks.
• Each item opens in one of these screens:
  • Shulker boxes: the vanilla shulker box screen.
  • Sacks: Supplementaries' sack screen.
  • Other items: a vanilla chest screen with as many rows as the item needs.
• The item's own inventory slot is locked and shaded while its screen is open, so it can't be moved, dropped or swapped away. The screen closes if the item is lost anyway.
• Closing the screen returns to the inventory if it was opened from there. If it was opened from another container, closing it returns to the world.
• In the inventory, shulker boxes are left to Quark when Quark opens them itself.

Equipment panel (Curios / Accessories)

• A collapsible, scrollable panel of Curios or Accessories slots on the left of the inventory window.
• The show/hide toggle remembers its state across sessions.
• Hovering an empty slot shows the slot's name.
• With Accessories, a button shows or hides unused slots. This uses Accessories' own per-player setting.
• If both Curios and Accessories are installed, Accessories is used, since its compatibility layer already holds the Curios slots.

Robustness

• Calls into other mods' internals go through a guard. If a mod update renames a class, method or field Integrated UI relies on, that mod's integration is turned off for the rest of the session and one error is logged. Integrated UI then behaves as if that mod weren't installed.
• The server sends the equipment slot layout to the client, so both sides always build the same slots.

Optional dependencies

None of these are required. Each integration can be turned off in the config, which makes Integrated UI behave as if the mod weren't installed.

Configuration

Client (config/integrated_ui-client.toml)

Server (serverconfig/integrated_ui-server.toml, per world, synced to clients)

Changes take effect the next time the inventory is opened.

Every option has a translated name, so config screen mods such as Configured show readable labels.

Item tags

Both tags can be extended with datapacks.

License

GPL-3.0-only. See LICENSE.