Ingame Timer

Minecraft 版本： 1.20.4 1.20.5 1.20.6 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 spigot

标签： social technology utility

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 .
• Kick timer: /tmk 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 (Actionbar-Anzeige, Sounds) oder einen Kick-Timer mit /tmk , 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.