SinceDungeon

🛡️ SinceDungeon - The Ultimate Instanced Dungeon System

SinceDungeon is a high-performance, premium-grade instanced dungeon plugin designed natively for modern Minecraft servers (Paper 1.21+). It empowers server owners to create seamless, isolated adventure experiences with zero-trust security, advanced RPG mechanics, and professional-tier optimization.

Unlike traditional dungeon plugins, SinceDungeon is built for stability, absolute customizability, and extreme replayability. From dynamic rogue-like generation and PAPI-conditional command executions to a fully interactive In-Game GUI Editor—SinceDungeon is the only framework you need to build epic mob arenas, intricate storylines, or competitive speedrun challenges.

✨ Key Features

🌌 Professional Instancing & Zero-Trust Security

• Isolated Async Worlds: Every dungeon run is a fresh clone of your template, generated on a separate thread to ensure zero TPS drops, then automatically deleted after completion to keep your server clean.
• Deep-Clone Inventory Protection: Players' inventories, armor, and EXP are securely deep-cloned into RAM upon entry, then completely wiped. This guarantees no one can smuggle OP items into the dungeon or bring dungeon-exclusive quest items out.
• Exploit Prevention: Natively blocks teleportation (Ender Pearls, Chorus Fruit), item dropping, and unauthorized command usage while inside an instance.

⚡ Conditional Lifecycle Automation (NEW)

Automate your dungeon's flow without messy Command Blocks. Execute console commands automatically at specific lifecycle triggers:

• On-Start / On-Finish / On-Stage-Complete: Trigger commands dynamically as players progress.
• First-Time Clear Hook: Define commands that strictly execute only when a player beats a dungeon for the very first time (Perfect for granting exclusive Titles, Milestone Ranks, or unique Lore items).
• PAPI Conditional Logic: Format your commands as [condition] command_here. The plugin evaluates PlaceholderAPI logic before running it! Example: [%vault_eco_balance%;>=;500] eco give %player% 100

⏱️ Persistent Cooldowns & Gacha Tickets (NEW)

• Per-Player, Per-Map Cooldowns: Prevent endless grinding by forcing players to wait a configurable amount of time before re-entering a cleared map.
• Interactive Cooldown Tickets: Monetize your server or reward active players with NBT-protected Gacha items:
  • Cooldown Reset Ticket: Instantly wipes ALL active dungeon cooldowns.
  • Time Skip Ticket: Reduces all active cooldowns by a specific amount of time.
• PlaceholderAPI Tracking: Display remaining cooldown times live on scoreboards via %sincedungeon_cooldown_<map>%.

🛠️ Revolutionary In-Game Editor

• No YAML Hassle: Create stages, spawn waves, set conditions, and configure rewards entirely through a beautiful, paginated In-Game GUI.
• Dynamic Actions:
  • Spawn Waves & Mythic Bosses: Vanilla or MythicMobs integration (Supports scaling with party size and mixed random mob pools!).
  • Control The Zone: Hold a specific area as the radius shrinks over time, fighting off interference mobs.
  • Unlock Door & Find Key: Give players a tracking compass to hunt down a physical key and unlock a sealed path.
  • Breakable Barriers: Magical walls that crumble asynchronously when a trigger block is destroyed.
  • Loot Chests: Reward players mid-run with randomized loot.

🎲 Rogue-like Progression & High Stakes

• Randomize Stages: Shuffle the middle stages of your dungeon on every run to make speedrunning dynamic and unpredictable.
• Percent Chance Stages: Create rare, hidden treasure rooms or traps that only spawn a certain percentage of the time.
• Action Time Limits: Add high-stakes pressure by forcing players to complete objectives within a strict time limit, or face heavy life penalties.

❤️ Lives & Immortality System

• RPG Mechanics: Limit how many times players can enter a dungeon. Players lose lives when dying or failing action time-limits.
• Passive Regeneration: Lives regenerate over time based on custom or global intervals, even when offline.
• Soul Crystals: Distribute special consumable items that restore lives, complete with modern 1.21+ item components, sounds, and particles.

🏆 Interactive Leaderboards & Statistics

• Fully Automated Tracking: Natively tracks Fastest Clears, Most Kills, and Most Clears for every single dungeon.
• In-Game GUI (/dungeon top): Players can view rankings through an interactive, paginated GUI. Admins can wipe specific maps using /sd top reset <map>.
• Optimized Database: Powered by HikariCP, supporting both SQLite (Local) and MySQL (Network).

👥 Advanced Party & Dynamic Commands

• Conflict-Free Dynamic Commands: Core commands (/party, /dungeon, /sincedungeon) are no longer hardcoded! Fully rename them or assign custom aliases in config.yml to prevent conflicts with plugins like MMOCore.
• Smart Entry Checks: Automatically verifies every member for level, money, lives, and proximity before pulling the party in.
• Cross-Server (Experimental): Built-in Redis and BungeeCord/Velocity support to route players from a Lobby server to dedicated Dungeon Node servers.

🎁 Gacha Reward System

• Time-Based Tiers: Reward faster completions with more loot chests.
• Randomized Pool: Support for Vanilla items, MMOItems, and Console Commands.
• Instanced Looting & Auto-Claim: Each player gets their own personal reward GUI. If they disconnect or their inventory is full, rewards are auto-claimed and dropped safely at their feet.

🚀 Compatibility

• Paper/Purpur: 1.21 & 1.21.x (Native support) / 1.20.x (Legacy NMS fallback)
• MythicMobs: Create epic boss fights.
• MMOItems: Reward players with custom tier equipment.
• PlaceholderAPI: Custom entry conditions, lifecycle command logic, and stat tracking.
• Vault: Economy-based entry fees.
• MySQL & Redis: For large networks and cross-server setups.

📖 Useful Links

• 📚 Documentation (Wiki): Explore the Wiki
• 💬 Support & Community: Join our Discord
• 🎮 Showcase: Watch on YouTube

📄 Permissions

• SinceDungeon.admin - Access to the editor, reload, spectate, cooldown resets, and all admin commands.
• Player commands (/party, /dungeon join, /dungeon top, /dungeon lives) are enabled for everyone by default.