Shulker_in_Shulker

Shulker In Shulker

The Ultimate Nested Storage Solution for Minecraft Servers

📦 What is Shulker In Shulker?

Shulker In Shulker revolutionizes storage on your Minecraft server by allowing players to nest shulker boxes within other shulker boxes! Imagine the possibilities — store your shulker boxes inside another shulker box, creating virtually unlimited portable storage with full administrative control.

Fully compatible with Geyser — works seamlessly for both Java and Bedrock players with no extra setup required!

Perfect for survival servers, SMP communities, prison servers, and any server where organized storage matters!

✨ Key Features

🎯 Core Functionality

• 📥 Nested Storage — Store shulker boxes inside other shulker boxes
• 🎚️ Configurable Depth — Control how many layers deep players can nest (default: 3 layers)
• 📊 Smart Limits — Set limits on shulkers per shulker and items per shulker
• 🖱️ Intuitive GUI — Easy-to-use interface for navigating nested shulkers
• ⚡ Lightweight — Optimized performance with minimal server impact
• 🌐 Geyser Compatible — Works with Bedrock players via Geyser/Floodgate, no client mods needed

🛡️ Security & Protection

• 🔒 Anti-Dupe System — Built-in protection against duplication exploits
• ⏱️ Cooldown System — Prevent spam and reduce server lag
• 🚫 Item Blocklist — Block specific items from being stored in nested shulkers
• 👮 Permission Control — Granular permissions for different player groups

⚙️ Administrative Control

• 🎛️ In-Game Settings GUI — Modify all settings without editing files
• 🗂️ Blocked Items GUI — Manage your item blocklist visually, directly in-game — no config editing needed
• 📝 Hot Reload — Update configuration without restarting
• 🎁 Give Command — Easily distribute shulker boxes to players
• 🔧 Fully Customizable — Every aspect can be configured to your needs
• 🎨 Custom Messages — Personalize all plugin messages with color codes

🎭 Player-Friendly

• 🌈 Color-Coded Messages — Clear, beautiful feedback
• 📱 Modern GUI — Sleek interface for managing nested storage
• 🚀 No Client Mods Required — Works with vanilla Java and Bedrock (Geyser) clients
• 📚 Easy to Use — Simple right-click to open, intuitive navigation

🎮 How It Works

1. Right-click a shulker box in your inventory
2. Right-click shulker boxes inside to open them (nested view)
3. Navigate easily between layers with the GUI
4. Store up to the configured limit of nested shulkers
5. Enjoy organized, portable mega-storage!

📋 Commands

🔐 Permissions

Player Permissions

• nestedshulkers.use — Use nested shulkers (default: true)

Admin Permissions

• nestedshulkers.admin — Access settings GUI (default: op)
• nestedshulkers.reload — Reload config (default: op)
• nestedshulkers.give — Give shulkers (default: op)
• nestedshulkers.blocklist.manage — Add/remove items from the blocklist via GUI (default: op)

Bypass Permissions

• nestedshulkers.bypass.cooldown — Skip cooldown timer
• nestedshulkers.bypass.layers — Exceed layer limits
• nestedshulkers.bypass.shulkers — Exceed shulker limits
• nestedshulkers.bypass.blocklist — Store blocked items

⚙️ Configuration Preview

settings:
  max-layers: 3                    # How deep can nesting go?
  max-shulkers-per-shulker: 9      # Shulkers inside one shulker
  max-items-per-shulker: 27        # Total items per shulker
  cooldown-seconds: 1              # Prevent spam
  anti-dupe-enabled: true          # Duplication protection
  debug-mode: false                # Debug logging

blocked-items:                     # Items blocked from nested shulkers
  - BEDROCK
  - BARRIER
  - COMMAND_BLOCK
  - STRUCTURE_BLOCK
  - BUNDLE

🗂️ In-Game Blocked Items Manager

