TSLzone

# TSLzone – Regional Damage Plugin

TSLzone is a zone damage plug-in designed for Folia 1.21+ servers, allowing server administrators to create designated areas to continuously damage entities within the area according to the set damage value and frequency.

## ✨ Features

– 🎯 **Precise area control** – Accurately define damage areas through point selection system
– ⚡ **Folia compatible** – Optimized for Folia 1.21+ server side, supporting multi-threaded architecture
– 🔧 **Flexible configuration** – Customizable damage value and damage frequency
– 💾 **Data persistence** – All regional configurations are automatically saved, and the server will be automatically restored after restarting
– 🛡️ **Security Limit** – Area size limits prevent server performance issues
– 🎨 **Message Customization** – A fully customizable message system
– 🔄 **Hot reload** – Supports configuration file hot reload without restarting the server

## 🚀 Quick start

### Installation steps

1. download`TSLzone-1.0.jar`Plugin Files
2. Put the plugin file into the server`plugins`Folders
3. Restart the server or use`plugman`Loading plugins
4. The plugin will automatically generate configuration files

### Basic usage process

1. **Set the point selection** – Use`/tzone pos1`and`/tzone pos2`Set two diagonal points of the area
2. **Create a zone** – Use`/tzone create `Create a region
3. **Startup area** – Use`/tzone start `Begins to cause harm to entities in the area
4. **Manage Zones** – Use various commands to manage created zones

## 📋 Command details

### Basic commands
– **Main Command**:`/tslzone`or`/tzone`
– **Permissions**:`tslzone.use`(Basic use) /`tslzone.admin`(Management function)

### Select a command
“`
/tzone pos1 # Set the first point in the selection (current player position)
/tzone pos2 # Set the second point in the selection (current player position)
“`

### Regional Management Commands
“`
/tzone create # Create a new area
/tzone start # Start damage to the specified area
/tzone stop # Stop damage in the specified area
/tzone remove # Delete the specified region
/tzone list # List all regions and their status
“`

### System Commands
“`
/tzone reload # Reload all configuration files
/tzone help # Show help information
“`

## 🎮 Example of usage

### Create a damage area

1. First move to a corner of the area and execute:
“`
/tzone pos1
“`

2. Move to the diagonal position of the area and perform:
“`
/tzone pos2
“`

3. Create a zone (named “danger_zone”, causing 2 damage every time, execution every 5 seconds):
“`
/tzone create danger_zone 2 5
“`

4. Startup area:
“`
/tzone start danger_zone
“`

Now, any creature entering the area will take 2 damage every 5 seconds!

### Manage existing areas

– View all areas:
“`
/tzone list
“`

– Temporarily stop an area:
“`
/tzone stop danger_zone
“`

– Restart the area:
“`
/tzone start danger_zone
“`

– Completely delete the area:
“`
/tzone remove danger_zone
“`

## ⚙️ Configuration file

### data.yml
The area data is automatically saved in`plugins/TSLzone/data.yml`Includes:
– Regional coordinate information
– Damage settings
– Frequency settings
– Activation status

Sample configuration:
“`yaml
zones:
danger_zone:
pos1:
world: world
x: 100.0
Y: 64.0
from: 200.0
pos2:
world: world
x: 150.0
and: 80.0
from: 250.0
damage: 2.0
frequency: 5
active: true
“`

### messages.yml
Customize all plugin messages, support color code:
“`yaml
# Color codes: &0-&9, &a-&f, &l(bold), &o(italics), &n(underline), &m(strike line), &k(obfuscation), &r(reset)
zone:
create:
success: “&a created the region successfully &e’%s’ &a!”
success-info: “&e damage: &7%s &e| Frequency: &7%s seconds”
“`

## 🔒 Permission system

| Permission Node | Description | Default |
|———|——|——|
| `tslzone.use`| Basic usage permissions (pos1, pos2, list) | OP |
| `tslzone.admin`| Administrator permissions (create, start, stop, remove, reload) | OP |

### Permission Configuration Example (LuckPerms)
“`
# Give players basic permissions
/lp user permission set tslzone.use true

# Give the administrator full permissions
/lp user permission set tslzone.admin true
“`

## 🛡️ Safety and Restrictions

