# Installation

## ⚡ 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)

{% hint style="info" %}
**Why Paper?** TrialChamberPro uses Paper-specific APIs for better performance and features. Spigot and CraftBukkit won't work!
{% endhint %}

### 📦 Download

Grab the latest version from one of these sources:

* [GitHub Releases](https://github.com/darkstarworks/TrialChamberPro/releases) (recommended)
* [Modrinth](https://modrinth.com/plugin/trialchamberpro)
* [SpigotMC](https://www.spigotmc.org/resources/trialchamberpro)

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!
```

{% hint style="success" %}
**Seeing errors?** Check the Troubleshooting page!
{% endhint %}

#### 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](https://dev.bukkit.org/projects/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](https://www.spigotmc.org/resources/vault.34315/)

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](https://www.spigotmc.org/resources/placeholderapi.6245/)

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

#### WorldGuard

**Purpose:** Enhanced region protection **Required?** No, built-in protection works fine **Download:** [WorldGuard](https://dev.bukkit.org/projects/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"

{% hint style="warning" %}
**Always backup first!** Before updating, copy your `plugins/TrialChamberPro/` folder somewhere safe. Better safe than sorry when dealing with player data.
{% endhint %}

### ❓ What's Next?

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

***

### 💡 Quick Tips

{% hint style="info" %}
**Folia Support:** TrialChamberPro works on Folia out of the box! Just make sure `use-folialib: true` in config.yml.
{% endhint %}

{% hint style="info" %}
**MySQL Support:** By default, the plugin uses SQLite (easy mode). For networks with multiple servers, you can switch to MySQL in config.yml.
{% endhint %}

{% hint style="warning" %}
**Java Version:** Java 21 is required. If you're on Java 17 or older, the plugin won't even load. Time to upgrade!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://darkstarworks.gitbook.io/plugins/mc/tcp-documentation/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.