Trail Timer

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

1. Make sure your server runs Minecraft 26.x and Java 25
2. Drop TrialTimer-x.x.x.jar into your plugins/ folder
3. Restart the server
4. Edit plugins/TrialTimer/config.yml
5. 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

---

💬 Commands

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).

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

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: true if you run into issues — it logs every cooldown change.

---

📄 License

MIT — free to use, fork, and redistribute.