Ingame Timer

TimerPlugin

Bring structured time control to your server events, challenges and play sessions. TimerPlugin offers simple but powerful player-local timers and an optional “kick when time is up” mode – perfect for speedruns, daily play limits, minigames or community events.

✨ Features • Player-local timers: Each player can run their own countdown via /timer <minutes>. • Kick timer: /tmk <minutes> starts a personal timer that kicks the player when it expires (message configurable). • Clean feedback: Live Actionbar countdown (mm:ss). • Sound cues: Start/stop/finished and a configurable final countdown sound (from config.yml). • Daily playtime tracking: Lightweight tracking of minutes per player & day in plugins/TimerPlugin/data.yml. • Lightweight & dependency-free: No external libs; designed for Paper/Purpur/Spigot.

🕹 Commands

/timer <minutes>      # Start a personal timer with actionbar countdown
/timer stop           # Stop your running timer
/tmk <minutes>        # Start a “time’s up = kick” personal timer

• Fails gracefully if the player already has a running timer. • Usage hints and invalid number handling included.

timer:
  sound:
    finalCountdown: BLOCK_NOTE_BLOCK_HAT
    finished: ENTITY_ENDER_DRAGON_GROWL
    start: ENTITY_PLAYER_LEVELUP
    stop: ENTITY_VILLAGER_NO
  messages:
    kickMessage: " Your playtime is over! Come back tomorrow!"
    expiredMessage: "Your timer has expired!"

• Customize: sounds for start/stop/finish/final countdown, and the kick/expired messages. • A limits: section is present for future expansion.

🧾 How it stores data • Per-player daily minutes are stored in data.yml next to your config. • The plugin updates the date field and minutes counter automatically on join/quit.

✅ Compatibility • Built for Minecraft 1.21.9 (plugin version: 1.5.1, api-version: 1.20) • Works on Paper / Purpur / Spigot • Compiled targeting Java 21

📥 Installation 1. Drop TimerPlugin-1.5.1-1.21.9.jar into /plugins. 2. Start the server to generate config.yml. 3. Adjust sounds/messages (optional). Done.

🔎 Use cases • Speedruns & challenges – clean personal countdowns with audio cues. • Daily play caps – combine /tmk with your rules to enforce breaks. • Events – let players self-manage timed stages without global timers.

⸻

Kurzbeschreibung (DE)

Starte persönliche Timer mit /timer <Minuten> (Actionbar-Anzeige, Sounds) oder einen Kick-Timer mit /tmk <Minuten>, der dich nach Ablauf mit eigener Nachricht vom Server trennt. Spielzeit (Minuten pro Tag/Spieler) wird in data.yml mitgeloggt. Keine Abhängigkeiten, für 1.21.9 gebaut, Java 21.