Trail Timer
Reduces the Trial Spawner cooldown from the vanilla 30 minutes to a configurable duration — fully server-side, no client mods required.
Описание
⏱ TrialTimer
Configurable Trial Spawner cooldown — because 30 minutes is way too long.
🔧 What does it do?
Vanilla Trial Spawners have a hardcoded 30-minute cooldown after a wave is completed. TrialTimer lets you set that to whatever you want — down to a few seconds if needed.
No client-side mods required. Works fully server-side.
When a spawner finishes its cooldown, nearby players receive a broadcast message so they know it's ready to fight again.
⚙️ How does it work?
The 30-minute rule is hardcoded in Minecraft's source code, so datapacks can't touch it.
TrialTimer works around this by changing the spawner's cooldownEndsAt value:
when a spawner enters cooldown, the plugin overwrites it with your configured duration.
Minecraft then reads that value and considers the cooldown over — simple and clean.
- Paper / Purpur / Folia: uses the Bukkit API (
TrialSpawner#setCooldownEnd) - Spigot: the API has no cooldown-end method, so the plugin automatically falls back to reflection
- Folia: the scan runs on the region schedulers
📦 Installation
- Make sure your server runs Minecraft 26.x and Java 25
- Drop
TrialTimer-x.x.x.jarinto yourplugins/folder - Restart the server
- Edit
plugins/TrialTimer/config.yml - Run
/trialtimer reload
🗂 config.yml
# Cooldown duration in minutes. Supports decimals (e.g. 0.5 = 30 seconds).
# Vanilla default: 30 minutes
cooldown-minutes: 5.0
# Language for plugin messages.
# Available: en, de
language: en
# Broadcast a message to nearby players when a Trial Spawner finishes its cooldown.
broadcast:
enabled: true
radius: 64 # in blocks
# Debug mode — logs every cooldown modification to the console.
debug: false
Quick reference — Minutes → Ticks
| Minutes | Seconds | Ticks |
|---|---|---|
| 0.5 | 30s | 600 |
| 1 | 60s | 1,200 |
| 5 | 300s | 6,000 |
| 10 | 600s | 12,000 |
| 30 | 1800s | 36,000 (vanilla) |
💬 Commands
| Command | Description | Permission |
|---|---|---|
/trialtimer help | Shows command overview | trialtimer.use |
/trialtimer info | Shows current cooldown | trialtimer.use |
/trialtimer reload | Reloads config + language | trialtimer.reload |
Alias: /tt
📢 Broadcast
When a Trial Spawner finishes its cooldown, all players within the configured radius receive a message:
[TrialTimer] A Trial Spawner at 42, 63, -128 is ready to fight again!
The message is fully customizable in the language files (lang/messages_en.yml / lang/messages_de.yml).
📊 PlaceholderAPI
TrialTimer supports PlaceholderAPI (optional — works without it too).
| Placeholder | Description |
|---|---|
%trialtimer_cooldown_minutes% | Configured cooldown in minutes |
%trialtimer_cooldown_seconds% | Configured cooldown in seconds |
%trialtimer_cooldown_ticks% | Configured cooldown in ticks |
Use these in scoreboards, holograms, or any plugin that supports PlaceholderAPI.
🌍 Language Support
TrialTimer ships with English and German out of the box.
Switch via language: de in config.yml.
Language files are saved to plugins/TrialTimer/lang/ and can be edited freely.
🔌 Compatibility
| Software | Supported |
|---|---|
| Paper 1.21.x - 26.x | ✅ |
| Purpur 1.21.x - 26.x | ✅ |
| Bukkit 26.x | ✅ |
| Spigot 26.x | ✅ |
| Folia 26.x | ✅ |
| PlaceholderAPI | ✅ (optional) |
Note: Version 1.2.0 requires Minecraft 26.x and Java 25. For Minecraft 1.21.x (Paper/Purpur only), use TrialTimer 1.1.0. Enable
debug: trueif you run into issues — it logs every cooldown change.
📄 License
MIT — free to use, fork, and redistribute.