### Area size limit
– **Maximum area**: 500×500×500 blocks
– **Purpose**: Prevent excessively large areas from affecting server performance
– **Check timing**: Automatically check when zone creation

### Performance optimization
– Use Folia’s zone scheduler to ensure thread safety
– Intelligent entity detection, only deal with organisms in the area
– Exception handling mechanism to prevent plug-in from crashing

## 🔧 Troubleshooting

### Frequently Asked Questions

**Q: Failed to create the area, prompting “the area is too big”**
A: Make sure that the selected area does not exceed 500×500×500 blocks. Available`/tzone list`Check the area size.

**Q: No harm is caused in the area**
A: Check whether the area is started (`/tzone list`Check the status), ensure there are biological entities in the area.

**Q: The area disappears after the server restart**
A: Check`plugins/TSLzone/data.yml`Whether the file exists and is readable and writeable.

**Q: The command has no permissions**
A: Make sure to have it`tslzone.use`or`tslzone.admin`Permissions.

### Debugging information
Enable debug mode to view detailed logs:
1. View server console output
2. Check if the plugin is loading correctly
3. use`/tzone reload`Reload configuration

## 📝 Update log

### V1.0.0
– ✨ Initial Version Release
– ✅ Complete regional management system
– ✅ Folia 1.21+ is fully compatible
– ✅ Customizable message system
– ✅ Data persistence support

## 🤝 Support and feedback

If you have problems or suggestions for improvement during use, please:
1. Check the troubleshooting section of this document
2. Make sure you are using Folia 1.21+ server
3. Contact the plugin developer to report the problem

## 📄 License

This plug-in is subject to the MIT license and is free to use, modify and distribute.

—

**Thanks for using TSLzone! ** 🎉

*Make your server area management simpler and more efficient! *

TSLscale

# TSLscale – Minecraft body size adjustment plug-in

## Introduction

TSLscale is a body size adjustment plug-in designed for Minecraft servers, allowing players to dynamically adjust their character size. Whether you want to be smaller, cute, or taller, TSLscale can meet your personal needs!

## Functional Features

– 🎮 **Simple and easy to use** – Adjust body shape with just one command
– 🔒 **Permission Control** – Flexible permission system ensures server security
– 📝 **Smart Completion** – Support Tab key automatic completion command
– ⚡ **Effect instantly** – Body size adjustments take effect immediately without logging in again
– 🎨 **Custom configuration** – Customize body size range and all message texts
– 🔄 **Hot reload** – Supports configuration file hot reload without restarting the server

## compatibility

– **Minecraft version**: 1.21+
– **Server Type**: Spigot, Paper, Folia
– **Java Version**: Java 21+

## Installation method

1. download`TSLscale.jar`document
2. Put the file into the server`plugins`Folders
3. Restart the server or use`/reload`Order
4. The plugin will automatically generate configuration files

## Command usage

### Basic commands

“`
/TSLscale – Adjust size to specified size
/scale – Command abbreviation
“`

### Functional examples

“`bash
# Adjust size to 0.8 times (to get smaller)
/TSLscale 0.8
/tscale 0.8

# Adjust size to 1.1 times (to grow larger)
/TSLscale 1.1
/tscale 1.1

# Reset body size to default size
/TSLscale reset
/tscale reset
“`

### Administrator commands

“`bash
# Reload plugin configuration (OP only available)
/TSLscale reload
/tscale reload
“`

## Permission system

| Permission Node | Description | Default Value |
|———|——|——–|
| `tslscale.use`| All players |
| `tslscale.reload`| Allow reload plugin configuration | OP only |

### Permission configuration example

Use permission management plugins (such as LuckPerms) to configure permissions:

“`bash
# Give players permission to use
/lp user permission set tslscale.use true

# Give administrators permission to reload
/lp user permission set tslscale.reload true
“`

## Configuration File

After the plugin is run for the first time, it will be in`plugins/TSLscale/`Generate in the directory`config.yml`Configuration file:

