📦 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 (Shift + Right-Click)

• 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
  • 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.
  • An "Editing: [Bundle Name]" placeholder appears in your hand while the GUI is open.
  • Permission: shulkerbundle.open_bundle_gui
  • Note: The GUI is limited to 27 unique item types for manual interaction.

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
  • Notifications: Action bar messages notify you of "Shulker has X empty slots left" when items are successfully picked up.
  • Exclusions: Will not pick up other Shulker Boxes, Bundles, or placeholder items.
• 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
  • Notifications: Action bar messages indicate the Bundle's fill status, e.g., "Bundle has (X/64) items".
  • Unique Item Limit: Auto-pickup is limited to 9 unique item types to prevent excessive clutter.
  • Conditions: Skipped if you are sneaking, the item is blacklisted (Cake, Pumpkin Pie, other Bundles), or if a new unique item type would exceed the limit.

Bundle Item Interaction Rules

• Blacklists: Items like Cake, Pumpkin Pie, Shulker Box items, and other non-empty Bundle items are prevented from being manually placed into a Bundle via the custom GUI or manual inventory interaction (right-click).
• Nesting Prevention: Putting a Bundle into another Bundle is strictly prevented via left-click.
• Unique Item Limits: Manual insertion into the Bundle GUI is limited to 27 unique item types.

💻 Commands

Global Commands (Admin-Only)

Requires the shulkerbundle.admin permission (OP Level 2).

Personal Commands

These settings are saved per-player on the server, offering full personal control.

• Base Command: Use /shulkerbundle or /sb to view the main help page.

⚙️ Configuration & Control

Client-Side Configuration (via ModMenu)

If you have ModMenu installed, you can access a detailed config screen with settings split into Singleplayer and Multiplayer categories. This is an alternative to the /sb personal commands and gives you a visual way to control your experience.

Permission Hierarchy (3-Layer System)

This mod uses a system to determine if a feature is active for a player:

1. Player's Choice (Client-Side): The feature must be enabled in the player's personal settings (/sb personal or ModMenu). If a player disables a feature, it is always off for them.
2. Server's Global Setting: If the player allows it, the server checks the global setting (/sb global). If enabled globally, the player can use it.
3. Server Permissions: If the feature is disabled globally, the server checks if the player has the specific permission node (e.g., shulkerbundle.open).

Master Override: The multiplayer config screen has a "Deny Server Permissions" toggle. When enabled, this acts as a "hard opt-out," forcing all mod features to be disabled for you on the server, ignoring all other settings/permissions.

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.

📧 Support & Contact

💬 Primary Support Channel (Preferred)

All general questions, feature requests, and non-urgent bug reports should be posted in the appropriate channels on our Discord Server. We actively monitor the server and will respond as soon as possible.

🆘 Urgent Private Messaging (PM) Policy

We prefer all issues be handled publicly, but you may PM me directly under specific urgent circumstances:

• Allowed Reason: Your server is crashing or experiencing critical, game-breaking errors directly related to one of my mods/plugins.
• Requirement: You must be the owner of the server.
• Time Zone: I operate in the (CET/CEST) Time Zone.
• PM Hours: Please only send private messages between 10:00 AM and 10:00 PM (Brussels Time).

I will endeavor to answer your PM as soon as I can, but please understand that immediate responses are not guaranteed. Thank you for your understanding!

Looking for a feature? Check out my other mods!

All permission nodes and their descriptions

• shulkerbundle.open: Allows opening the Shulker Box GUI with shift-right-click.
• shulkerbundle.open_bundle_gui: Allows opening the custom Bundle GUI with shift-right-click.
• shulkerbundle.hold.shulker: Allows items to be automatically inserted into the off-hand Shulker Box.
• shulkerbundle.hold.bundle: Allows items to be automatically inserted into Bundles in the player's inventory.
• shulkerbundle.notify.shulker: Allows players to receive action bar notifications for Shulker Box fill status.
• shulkerbundle.notify.bundle: Allows players to receive action bar notifications for Bundle fill status.
• shulkerbundle.admin: Grants administrative permissions (Default: OP Level 2).
• shulkerbundle.command.use: Allows use of the base /shulkerbundle command (Default: anyone).

📦 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.

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

• 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
  • 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

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
  • 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).
  • 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
    • 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.
    • 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.
  • 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 (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 Singleplayer 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. Player's Choice (Client-Side): 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 always be off for them, regardless of server settings.
2. Server's Global Setting: 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).

• Master Override: 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

• Client Mod Detection: 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 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.