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.

Features

Direct GUI Access

• Shulker Box GUI: Shift-right-click a Shulker Box (in main or off-hand) to open its 27-slot GUI without placing it down!
  • An "Editing Shulker: [Shulker Name]" placeholder appears in your hand while the GUI is open.
  • Permission: shulkerbundle.open (Defaults to enabled if no permission manager is present or in single-player).
  • Note: Stacked shulker boxes in hand cannot be opened.
• Bundle GUI: 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.
  • Note: The Bundle GUI cannot be opened if the bundle contains more than 27 unique item types.
  • Permission: shulkerbundle.open_bundle_gui (Defaults to enabled if no permission manager is present or in single-player).

Automatic Item Collection

• Shulker Auto-Pickup (Off-hand): Items you pick up go directly into your off-hand Shulker Box if space is available.
  • Permission: shulkerbundle.hold.shulker (Defaults to enabled if no permission manager is present or in single-player).
  • Notifications: 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).
    • Notification Logic: These notifications are active if global notifications are enabled. If global notifications are disabled, they are active only if the player has the shulkerbundle.notify.shulker permission.
  • Exclusions: Will not pick up other Shulker Boxes, Bundles, or placeholder items.
  • Note: Stacked shulker box items in the off-hand are not supported for auto-pickup.
• Bundle Auto-Pickup (Inventory & Off-hand): Items you pick up go directly into any available Bundles in your main inventory or off-hand.
  • Permission: shulkerbundle.hold.bundle (Defaults to enabled if no permission manager is present or in single-player).
  • Notifications: 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.
    • Notification Logic: These notifications are active if global notifications are enabled. If global notifications are disabled, they are active only if the player has the shulkerbundle.notify.bundle permission.
  • Conditions: 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

• GUI Blacklist: 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.
• Manual Inventory Interaction Restrictions: Similar restrictions apply when trying to right-click items from your cursor into a Bundle in your inventory (e.g., via the BundleItem.onClicked interaction).
  • 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.
• Bundle Nesting Prevention (Left-Click): Prevents putting a Bundle held on the cursor into another Bundle in an inventory slot by left-clicking.
• Unique Item Limits: Auto-pickup into Bundles is limited to 9 unique item types. Manual insertion into the Bundle GUI is limited to 27 unique item types.

Commands

• /shulkerbundle or /sb:
  • Shows the main help page for the mod.
  • /shulkerbundle notify: Toggles global action bar notifications for Shulker Boxes and Bundles.
    • Permission: shulkerbundle.admin (Defaults to OP Level 2).

Single-Player & Permissions Notes

• Single-player: All features are available by default and do not require setting up a permission manager. The global notification toggle will function as expected.
• Multiplayer: This mod uses the Fabric Permissions API. All features requiring permissions (listed above) need a compatible permission manager (e.g., LuckPerms) to be present on the server for full control.
• Global Notification Control (/shulkerbundle notify): This command toggles the global state of action bar notifications.
  • If global notifications are ENABLED, everyone receives them, regardless of their individual shulkerbundle.notify.* permissions.
  • If global notifications are DISABLED, only players with the specific `shulkerbundle.notify.` permission node* will receive them.

Modpack Policy

• You ARE PERMITTED 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.