No more editing config.yml to manage your blocklist! Open /ns settings, click the Blocked Items button and you get a full visual manager:

• 🟥 Every blocked item is shown as its actual in-game block — easy to see at a glance
• ➕ Add an item — hold any item in your main hand and click an empty slot
• ➖ Remove an item — simply click any blocked item in the GUI
• 📄 Paginated — supports any number of blocked items across multiple pages
• 💾 Saves to config.yml instantly, no restart needed

Requires the nestedshulkers.blocklist.manage permission.

🎯 Use Cases

Perfect For:

• 📦 Survival Servers — Give players amazing storage options
• 🏰 SMP Communities — Organize massive base storage systems
• ⛏️ Prison Servers — Enhanced cell storage with controlled limits
• 🎪 Event Servers — Easy item distribution and collection
• 🏪 Economy Servers — Create portable shops and storage businesses
• 🎮 Mini-game Servers — Quick inventory management for games
• 🌐 Geyser/Crossplay Servers — Full support for Bedrock players, no compromises

🚀 Why Choose Shulker In Shulker?

• ✅ Active Development — Regular updates and bug fixes
• ✅ Geyser Compatible — Java and Bedrock players on the same server, no issues
• ✅ Performance Optimized — Minimal impact on server TPS
• ✅ Anti-Dupe Protected — Secure against exploitation
• ✅ Highly Configurable — Adapt to any server type
• ✅ In-Game Blocklist Manager — No config editing required for day-to-day admin
• ✅ Easy to Use — Both for players and admins
• ✅ No Dependencies — Works standalone
• ✅ Modern Code — Built for the latest Minecraft versions

📦 Installation

1. Download the latest NestedShulkers-X.X.X.jar
2. Place it in your server's plugins folder
3. Restart your server
4. Configure config.yml to your liking (optional)
5. Enjoy! The plugin is ready to use

🔧 Requirements

• Server Software: Spigot, Paper, Purpur (or any fork) — Geyser supported
• Minecraft Version: 1.21+
• Java Version: Java 21+
• Dependencies: None!

📊 Default Limits

All limits are fully configurable!

🎨 Example Nesting Structure

Shulker Box (Main)
├── Shulker Box (Layer 1)
│   ├── Shulker Box (Layer 2)
│   │   └── Items (Layer 3)
│   └── Items
├── Shulker Box (Layer 1)
│   └── Items
└── Regular Items

💬 Support & Contact

• Questions? Check the wiki for detailed guides
• Found a bug? Report it with full details
• Have a suggestion? We'd love to hear it!

🌟 Show Your Support

If you enjoy using Shulker In Shulker, please:

• 💬 Share with other server owners
• 🐛 Report any bugs you find
• 💡 Suggest new features

📅 Version Information

❓ Frequently Asked Questions

Q: Does this cause lag? A: No! The plugin is optimized for performance with configurable cooldowns to prevent spam.

Q: Can items be duplicated? A: The plugin includes anti-dupe protection enabled by default. Extensive safeguards are built in at every layer of nesting.

Q: Does it work with Geyser / Bedrock players? A: Yes! Shulker In Shulker is fully compatible with Geyser. Bedrock players can open and use nested shulkers just like Java players.

Q: Does it work with other plugins? A: Yes! Compatible with most major plugins.

Q: Can I limit nesting depth? A: Absolutely! Configure max-layers in config.yml, or adjust it live in the /ns settings GUI.

Q: How do I manage the blocked items list? A: You can edit config.yml directly, or use the built-in Blocked Items GUI accessible from /ns settings. Hold the item you want to block and click any empty slot to add it — click an existing blocked item to remove it.

Q: Is it safe for production servers? A: Yes! The plugin includes extensive safeguards, proper save propagation across all nesting layers, and has been thoroughly tested.

Made with ❤️ by david — Thank you for choosing Shulker In Shulker!

🔥 Transform your server's storage system today!