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

Command	Description
`/sb global gui [shulker\|bundle]`	Toggles GUI access for all players.
`/sb global pickup [shulker\|bundle]`	Toggles auto-pickup for all players.
`/sb global notify [shulker\|bundle]`	Toggles action bar notifications for all players.

Personal Commands

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

Command	Description
`/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.

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:

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