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

---

✨ Core 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.
    
  • 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.
    
  • 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
    
  • Conditions: Auto-pickup is skipped if the player is sneaking, the item is blacklisted (Cake, Pumpkin Pie, or Bundles), or if adding a new unique item type would exceed 9 unique types.
    
  
  

Bundle Item Interaction Rules

• Nesting Prevention: Prevents putting a non-empty Bundle into another Bundle.
  
• Blacklists: Prevents blacklisted items (Cake, Pumpkin Pie, Shulker Boxes) from being manually placed into a Bundle via the custom GUI or right-click interaction.
  
• Unique Item Limits: Auto-pickup is limited to 9 unique item types. Manual insertion in the 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 (Per-Player Preference)
(These settings are saved per-player on the server and override global settings.)

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

---

🧩 Feature Control 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 (/sb personal command or ModMenu config). If disabled here, the feature is always OFF for the player.
  
• 2. Server's Global Setting: If the player enabled it personally, the server then checks its 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) as a final override.
  

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.

---

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

---

📧 Contact Me & Support Information

### 💬 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
While we prefer all issues to be handled via the Discord server first, you are welcome to 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.
  
• 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 to be helpful and see what I can do to resolve your urgent issue. However, please understand that immediate responses are not guaranteed, and private messaging is a professional courtesy, not an entitlement. Thank you for your understanding and cooperation!