Shulker & Bundle

Shulker & Bundles - Enhanced Inventory Management!

Tired of inventory overflow? Shulker & Bundles supercharges your storage solutions by allowing seamless interaction with Shulker Boxes and Bundles directly from your inventory! Pick up items into your off-hand Shulker or any Bundle, and access their contents using shift right-click while holding on the fly with intuitive GUIs.

---

New Support: Reinforced Shulker Boxes

Features

Direct GUI Access

* Permission: Shift-right-click a Shulker Box (in main or off-hand) to open its 27-slot GUI Permission: * An "Editing Shulker: [Shulker Name]" placeholder appears in your hand while the GUI is open. * Permission: `shulkerbundle.open` * Permission: Stacked shulker boxes in hand cannot be opened. * Permission: Shift-right-click a Bundle (in main or off-hand) to open a dynamic custom GUI. * The GUI size adjusts to 9, 18, or 27 slots based on the number of unique item types already within the bundle (max 27 unique types for manual interaction). * An "Editing: [Bundle Name]" placeholder appears in your hand while the GUI is open. * Permission: The Bundle GUI cannot be opened if the bundle contains more than 27 unique item types. * Permission: `shulkerbundle.open_bundle_gui`

Automatic Item Collection

* Exclusions: Items you pick up go directly into your off-hand Shulker Box if space is available. * Exclusions: `shulkerbundle.hold.shulker` * Exclusions: Receive action bar messages showing "Shulker has X empty slots left" when items are picked up, specifically triggered by a new item filling a slot in the third row (slots 18-26). * Exclusions: Will not pick up other Shulker Boxes, Bundles, or placeholder items. * Exclusions: Stacked shulker box items in the off-hand are not supported for auto-pickup. * Exclusions: Items you pick up go directly into any available Bundles in your main inventory or off-hand. * Exclusions: `shulkerbundle.hold.bundle` * Exclusions: Receive action bar messages indicating "Bundle has (X/64) items" if the bundle has 32 or more items but is not full, or "Bundles with space X" otherwise. * Exclusions: Auto-pickup into Bundles is skipped if the player is sneaking, the item is on the auto-pickup blacklist (Cake, Pumpkin Pie, or other Bundles), or if adding a new unique item type would exceed 9 unique types already in the bundle. * Exclusions: Items marked with the `CrateBundleNoAutoPickup` NBT tag are ignored.

Bundle Item Interaction Rules

* 27 unique item types Prevents `Cake`, `Pumpkin Pie`, `Shulker Box` items, and other `Bundle` items (unless empty) from being manually placed into a Bundle via the custom GUI. Placeholder bundles and shulkers are also blocked. * 27 unique item types Similar restrictions apply when trying to right-click items from your cursor into a Bundle in your inventory. * Attempting to add blacklisted items or exceeding unique item limits via right-click will be blocked. * Any non-empty Bundle cannot be put into another Bundle. * 27 unique item types Prevents putting a Bundle held on the cursor into another Bundle in an inventory slot by left-clicking. * 27 unique item types Auto-pickup into Bundles is limited to 27 unique item types. Manual insertion into the Bundle GUI is limited to 27 unique item types.

Commands (Admin & Personal)

* `/shulkerbundle` or `/sb`: Shows the main help page for the mod.

Global Commands (Admin-Only)

*Requires the `shulkerbundle.admin` permission (OP Level 2).* * `/sb global gui [shulker|bundle]`: Toggles the ability to open GUIs for all players. * `/sb global pickup [shulker|bundle]`: Toggles auto-pickup functionality for all players. * `/sb global notify [shulker|bundle]`: Toggles action bar notifications for all players.

Personal Commands

*These commands allow each player to toggle features for themselves. They are saved per-player on the server.* * `/sb personal gui [shulker|bundle]`: Toggles your personal preference for opening GUIs. * `/sb personal pickup [shulker|bundle]`: Toggles your personal preference for auto-pickup. * `/sb personal notify [shulker|bundle]`: Toggles your personal preference for notifications.

---

Client-Side Configuration (via ModMenu)

* If you have ModMenu installed, you can access a detailed config screen. * Settings are split into Multiplayer and Multiplayer categories, allowing you to have different preferences for each context. * These toggles are an alternative to the `/sb personal` commands and give you full control over your experience.

How Features are Controlled (Permission Hierarchy)

This mod uses a 3-layer system to determine if a feature is active for a player. 1. Server Permissions: The player must have the feature enabled in their personal settings (via the ModMenu config or `/sb personal` command). If a player disables a feature, it will Server Permissions: be off for them, regardless of server settings. 2. Server Permissions: If the player has the feature enabled, the server then checks its global settings. If the feature is enabled globally (via `/sb global`), the player can use it. 3. Server Permissions: If the feature is disabled globally, the server will then check if the player has the specific permission node for it (e.g., `shulkerbundle.open`).

* "Deny Server Permissions" The multiplayer config screen has a "Deny Server Permissions" toggle. When enabled, it acts as a "hard opt-out," forcing all of this mod's features to be disabled for you on the server, ignoring any global settings or permissions.

Server Administration

* Server Configuration: The server can detect if players have the mod installed. If a player joins without it, they will receive an action bar message with a clickable link to this page. This message only appears twice per player. * Server Configuration: Server owners can disable this notification message by setting `notifyPlayer: false` in the `shulkerbundle.json` config file.

---

---

Modpack Policy

* You must not be sold to include this mod in any modpack. * Please do not modify the mod's JAR file directly. * The modpack itself, or access to this mod within the modpack, must not be sold.