Trail Timer

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper purpur spigot

标签： adventure game-mechanics utility

⏱ 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 hooking into the spawner's internal state via NMS reflection:
when a spawner enters cooldown, the plugin overwrites cooldownEndsAt to your configured duration.
Minecraft then reads that value and considers the cooldown over — simple and clean.

? Installation

1. Drop TrialTimer-x.x.x.jar into your plugins/ folder
2. Restart the server
3. Edit plugins/TrialTimer/config.yml
4. 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: The NMS reflection targets Mojang-mapped Paper/Purpur builds (1.21+).
Enable debug: true if you run into issues — it logs the exact field names found at runtime.

? License

MIT — free to use, fork, and redistribute.