ShulkerOpener v1.0

ShulkerOpener
Secure • Async • Multi-Language Shulker Box Opener

ShulkerOpener is a fully secure, high-performance, and highly configurable Paper/Purpur plugin that allows players to open shulker boxes directly from their inventory with a right-click.
It preserves vanilla behavior while providing advanced protection against exploits and item duplication.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Right-Click Shulker Opening
Players can open shulker boxes directly from their inventory without placing them on the ground.

Asynchronous (Async) Processing System
Shulker read/write operations run asynchronously, protecting TPS and the main thread.

Exploit & Dupe Protection
While a shulker is open, the following actions are automatically blocked:
• Item dropping
• Block placing
• Teleporting
• World changing
• Hopper transfer

Session-UID Security System
Each opened shulker is marked with a temporary UID.
Even if the item is moved, the correct shulker is updated.
Fake or duplicated item exploits are completely prevented.

Read-Only Mode
Players without permission can only view the shulker contents, not modify them.

Blocked Materials System
Items defined in the config can never be placed inside shulker boxes.
(e.g. BEDROCK, COMMAND_BLOCK, TNT)

Stacked Shulker Prevention
Stacked shulker boxes are automatically blocked from being opened.

Rate-Limit & Anti-Spam
Millisecond-based protection against spam clicking, preventing exploit attempts.

Advanced Cache System
Shulkers with identical contents are cached for improved performance.

Multi-Language Support
All messages are managed via language.yml.
Supports MiniMessage and & color codes.

Sound & UI Support
Open / close / error sounds are fully customizable.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🛡 WHY SHULKEROPENER?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Fully secure session system, unlike classic shulker-opening plugins
• Stable even with high player counts thanks to async architecture
• Extensive edge-case protection against item loss, dupes, and exploits
• Designed with server security in mind, not just “opening shulkers”
• Thread-safe and scalable for large servers
• Built with strict edge-case handling to eliminate item loss, duplication, and desync risks


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFIGURATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

• Open rate-limit duration
• Cache duration & size
• Maximum concurrent operations
• Disabled worlds
• Blocked item list
• Sound effects
• All messages & titles

Everything is configurable via config and language files.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS & PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands:
/shulkeropener reload
Reloads config and language files.

Permissions:
shulkeropener.use – Open shulkers
shulkeropener.edit – Edit contents
shulkeropener.admin – Reload
shulkeropener.* – All permissions