NestedShulkers — Changelog

---

v1.1.0

Bug fixes, GUI overhaul, and new Blocked Items manager

🐛 Bug Fixes

• Layer limit ignored — The max-layers setting was completely ignored at runtime because the code was accidentally reading max-shulkers-per-shulker (default: 9) instead of max-layers. The configured layer limit now works correctly.
• Items disappearing after layer 2 — When closing a nested shulker, contents were only saved into the immediate (innermost) layer and never propagated back up the parent chain. Closing layer 3 would save into layer 3's item, but layer 2 never got updated, so everything above layer 1 appeared empty on re-open. The close handler now walks the full stack from innermost to outermost, updating each parent before writing back to the player's inventory.

---

✨ New Features

• Blocked Items GUI — Accessible from the Settings GUI via the new Blocked Items button (red concrete, centered on row 4). Shows every currently blocked material as its actual in-game item. Players with the nestedshulkers.blocklist.manage permission can:

  • Add an item by holding it in their main hand and clicking any empty slot
  • Remove an item by clicking it in the GUI
  • Changes save to config.yml instantly. The list is paginated (45 items per page) with previous/next navigation.

• New permissions

  • nestedshulkers.blocklist.manage — Allows adding/removing items from the blocklist via GUI (default: op)

• New config messages

  • blocked-item-added, blocked-item-removed, blocked-item-already, blocklist-no-item

---

If you want to test if everything is working properly please deop cause op players bypass all permssions.

Shulker In Shulker - Changelog

All notable changes to this project will be documented in this file.

[1.0.0] - 2026-02-05

🎉 Initial Release

The first public release of Shulker In Shulker!

✨ Features Added

Core Functionality

• ✅ Nested shulker box system - store shulkers inside shulkers
• ✅ Configurable nesting depth (max layers)
• ✅ Configurable shulker-per-shulker limits
• ✅ Configurable item capacity per shulker
• ✅ Interactive GUI for opening nested shulkers
• ✅ Intuitive navigation between nested layers

Administrative Features

• ✅ In-game settings GUI for admins (/ns settings)
• ✅ Real-time configuration modification
• ✅ Config reload command (/ns reload)
• ✅ Give command to distribute shulkers (/ns give <player>)
• ✅ Comprehensive admin GUI with visual settings management

Security & Performance

• ✅ Anti-duplication system to prevent item dupes
• ✅ Cooldown system to prevent spam and reduce lag
• ✅ Item blacklist system for blocking specific items
• ✅ Permission-based access control
• ✅ Bypass permissions for trusted players

Permission System

• ✅ nestedshulkers.use - Basic usage permission
• ✅ nestedshulkers.admin - Admin GUI access
• ✅ nestedshulkers.reload - Config reload permission
• ✅ nestedshulkers.give - Give shulkers to players
• ✅ nestedshulkers.bypass.cooldown - Bypass cooldown restrictions
• ✅ nestedshulkers.bypass.layers - Bypass layer limits
• ✅ nestedshulkers.bypass.shulkers - Bypass shulker count limits
• ✅ nestedshulkers.bypass.blocklist - Bypass blocked items

Configuration

• ✅ Fully customizable config.yml
• ✅ Adjustable layer depth (default: 3)
• ✅ Adjustable shulker limits (default: 9 per shulker)
• ✅ Adjustable item limits (default: 27 per shulker)
• ✅ Customizable cooldown time (default: 1 second)
• ✅ Toggleable anti-dupe system
• ✅ Debug mode for troubleshooting
• ✅ Customizable messages with color code support
• ✅ Default blocked items list (BEDROCK, BARRIER, COMMAND_BLOCK, STRUCTURE_BLOCK, BUNDLE)

Commands

• ✅ /nestedshulkers (aliases: /ns, /nshulker)
• ✅ /ns help - Display help information
• ✅ /ns settings - Open admin settings GUI
• ✅ /ns reload - Reload configuration
• ✅ /ns give <player> - Give shulker box to player

User Experience

• ✅ Color-coded messages with customizable prefix
• ✅ Informative error messages
• ✅ Player-friendly GUI interface
• ✅ Smooth navigation between shulker layers
• ✅ Visual feedback for actions

Technical Details

• ✅ Built for Minecraft API 1.21
• ✅ Efficient event handling
• ✅ Clean code structure with managers and utilities
• ✅ Listener-based architecture
• ✅ GUI management system
• ✅ Data persistence for shulker contents
• ✅ Cooldown management system

📋 Default Configuration Values

Max Layers: 3
Max Shulkers Per Shulker: 9
Max Items Per Shulker: 27
Cooldown: 1 second
Anti-Dupe: Enabled
Debug Mode: Disabled

🚫 Default Blocked Items

• BEDROCK
• BARRIER
• COMMAND_BLOCK
• STRUCTURE_BLOCK
• BUNDLE

🎯 Supported Versions

• Minecraft Version: 1.21+
• Server Software: Spigot, Paper, Purpur (and forks)

📝 Known Limitations

• Maximum nesting depth should not exceed 10 layers for performance reasons
• Very large numbers of nested shulkers may impact server performance
• Some third-party plugins may conflict with shulker interactions

🔮 Future Considerations

• Potential features for future updates based on community feedback
• Performance optimizations
• Additional customization options
• More bypass options
• Statistics tracking
• Multi-language support

---

Version History

• v1.0.0 (2026-02-10) - Initial Release

---

Upgrade Notes

New Installation

1. Download NestedShulkers-1.0.0.jar
2. Place in your server's plugins folder
3. Restart your server
4. Configure config.yml to your preferences
5. Grant permissions to players

---

Feedback & Bug Reports

Found a bug or have a suggestion? Please report it with:

• Plugin version (1.0.0)
• Server version and type
• Steps to reproduce (for bugs)
• Any error messages from console
• Description of expected behavior

---

Thank you for choosing Shulker In Shulker!

Developer: david