“`yaml
# Body size adjustment range
scale_min: 0.8 # Minimum size (0.8 times)
scale_max: 1.1 # Maximum size (1.1 times)

# Message configuration
messages:
prefix: “&c[TSL Meow]&r ”
set: “%prefix%Your body size is adjusted to %scale%”
reset: “%prefix%Your body size is restored to default”
usage: “%prefix%Usage: /TSLscale ”
no-permission: “%prefix%You don’t have permission”
console-only: “%prefix%Only players can execute this command”
“`

### Configuration instructions

– **scale_min/scale_max**: Set the allowed body size adjustment range
– **messages**: Customize all plug-in messages, support color codes (&a, &c, etc.)
– **%prefix%**: Message prefix placeholder
– **%scale%**: Body size numerical placeholder

## Use scenarios

### Suitable use

– 🎭 **Roleplay Server** – Play roles of different races or ages
– 🏗️ **Building Server** – Adjust the size to enter the small space to build
– 🎪 **Entertainment Server** – Increase the fun and interactive game
– 📸 **Screenshots and photos** – Adjust your body shape to get better photo effects

### Body size suggestions

– **0.8** – Small and cute, suitable for children’s roles
– **0.9** – Slightly small in size, suitable for teenagers
– **1.0** – Default body type (for reset)
– **1.1** – Tall and large, suitable for adult roles

## Frequently Asked Questions

### Q: Why did I change after adjusting my body shape?
A: Please make sure:
1. You have`tslscale.use`Permissions
2. The input value is within the configuration range (default 0.8-1.1)
3. Server version support (requires 1.21+)

### Q: Will body size adjustment affect the balance of the game?
A: Body size adjustment is mainly visual effects, which has little impact on the game mechanism. It is recommended that administrators set the adjustment range reasonably according to the server type.

### Q: Can you adjust the body size of other players?
A: The current version only supports adjusting your own body shape. Subsequent versions may add the function of administrators to adjust other people’s body shapes.

### Q: Will the size reset after restarting the server?
A: Yes, body size adjustment will not be saved permanently, and it needs to be reset after restart.

## Technical support

If you encounter problems or have functional suggestions, please contact:

– **Author**: Zvbj
– ** Version**: 1.0-SNAPSHOT
– **Support**: TSL server

## Update log

### v1.0-SNAPSHOT
– First release
– Basic body size adjustment function
– Permission system
– Configuration file support
– Tab completion function

—

Thanks for using TSLscale! Hopefully this plugin will add more fun to your Minecraft experience! 🎮✨

TSLPing

# TSLping

A Minecraft ping query plugin that allows players to check **their own ping**, **other players’ ping**, and **server-wide ping lists**, with **average ping statistics**.

—

## 📸 Screenshots


—

## ✨ Features

– Check your own ping
– Check a specific player’s ping
– View all online players’ ping (paged list)
– Server average ping statistics
– PlaceholderAPI support

—

## ⌨ Commands

| Command | Description |
|——|————|
| `/tping` | Check your own ping |
| `/tping ` | Check a specific player’s ping |
| `/tping all [page]` | View all players’ ping list |

—

## 🔐 Permissions

| Permission | Description | Default |
|———|————|——–|
| `tslping.use` | Use ping command | Everyone |
| `tslping.all` | View all players’ ping | OP |

—

## 🧩 PlaceholderAPI Variables

| Placeholder | Description |
|———–|————|
| `%tslping_ping%` | Player’s own ping |
| `%tslping_avg%` | Server average ping |

—

## ⚙ Configuration

**File:**
plugins/TSLping/config.yml

yaml
复制代码

