ShulkerKing v2.0.1

ShulkerKing is a modern plugin for Minecraft servers (Paper/Spigot/Bukkit/Purpur 1.16.2–1.21+) that allows players to open shulker boxes directly from their hand with a simple right-click.
It comes with a multi-layered anti-duplication system and many quality-of-life features for both survival and competitive servers.

✨ Key Features

• Open from hand — Right-click with a shulker in the main or off-hand.
• Anti-duplication — 6 levels of protection against exploits and glitches.
• PvP blocking — Optionally prevent opening during combat.
• Both hands support — Configurable main/off-hand handling.
• Cooldown system — Customizable delays with permission support.
• HEX colors — Supports modern and legacy color codes.
• Sound effects — Opening, closing, cooldown, and blocking.
• Blacklists — Restrict usage in certain worlds or with specific items.
• Multi-language support — English, Russian, German, French, Spanish.
• Visual cooldown — Shows countdown directly on the item.
• Quick placement — Shift+Right-Click to place shulkers on the ground.

️ Duplication Protection
The plugin prevents exploits with six protection layers:

1. UUID session validation
2. Item verification in hand
3. Instant saving after actions
4. Auto-close on death/logout/switch
5. Nesting protection (no shulkers inside shulkers)
6. Integrity check on every action

Commands & Permissions
Commands

• /shulkerking or /sk — Main command
• /sk reload — Reload config
• /sk debug — Toggle debug mode

Permissions

• shulkerking.use — Use the plugin
• shulkerking.mainhand — Use main hand
• shulkerking.offhand — Use off-hand
• shulkerking.place — Place shulkers on ground
• shulkerking.bypass.* — Bypass cooldown, PvP, world/item restrictions
• shulkerking.reload — Reload configuration

⚙️ Configuration Highlights

• Toggle main/off-hand use and shift-placement.
• Adjustable cooldowns with real-time visual display.
• Custom sounds for open/close/place/cooldown.
• Blacklist specific worlds (e.g. Nether, End) and items.
• Automatic language detection.

Installation

1. Download ShulkerKing-2.0.1.jar
2. Place it into the plugins/ folder
3. Restart your server
4. Edit plugins/ShulkerKing/config.yml as needed
5. Assign permissions with your permission manager

Compatibility

• Minecraft: 1.16.2 – 1.21+
• Servers: Bukkit, Spigot, Paper, Purpur, Tuinity, Airplane
• Java: 8+