⚡ Installation

Getting TrialChamberPro up and running is easier than finding diamonds at Y=11. Let's do this!

📋 Prerequisites

Before you start, make sure you have:

• Paper 1.21.x (or forks like Purpur, Pufferfish, Folia)

• Java 21 or newer

• WorldEdit (optional but highly recommended for chamber creation)

Why Paper? TrialChamberPro uses Paper-specific APIs for better performance and features. Spigot and CraftBukkit won't work!

📦 Download

Grab the latest version from one of these sources:

• GitHub Releases (recommended)

• Modrinth (under review)

• SpigotMC

Look for the file named something like TrialChamberPro-1.0.0.jar.

🚀 Installation Steps

1. Stop Your Server

Yeah, yeah, you know the drill. Shut it down properly with /stop.

2. Drop the JAR

Move TrialChamberPro-1.0.0.jar into your server's plugins/ folder.

your-server/
├── plugins/
│   ├── TrialChamberPro-1.0.0.jar  ← Put it here!
│   ├── WorldEdit.jar
│   └── ... other plugins
└── ...

3. Start Your Server

Fire it back up! Watch the console for this beautiful message:

[TrialChamberPro] Enabling TrialChamberPro v1.0.0
[TrialChamberPro] Database connected successfully
[TrialChamberPro] Loaded 2 loot tables
[TrialChamberPro] TrialChamberPro enabled successfully!

Seeing errors? Check the Troubleshooting page!

4. Check the Config Files

The plugin creates several files in plugins/TrialChamberPro/:

plugins/TrialChamberPro/
├── config.yml      # Main configuration
├── loot.yml        # Loot table definitions
├── messages.yml    # Customizable messages
├── data.db         # SQLite database
└── snapshots/      # Block snapshots (created later)

Don't touch anything yet! We'll configure everything in the next section.

🔌 Optional Dependencies

TrialChamberPro works great on its own, but these plugins add extra functionality:

WorldEdit / FAWE

Purpose: Makes chamber creation 10x easier Required? No, but seriously get it Download: WorldEdit

With WorldEdit, you can select chamber boundaries with your wand instead of typing coordinates. Life-changing stuff.

Vault

Purpose: Economy integration for loot rewards Required? Only if you want to give coins/money as loot Download: Vault

Lets you give players money when they open vaults. Works with every economy plugin ever made.

PlaceholderAPI

Purpose: Show stats in chat, scoreboards, etc. Required? Only if you want player stat placeholders Download: PlaceholderAPI

Display things like "Chambers Completed: 5" in your custom UIs.

WorldGuard

Purpose: Enhanced region protection Required? No, built-in protection works fine Download: WorldGuard

If you already use WorldGuard, TrialChamberPro can integrate with it for protection.

🎮 Verify Installation

Run this command in-game:

/tcp help

You should see a list of commands. If you do, congrats! You're ready to create your first chamber.

🔄 Updating

Updating is just as easy:

1. Stop your server

2. Replace the old JAR with the new one

3. Start your server

4. Check console for "Successfully updated database to version X"

Always backup first! Before updating, copy your plugins/TrialChamberPro/ folder somewhere safe. Better safe than sorry when dealing with player data.

❓ What's Next?

Now that you're installed, let's create your first managed chamber!

---

💡 Quick Tips

Folia Support: TrialChamberPro works on Folia out of the box! Just make sure use-folialib: true in config.yml.

MySQL Support: By default, the plugin uses SQLite (easy mode). For networks with multiple servers, you can switch to MySQL in config.yml.

Java Version: Java 21 is required. If you're on Java 17 or older, the plugin won't even load. Time to upgrade!