**Example:**
“`yml
enabled: true
entries_per_page: 10
ping_colors:
green: 100 # <100ms = green yellow: 200 # <200ms = yellow, >=200ms = red
📦 Dependencies
Paper 1.20.4+ / Folia

PlaceholderAPI (optional)

🐞 Feedback
GitHub Issues:
https://github.com/Cherry7593/TSLping/issues

QQ: 348913197

👤 Author
Zvbj

Trust Players

**TrustAll — A simple but powerful trust system for Minecraft servers.**

Add trusted players with /trust and you’ll never hurt them again — no sword hits, no arrows, no potions, no TNT, no end crystal damage.
If you try to hit a trusted player, your attack is canceled and a red warning appears:

“you are trust this player you can’t hit him!”

You can remove trust anytime with /untrust .
Perfect for friends, clans, or PvE servers where friendly fire shouldn’t happen.

✅ Supports 1.19.2 → 1.21.9
✅ Works on Paper / Spigot / Purpur / Folia
✅ Includes sound feedback & customizable messages/config
✅ Optional mutual trust mode

Trophies


**

**

**

*Reward your players with collectible trophies they can
**hold**, display, and cherish — **permanently**.*

**

**
PHYSICAL ITEMS**

Trophies are real inventory items. Players hold them, drop them, feel them. No abstract clicks — **real, tactile reward**.


**

**
FULLY CUSTOMIZABLE**

Any block, any custom head, any color. Configure every detail from the admin GUI — **no files to edit**.


**

**✦ PARTICLE AURA**

**Radiant spheres of color** burst around the player on placement. Version-gated for modern clients.


**

**
UNLOCK SYSTEM**

Gate trophies behind unlock requirements, or make them freely placeable. **Your call, per trophy**.


**

**
GUI-DRIVEN ADMIN**

**Every setting** — trophy creation, slot assignment, colors, textures — lives inside an in-game GUI.


**

**
PERMANENT**

Once a trophy is placed, it cannot be removed. **The commitment is the reward.**


**

*From server console to configured trophy in under a minute.*

**

**

Run **/trophies admin** and the central hub GUI opens. Three buttons: **Manage Trophies** (gold block), **Showcase Settings** (chest), and **View Player Showcase** (player head). Click the gold block to begin.


**

**

Click the emerald button at the bottom-right corner of the trophy list (**”+ Create New Trophy”**). A fresh trophy is instantly generated with a unique UUID and placed in the first available showcase slot. The editor opens **automatically**.


**

**

Click the name tag to rename, the crafting table to change the display block, the player head to paste a Base64 skin texture, the firework star to pick a particle color, the door to toggle placement mode, and the compass to relocate. Each opens a dedicated GUI — **no config file editing, no command memorization**.


**

**Give It to a Player**

Close the GUI and run **/trophies give **. The player receives a glowing physical item in their inventory, and the trophy auto-unlocks in their data. **One command** — no separate unlock step required.

I don’t have a friend to help me show this 🙁

**

**

**

**

**

**


**

**

**

> **/trophies**

– trophies.use

Open your personal showcase

> **/trophies admin**

– trophies.admin

Open the admin panel

> **/trophies give **

– trophies.give

Give a trophy item to a player (auto-unlocks it too)

> **/trophies unlock **

– trophies.unlock

Unlock a trophy without giving the item

> **/trophies player **

– trophies.viewothers

View another player’s showcase

> **/trophies reload**

– trophies.admin

Reload config and trophies from disk

**

> **CLIENT-SIDE PARTICLE GATING**

Particles are only sent to players on Minecraft 1.20.6+ (configurable). Older clients see nothing; **no crashes, no noise**. ViaVersion-aware when installed.

> **TWO PLACEMENT MODES**

***Unlock Required*** gates the trophy behind an admin command. ***Always Placeable*** lets any player holding the item place it freely.

> **PRODUCTION-GRADE PERSISTENCE**

Trophy definitions in **trophies.yml**, per-player data in **playerdata/.yml**, plus a cache layer to keep I/O off the main thread.

**

**

**

**

**

1. Download **Trophies.jar**.
2. Drop it into **plugins/**.
3. Restart the server
4. Run **/trophies admin** to start.

**

Bug reports, feature requests, questions — all welcome on Discord
[](https://discord.com/users/430105019828797457)

**

**

**

TrollMenu

# TrollMenu

**TrollMenu** is a polished Paper troll plugin built for staff teams that want fast in-game control, scary effects, player chaos, presets, and now a much better moderation workflow.

It already ships with freezes, fake screens, lightning, cages, inventory chaos, movement control, and preset sequences — and `1.5.0` adds the missing quality-of-life layer that makes the menu feel much more usable during live staff sessions.

## New in 1.5.0
– Added target-based troll history tracking
– Added `/trollmenu history [limit]`
– Added `/trollmenu repeat ` to replay the latest action or preset
– Added a new GUI history button with left-click audit and right-click replay
– Added last-troll summaries inside the player browser and target action screen
– Cleaned up the reconstructed source and rebuilt the plugin cleanly

## Why Servers Use It
– Large variety of visual, inventory, movement, and panic-style troll actions
– Fast player browser + action GUI built for live use by staff
– Preset sequences for instant chaos without typing commands
– Runtime-safe reset tools for reversible effects
– New audit/repeat flow that helps staff stay organized during events or investigations

## Main Commands
– `/trollmenu`
– `/trollmenu open `
– `/trollmenu preset `
– `/trollmenu reset `
– `/trollmenu history [limit]`
– `/trollmenu repeat `
– `/trollmenu unfreezeall`
– `/trollmenu settings`

## Preview

## Best Fit
– SMP staff teams
– content / event servers
– troll-heavy minigame communities
– admin utility packs that want a stylish in-game control panel

## Support The Project
If TrollMenu is useful on your server and you want more updates like this:
– [Buy Me a Coffee](https://buymeacoffee.com/perusi)

TrollMenu keeps the chaos fun, fast, and easier for staff to control.

—

## Searching for a minecraft host? Look down

[](https://billing.sparkedhost.com/aff.php?aff=3214)

Direct link:
https://billing.sparkedhost.com/aff.php?aff=3214

Trims Effect

## ========✨ TrimEffects (By GoldwarGlory) ========

– ✨ **TrimEffects is a lightweight Paper plugin.**
– ✨ **Highly configurable, lag-free, and future-safe.**
– ✨ **It gives potion effects based on worn armor trims.**
– ✨ **Effects scale with the number of trimmed armor pieces.**
– ✨ **Edit config.yml easily using in-game config editor. { “`/trimseffect edit“` }**

## ========⭐ Features of TrimsEffect ========

– ⭐ **Highly configurable via config.yml**
– ⭐ **Safe against invalid trims or effects**
– ⭐ **Multiple trims supported at the same time**
– ⭐ **Optimized for large servers (500+ players)**
– ⭐ **Potion effects based on armor trim patterns**
– ⭐ **Ability to disable crafting of specific trim templates**
– ⭐ **Reload config without restarting (/trimeffectsreload)**
– ⭐ **Smart effect scaling depending on how many armor pieces share the same trim**

## ========⚙ How to Install TrimsEffect ========

1. ✅ **Download the plugin jar**
2. ✅ **Place it in your server’s plugins/ folder**
3. ✅ **Start the server once to generate config.yml**
4. ✅ **Edit the config as you like**
5. ✅ **Run /trimeffects reload or restart the server**

## ========🚀 Performance & Safety for servers ========

– 🚀 **No NMS, no packets**
– 🚀 **Checks only 4 armor items per update**
– 🚀 **Reload-safe (effects reapply correctly)**
– 🚀 **Event-based (no repeating tasks, no ticking loops)**
– 🚀 **Safe config parsing (invalid trims/effects are ignored)**

## ========💖 Support & Join our community ========
– ❤️**Join my Discord server for updates, support, and suggestions**
– ❤️**My Modrinth Profile: https://modrinth.com/user/GoldwarGlory**
– ❤️**My Discord Server: https://discord.gg/qwXHuyJbvX**

## ========➕Extra info of TrimsEffect ========

Trigger-触发器插件

Trigger Plugin Introduction

Trigger is a highly compatible trigger plugin, primarily designed to empower server owners to implement functionalities that are otherwise difficult to achieve.
It uses a concise configuration syntax, allowing for complex conditional judgments and action responses based on almost any in-game event.
It boasts powerful version compatibility (since v1.5.0) and also maintains compatibility with many plugin cores and mod APIs.
Currently compatible with: 1.21.X, 1.20.X, 1.19.X, 1.18.X, 1.17.X, 1.16.X, 1.15.X, 1.14.X, 1.13.X, 1.12.X, 1.11.X, 1.10.X, 1.9.X, 1.8.X, 1.7.X, 1.6.X, 1.5.X, 1.4.X, 1.3.X, 1.2.X, 1.1.X, 1.0.X

✨ Core Features

1. Trigger System

Supports over 100 native events: Player movement, block breaking, entity damage, command input, world time changes… Almost any game event can serve as a trigger starting point.

Events can be attached with ANY / ALL modes for fine-grained control over trigger logic.

Triggers can be enabled/disabled and assigned priority to determine execution order.

2. Condition System

Built-in numerous condition placeholders: Player attributes, item information, entity types, world states, timer variables, etc., meeting any judgment requirement.

Supports logical combinations: Build complex conditional expressions using and, or, and parentheses.

Supports regex matching, numerical comparison, string comparison, and negation operations (! or un prefix).

3. Action System

Can execute console commands, player commands (with OP elevation support), send messages (regular, title, action bar), play sounds, display particle effects, and more.

Actions support delayed execution ({wait:seconds} syntax) for timed control.

Fallback actions (un_command) can be specified when conditions are not met.

4. Region System

Supports WorldGuard regions, and also features its own built-in region system. Regions can be dynamic or static, with real-time tracking.

Allows configuration of region-related aspects for customized regional behavior.

5. Group System

Item Groups: Define complex items with NBT, enchantments, and Lore for condition matching or command operations.

Entity Groups: Manage entity types, health, equipment, supporting UUID tracking of members.

Player Groups: Dynamically manage player collections for group permissions or event binding.

Region Groups: Dynamically manage regions, enabling real-time analysis for timely actions and condition processing.

Trigger Groups: Manage multiple triggers simultaneously for easier administration.

Group operations can dynamically add or remove members via commands or trigger actions.

6. Timers & Variables

Timers: Create count-up or countdown timers. Value changes can trigger events. Supports global/private scopes and can be persistent.

Variables: Store any data type (numbers, strings, booleans). Can be read in conditions and support persistence.

Both Timers and Variables support cross-server synchronization (requires BungeeCord configuration).

7. Custom Menus & Containers

Menus: Create custom menu content, similar to ChestCommands, but integrated with triggers for better management.

Containers: Menus can act as containers, either private or public. This solves issues with persistent player data synchronization and allows configuration of item insertion/removal permissions.

8. Custom Commands

Custom Commands: Players can learn how to configure and implement custom command features based on loaded help content. Includes custom command permission node functionality.

9. More Target Selectors

Starting from v2.0.0, 4 new target selectors have been added: @t, @d, @y, @x.

@t – The player or entity the user is looking at.

@d – The nearest entity.

@y – A random entity or mob.

@x – The position the player is looking at.

10. JavaScript Scripting Functionality

Starting from v2.1.0, other plugins can easily register custom conditions and actions for seamless integration with Trigger.

Write complex logic directly in triggers using JavaScript scripts – dynamic judgments, loops, calling server APIs – all within your grasp.

11. Pet System

Starting from v2.1.0, create and nurture exclusive pets that will follow you into battle, learn skills, wear equipment, and even evolve into new forms. Forge unique combat companions!

12. World Editing System

Starting from v2.1.0, create custom worlds like superflat or void without relying on WorldEdit. Use the golden axe to select regions for copy, paste, fill operations, and other standard world editing actions.

13. Data Statistics & Analysis System

Starting from v2.1.0, record detailed player data, from kills to chat messages. The statistics module tracks player behavior comprehensively. Use the /tg stats command to view personal or others’ detailed stats. Supports PlaceholderAPI for real-time data display in scoreboards or menus.

14. Web Management System

Starting from v2.1.0, bring your server into the browser! The web management panel allows real-time viewing of trigger, variable, and timer statuses, toggling triggers on/off, and even calling REST APIs for integration with other systems. Simple configuration, secure and reliable, allowing you to control server dynamics anytime, anywhere.

15. Dependencies

All dependencies for this plugin are optional; it basically requires no other plugins to function.

16. Other Information

From now on, we do not charge any fees. This plugin is designed to solve problems related to unimplementable features. If you encounter someone reposting it and charging a fee, please report them promptly.

Author: 红伞伞白杆杆

TridentDupeFixer

### Introduction
Fixed the TridentDupe exploit.
Compatible with all server and game versions from 1.13+.

### Related exploit link
[https://github.com/Killetx/TridentDupe/tree/main](https://github.com/Killetx/TridentDupe/tree/main)

TrialChamberPro

# TrialChamberPro

### What’s new in 1.4.4

– **Vanilla loot is now one copy-paste away.** Two ready-to-use loot tables — `vanilla-normal` and `vanilla-ominous` — ship inside `loot.yml` as a commented section. They’re faithful three-pool recreations transcribed directly from Mojang’s own datapack JSONs, so if you (or your players) just want unmodified Minecraft 1.21 Trial Chamber drops, you don’t have to build them yourself. Uncomment the block, run `/tcp reload`, done.

Plus everything from the 1.4.x line: **MiniMessage everywhere**, **smarter auto-discovery** that merges chambers spanning multiple chunks, a **flatter admin GUI**, a **startup schema check** for `messages.yml`, **trial spawner wave tracking fixes**, and the **chamber pause state** added in 1.4.3. And from 1.3.x: **custom mobs** (MythicMobs, EliteMobs, EcoMobs, LevelledMobs, InfernalMobs, Citizens), **fully translatable GUI** (~330 `gui.*` keys), **Bukkit events API**, **spawner presets**, **`/tcp give`**, and **Minecraft 26.x support** via the `-mc26` build.

📘 **Full documentation:** https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation — most questions are answered there, and every section below links to its own detailed page.

—

## 🎁 Win a Premium Module Licence

Capture your best TrialChamberPro setup — a screenshot or short clip — and post it in **#showcase** on our Discord. The community votes via reactions, and the **3 most-loved entries each win a permanent premium licence** (TCP-WildSpawners or TCP-VaultCrates, your pick). Surprise bonuses for runners-up.

👉 **[Join the Discord →](https://discord.gg/qwYcTpHsNC)**

—

## Premium Add-on Modules

TrialChamberPro is, and always will be, **completely free**. But after a lot of requests from server owners wanting to push things further, we now offer optional premium modules for servers that need more.

### 🔷 TCP-WildSpawners
Place TCP preset spawners **anywhere on your survival map** — no Trial Chamber required. Hand them out via shops, crates, or staff commands. Wherever a player puts one down, it summons your custom mobs. Includes an in-game GUI editor, per-preset griefing protection, holograms, mob tether, creative pick-block, and state-preserving mining so players can relocate a live spawner without losing cooldown progress.

Requires TrialChamberPro v1.4.0+ (free).

👉 **[esmp.fun/plugins](https://esmp.fun/plugins)** — purchase & download

### 🔶 TCP-VaultCrates
The **first crate plugin that doesn’t use chests.** Vanilla Trial Vaults are the only Minecraft block with built-in per-player loot state, two visual tiers (normal + ominous), a key mechanic, and a dramatic open animation that doesn’t need a resource pack. TCP-VaultCrates lets you register vaults anywhere on your map as crates with configurable loot pools and per-tier keys. Hand keys out via shops, missions, or — when paired with TCP-WildSpawners — drop them from spawner mobs.

Requires TrialChamberPro v1.4.0+ (free).

👉 **[esmp.fun](https://esmp.fun/plugins)** — purchase & download

—

**The definitive Trial Chamber management plugin for multiplayer servers.**

Transform Minecraft’s Trial Chambers from single-use dungeons into renewable, multiplayer-ready content. Automatic resets, per-player loot, custom rewards, griefing protection — and it all works out of the box.

—

## Why TrialChamberPro?

Vanilla Trial Chambers weren’t designed for multiplayer. The first player takes everything, vaults stay locked forever, and griefers destroy spawners. **TrialChamberPro fixes all of that.**

| Problem | Solution |
|———|———-|
| First player gets all loot | Per-player vault system with individual cooldowns |
| No way to reset chambers | Automatic scheduled resets with player warnings |
| Griefers break spawners | Full protection system with optional WorldGuard support |
| Paper trial key bugs | Built-in fixes for known Paper issues |
| No progression tracking | Statistics, leaderboards, and PlaceholderAPI support |
| Setup overhead per chamber | **Auto-discovery** — chambers register themselves |

—

## Two-Line Plug-and-Play Setup

For most servers, the only thing you need to configure is this:

“`yaml
# plugins/TrialChamberPro/config.yml
discovery:
enabled: true # find natural trial chambers automatically
auto-snapshot: true # capture blocks so resets can restore them
“`

Restart once. Fly or walk through your world — every natural trial chamber registers itself as its chunks load, with per-player loot, protection, and automatic resets already active. Done.

> Why it’s opt-in: on **old** worlds that pre-date 1.21, players sometimes build decorative structures out of tuff and copper blocks. The auto-detector could register those as chambers. On fresh worlds there’s no risk. [More detail in the docs →](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/configuration/config.yml#auto-discovery-of-natural-trial-chambers)

Prefer manual control? You can still register chambers with WorldEdit (`/tcp generate wand MyChamber`) or by coordinates — see [Your First Chamber](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/getting-started/your-first-chamber).

—

## Features

### Core Systems
– **Auto-Discovery** — natural chambers register themselves on chunk load + startup sweep. [Docs →](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/configuration/config.yml#auto-discovery-of-natural-trial-chambers)
– **Automatic Resets** — chambers restore on schedule with configurable warnings, or set interval to `0` for manual-only.
– **Per-Player Vaults** — everyone gets their own loot with separate cooldowns.
– **Full Protection** — block break/place, container access, mob griefing prevention. WorldGuard-aware.
– **Statistics & Leaderboards** — vaults opened, mobs killed, time spent. [Docs →](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/guides/statistics)
– **Admin GUI** — `/tcp menu` does everything. No YAML editing required.

### Advanced Loot
– **Multi-Pool Tables** — common / rare / unique pools like vanilla, fully configurable. [Docs →](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/configuration/loot.yml)
– **Per-Chamber Overrides** — assign a different loot table to any specific chamber.
– **GUI Editing** *(new in 1.2.26)* — open `/tcp menu` → Loot Tables, click a table, and edit it. Changes save to `loot.yml` instantly.
– **Custom Plugin Items** — drop Nexo, ItemsAdder, or Oraxen items directly from vaults:
“`yaml
– type: CUSTOM_ITEM
plugin: nexo # or itemsadder / oraxen / craftengine / mythiccrucible
item-id: mythic_sword
weight: 5
“`
– **Custom Model Data** — set `custom-model-data` on any vanilla item for resource-pack integration.
– **Command Rewards** — run any console command as loot (economy deposits, permission grants, XP).
– **Potion & Tipped Arrows** — full attribute support including Bad Omen III–V ominous bottles.
– **LUCK Integration** — optional bonus rolls for players with the LUCK effect.

### Multiplayer Enhancements
– **Spawner Wave Tracking** — boss bar shows wave progress as players fight. Hysteresis-based despawn means the bar disappears when you leave the area *(improved in 1.2.26)*.
– **Spectator Mode** — dead players can watch teammates complete the challenge, bounded to the chamber.
– **PlaceholderAPI** — 20+ placeholders for scoreboards, holograms, tab lists.

### Technical Excellence
– **Folia Native** — full support for regionized multithreading.
– **Paper / Purpur / Pufferfish** — works on all major Paper forks.
– **Async Architecture** — Kotlin coroutines, zero main-thread blocking.
– **Dual Database** — SQLite (default) or MySQL with connection pooling.
– **WorldEdit / FAWE** — optional, used only if you want selection-based chamber creation.

—

## Fully Translatable

Every user-facing string lives in `plugins/TrialChamberPro/messages.yml`. Want your server in French, Chinese, Spanish, or Klingon? Edit one file, `/tcp reload`, done.

Supports `&`-style color codes, `{placeholder}` substitution, and Adventure Components for boss bars.

📘 [Full message reference →](https://darkstarworks.gitbook.io/darkstarworks-plugins/tcp-documentation/configuration/messages.yml)

—

## Quick Start (manual mode)

Prefer not to use auto-discovery? Classic workflow still works:

“`
1. Drop the JAR in your plugins folder
2. Start your server
3. Select a Trial Chamber with WorldEdit (//wand)
4. Run: /tcp generate wand MyChamber
5. Run: /tcp snapshot create MyChamber (enables auto-reset)
6. Done!
“`

—

## Commands (at a glance)

| Command | Description |
|———|————-|
| `/tcp menu` | Open the admin GUI (does everything) |
| `/tcp generate wand ` | Register chamber from WorldEdit selection |
| `/tcp reset ` | Force immediate reset |
| `/tcp snapshot create ` | Enable automatic resets |
| `/tcp loot set