TownCases

What is TownCases?
TownCases is a next-generation, high-performance Mystery Crate and Case opening engine created for modern Minecraft servers. Say goodbye to complicated text configurations and boring static reward boxes!

With TownCases, server administrators can **create, customize, and deploy physical in-world mystery cases completely in-game through an intuitive GUI editor**. Choose from **20 stunning particle auras**, **15 cinematic unboxing animations** (including CS:GO Roulette, Slot Machine, Meteor Strike, and Interactive Mystery Box Picking), and configure customizable rewards with exact percentage drop rates.


✨ Key Features at a Glance

In-Game Case Creation & Block Search

• Full In-Game Visual GUI Editor: Create and edit cases directly in-game without touching YAML files.
• Custom Block Customization: Any Minecraft block can be transformed into a Mystery Case (Chests, Ender Chests, Beacons, Dragon Eggs, etc.) with real-time sign search!
• Physical In-World Deployment: Place case blocks anywhere in the world — safe from griefing and explosions.

✨ 20 Radiant Ambient Particle Auras
Every placed case projects client-friendly particle rings to attract player attention:

• Flame Ring, Portal Vortex, Enchant Runes, Soul Fire, Dragon Breath, Redstone Dust, Totem Sparks, Heart Glow, Cloud Halo, Lava Drip, Lightning Strike, Snow Blizzard, Emerald Sparkle, Sculk Sonic Boom, Cherry Blossom, Water Splash, Nautilus Shell, Firework Burst, Witch Magic, Cosmic Galaxy Orbit.

15 Cinematic Unboxing Opening Animations
Deliver genuine unboxing thrills with diverse animation styles:

• CS:GO Roulette: Classic horizontal rolling reel with authentic ticking sound and deceleration.
• Spiral Reveal: Inward cycling particle spiral zeroing in on the winning prize.
• Explosive Burst: TNT countdown detonating into the selected reward.
• Shuffle Mystery: Three mystery cards rapidly swapping in a high-speed shell game.
• Rainbow Beacon: Vibrant multicolor beacon beam spectrum cycling.
• ☄️ Meteor Drop: Blazing meteor crashing down from the sky onto the prize slot.
• Slot Machine: 3-column classic casino jackpot spinning reels.
• ️ Vortex Black Hole: Perimeter particle vortex condensing into the winning item.
• Radar Scanner: High-tech radar scanner beam sweeping across the grid.
• Lightning Forge: Thunder strikes with hammer hits forging the winning gear.
• Pyramid Ascent: Step-by-step upward climb illuminating to the pyramid peak.
• Mystery Boxes: 5 interactive present boxes allowing players to click and pick their own destiny!
• ⚔️ Twin Duel: Two competing sides clashing until only one victor item remains.
• Chaos Matrix: Digital green binary matrix glitching into the final prize.
• ☀️ Holy Ascension: Heavenly radiant beam ascending the winning item from the depths.

Anti-Placement Keys & Safe Interaction

• Left-Click Inspection: Players can left-click any placed case to open a sleek GUI showing all potential rewards, enchantments, and exact drop percentages.
• Physical Key System: Customized tripwire hooks locked with NBT lore. Keys cannot be placed accidentally as blocks on the ground.
• Anti-Theft Knockback: Trying to open a case without the required key safely knocks the player back with an alert sound.

⌨️ Commands & Permissions

Admin & Player Commands:

• /case or /cases - Open the Master Case Manager GUI (towncases.admin)
• /case <caseId> - Receive the physical placeable Case Block (towncases.admin)
• /case key <caseId> [amount] [player] - Give case keys to yourself or other players (towncases.admin)
• /case delete - Toggle delete mode to safely break placed case blocks (towncases.admin)

Permissions:

• towncases.admin - Grants full access to case creation, key generation, and management GUIs.
• towncases.open - Allows players to use keys to unlock cases (<Default: Everyone>)
• towncases.preview - Allows players to left-click to preview case rewards (<Default: Everyone>)

Installation & Setup

• 1. Download TownCases.jar.
• 2. Place the file into your server's /plugins/ folder.
• 3. Restart your server (Compatible with Spigot, Paper, Purpur 1.20+).
• 4. Run /cases in-game to create your first custom case and place it anywhere!