# \u23f1 TrialTimer<\/p>\n
> Configurable Trial Spawner cooldown \u2014 because 30 minutes is way too long.<\/p>\n
\n
\n
\n<\/p>\n
—<\/p>\n
## \ud83d\udd27 What does it do?<\/p>\n
Vanilla Trial Spawners have a **hardcoded 30-minute cooldown** after a wave is completed.
\nTrialTimer lets you set that to whatever you want \u2014 down to a few seconds if needed.<\/p>\n
No client-side mods required. Works fully server-side.<\/p>\n
When a spawner finishes its cooldown, nearby players receive a **broadcast message** so they know it’s ready to fight again.<\/p>\n
—<\/p>\n
## \u2699\ufe0f How does it work?<\/p>\n
The 30-minute rule is hardcoded in Minecraft’s source code, so datapacks can’t touch it.
\nTrialTimer works around this by hooking into the spawner’s internal state via **NMS reflection**:
\nwhen a spawner enters cooldown, the plugin overwrites `cooldownEndsAt` to your configured duration.
\nMinecraft then reads that value and considers the cooldown over \u2014 simple and clean.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Drop `TrialTimer-x.x.x.jar` into your `plugins\/` folder
\n2. Restart the server
\n3. Edit `plugins\/TrialTimer\/config.yml`
\n4. Run `\/trialtimer reload`<\/p>\n
—<\/p>\n
## \ud83d\uddc2 config.yml<\/p>\n
“`yaml
\n# Cooldown duration in minutes. Supports decimals (e.g. 0.5 = 30 seconds).
\n# Vanilla default: 30 minutes
\ncooldown-minutes: 5.0<\/p>\n
# Language for plugin messages.
\n# Available: en, de
\nlanguage: en<\/p>\n
# Broadcast a message to nearby players when a Trial Spawner finishes its cooldown.
\nbroadcast:
\n enabled: true
\n radius: 64 # in blocks<\/p>\n
# Debug mode \u2014 logs every cooldown modification to the console.
\ndebug: false
\n“`<\/p>\n
### Quick reference \u2014 Minutes \u2192 Ticks<\/p>\n
| Minutes | Seconds | Ticks |
\n|———|———|——–|
\n| 0.5 | 30s | 600 |
\n| 1 | 60s | 1,200 |
\n| 5 | 300s | 6,000 |
\n| 10 | 600s | 12,000 |
\n| 30 | 1800s | 36,000 *(vanilla)* |<\/p>\n
—<\/p>\n
## \ud83d\udcac Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/trialtimer help` | Shows command overview | `trialtimer.use` |
\n| `\/trialtimer info` | Shows current cooldown | `trialtimer.use` |
\n| `\/trialtimer reload` | Reloads config + language | `trialtimer.reload` |<\/p>\n
**Alias:** `\/tt`<\/p>\n
—<\/p>\n
## \ud83d\udce2 Broadcast<\/p>\n
When a Trial Spawner finishes its cooldown, all players within the configured radius receive a message:<\/p>\n
“`
\n[TrialTimer] A Trial Spawner at 42, 63, -128 is ready to fight again!
\n“`<\/p>\n
The message is fully customizable in the language files (`lang\/messages_en.yml` \/ `lang\/messages_de.yml`).<\/p>\n
—<\/p>\n
## \ud83d\udcca PlaceholderAPI<\/p>\n
TrialTimer supports **PlaceholderAPI** (optional \u2014 works without it too).<\/p>\n
| Placeholder | Description |
\n|————-|————-|
\n| `%trialtimer_cooldown_minutes%` | Configured cooldown in minutes |
\n| `%trialtimer_cooldown_seconds%` | Configured cooldown in seconds |
\n| `%trialtimer_cooldown_ticks%` | Configured cooldown in ticks |<\/p>\n
Use these in scoreboards, holograms, or any plugin that supports PlaceholderAPI.<\/p>\n
—<\/p>\n
## \ud83c\udf0d Language Support<\/p>\n
TrialTimer ships with **English** and **German** out of the box.
\nSwitch via `language: de` in `config.yml`.<\/p>\n
Language files are saved to `plugins\/TrialTimer\/lang\/` and can be edited freely.<\/p>\n
—<\/p>\n
## \ud83d\udd0c Compatibility<\/p>\n
| Software | Supported |
\n|———-|———–|
\n| Paper 1.21.x | \u2705 |
\n| Purpur 1.21.x | \u2705 |
\n| PlaceholderAPI | \u2705 *(optional)* |
\n| Spigot | \u274c |
\n| Folia | \u274c |<\/p>\n
> **Note:** The NMS reflection targets Mojang-mapped Paper\/Purpur builds (1.21+).
\n> Enable `debug: true` if you run into issues \u2014 it logs the exact field names found at runtime.<\/p>\n
—<\/p>\n
## \ud83d\udcc4 License<\/p>\n
MIT \u2014 free to use, fork, and redistribute.<\/p>\n","protected":false},"excerpt":{"rendered":"
Reduces the Trial Spawner cooldown from the vanilla 30 minutes to a configurable duration \u2014 fully server-side, no client mods required.<\/p>\n","protected":false},"featured_media":159019,"template":"","meta":{"_minecraft_slug":"trail-timer","_minecraft_project_id":"LcrKhpH1","_minecraft_author":"itsLarss_","_minecraft_license":"MIT","_minecraft_downloads":23,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"trail-timer.zip","_minecraft_size_bytes":32430,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:22:16.540733Z","_minecraft_date_created":"2026-03-30T20:20:56.927535Z","_minecraft_date_modified":"2026-03-31T00:51:50.345732Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/trail-timer","_minecraft_icon_attachment_id":159019,"_minecraft_imported_at":"2026-06-09T14:01:33+00:00","_minecraft_import_hash":"49de2a9fe74cf2ce088308f03cd1cefa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,126,137,90,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-159018","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-management","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n