DungeonInstance | Trial Chamber v1.0.1

What happens when dozens of players rush into a Trial Chamber? Latecomers will only find ruins — all the loot completely gone. With Trial Chamber Instance, that problem is solved forever.

Every player or party gets their own fresh, private chamber, their own loot, and a completely lag-free experience.

---

Main Features

---

◆ Private Instances & Smart Generation

Players find a natural Trial Chamber in the overworld and right-click a spawner. They are instantly teleported to a private, freshly generated copy of the chamber inside a safe Void world.

• No Griefing: The overworld chamber is fully protected — no block breaking, no liquids.
• Lag-Free: FastAsyncWorldEdit pastes dungeons smoothly in the background.
• Auto-Cleanup: Instances are automatically deleted when the party leaves or finishes.

---

◆ Built-in Party System

Run dungeons solo or team up with friends — the choice is yours!

• Easy Invites: Invite players via chat or the GUI.
• Party Leader: Only the leader can start the dungeon.
• Max Size: Configurable maximum party size.
• Create a party: /tbi invite {name}
• Accept an invite: /tbi accept or click the ACCEPT button in chat.

---

◆ Stunning Visuals & Animations

When a player enters an overworld Trial Chamber, the spawners transform into magical portals with glowing holograms.

---

◆ Auto-Pickup Virtual Storage

Trial Chambers drop a huge amount of loot. To keep your inventory clean, all drops go straight into a private virtual storage.

• Auto-Store: Drops picked up in the dungeon go directly to /tbi storage.
• Chat Notifications: Clean messages show exactly what you picked up.
• GUI Management: Easily take items out or clear storage with one click.

---

◆ Victory System

The plugin tracks exactly how many spawners your party has defeated.

• Epic Victory: When all spawners are cleared, fireworks explode and a Victory Title lights up the screen!
• Find Missing Loot: Unopened Vaults glow with a Red Outline through walls so you never miss a reward.
• Grace Period: Players get a configurable timer (e.g. 15 mins) to open vaults before the dungeon closes.
• All Trial Spawners turn into beacons after victory — right-click one to leave.

---

◆ Spectator Mode & Death Handling

What happens when a player dies?

• Keep Inventory: Configurable option — players keep their items on death inside the dungeon.
• Spectator Mode: Dead players or late joiners become invisible Spectators. They can fly freely and watch the fight, but cannot hit mobs or open vaults. (Party only)

---

◆ Admin Tools & Crash Protection

Built for large networks to run perfectly without admin intervention.

• Admin Panel: Use /tbi admin to view a live GUI of all active dungeons and players.
• Crash Protection: If the server restarts, all players and instances are saved. Players rejoin and land right back in their dungeon.
• Cooldowns: Prevent farming by setting a cooldown (e.g. 24 hours) per unique chamber structure.

---

Commands & Permissions

---

Player Commands


/tbi — Open the main menu (while inside an overworld Trial Chamber)
/tbi help — Show all available commands
/tbi party — Open party settings
/tbi storage — Open your virtual loot storage
/tbi warp — Warp back into your active instance
/tbi invite <player> — Invite someone to your party
/tbi enter — Teleport to the nearest Trial Spawner
/tbi leave — Leave the dungeon
/tbi scan vault/spawner — Highlight vaults or spawners through walls

---

Admin Commands (Permission: trialchamberinstance.admin)


/tbi admin — Open the live server instance monitor
/tbi reset <player|all> — Reset player cooldowns
/tbi genstruc <amount> — Generate more Trial Chamber structures (may cause lag during generation)
/tbi reload — Reload the config.yml
/tbi createinst — Manually create an instance for a player


/tbi scan commands


Configuration

---

Requirements

• Minecraft Version: Paper 1.21 – 1.21.1
• Dependencies: FastAsyncWorldEdit (FAWE) Plugin

---

How Instance Creation Works

---

1. Void World
When the plugin loads for the first time, it creates a dedicated blank world called trial_chamber_instances. This world is completely empty — no terrain, no mobs, no weather. It only serves as a neutral space to paste dungeons into and persists across server restarts so active instances stay intact.

2. Grid Layout
The void world is divided into an invisible grid where each cell is 2000 blocks apart, arranged in rows of 100. New instances are assigned to the next free cell (e.g. 0,0 → 1,0 → 2,0 ...). When an instance is finished and wiped, its cell returns to the pool — supporting up to 100 instances per row, expanding downward indefinitely. Instances never collide.

3. Schematic Paste
Once a grid cell is reserved, the plugin randomly picks one of 100 available .schem files from its structures/ folder and pastes it using FastAsyncWorldEdit, centered at Y=64 of that cell. The paste runs on a background thread so the server never freezes.

4. Post-Paste Setup
After the structure appears, the plugin scans all blocks to:

• Find and register every Trial Spawner and Vault block.
• Reset Vault block data so fresh loot tables are applied correctly (normal and ominous vaults handled separately).
• Reset Trial Spawner data and increase player detection range from vanilla's 14 blocks to 40 blocks.
• Find a safe two-block-high air gap to use as the spawn point for players.

5. Teleportation
All party members are teleported to the spawn point simultaneously. Their overworld location is saved so they can be returned there when the instance ends.

6. Cleanup
When the instance ends (all vaults opened, grace timer expired, or all players left), the plugin:

1. Teleports all remaining players back to their overworld locations.
2. Wipes all blocks in the grid cell (overwrites with air).
3. Frees the grid cell back to the pool for future use.
4. Removes all session data from memory.

---