OnTime ⏱️

A powerful and flexible timer mod for Minecraft. Create custom timers with on-screen display and command execution — ideal for minigames, events and automated server tasks.

✨ Features

🕐 Timer System

• Create and manage multiple named timers
• Countdown and count-up modes
• Start, pause, resume, stop, reset and remove timers at any time
• Add or override time on active timers
• Timers persist across server restarts and auto-resume where they left off
• Repeat mode — loop a timer a set number of times or infinitely
• Timer sequences — chain timers so the next starts automatically when the current finishes
• Scoreboard conditions — finish a timer early when a scoreboard objective reaches a target value
• Finish command — view or update a timer's command at any time with /timer command

🖥️ Server-Controlled Display

• Real-time on-screen overlay synced to all connected players
• 10 position presets: Boss Bar, Action Bar, Top/Center/Bottom variants, and Custom
• Per-player visibility control — admins can show or hide the timer for specific players
• Adjustable scale (0.1× to 5.0×)
• Dynamic color gradient based on remaining time (configurable thresholds and colors)
• All display settings are managed server-side and pushed to clients automatically
• Active timer synced to scoreboard — ontime_active objective updated every tick, usable with /execute if score

🔊 Sound

• Configurable tick sound, volume and pitch via /timer sound
• Per-player sound toggle managed by admins via /timer silent

⚡ Command Execution

• Attach any server command to a timer, executed automatically on completion
• Placeholder system: use {name}, {time}, {seconds}, {ticks}, {target}, {mode} in commands

📋 History Log

• Every timer completion is recorded in config/ontime/history.json with name, duration, mode, command and timestamp

⚙️ Configuration

• In-game config screen via Cloth Config (and ModMenu on Fabric)
• JSON config files in config/ontime/
• Optional WebSocket server for external integrations (panels, Discord bots) — enable in config.json

🔌 API & Integrations

• OnTime API — create, query, control timers and register event callbacks (onStart, onFinish, onPause, onResume, onTick)
• External finish conditions — register a custom Supplier<Boolean> that can stop a timer from another mod
• Custom renderer API — replace the timer HUD renderer entirely from a client-side mod
• LuckPerms support — per-node permission control for every subcommand, with OP-level fallback
• Entrypoint system — Fabric entrypoints and NeoForge/Forge IMC
• Placeholder API integration (Fabric)

🎮 Quick Command Reference

/timer create <name> <h> <m> <s> [countUp] [command]
/timer start <name>
/timer pause
/timer stop
/timer reset [name]
/timer remove <name>
/timer set <name> <h> <m> <s>
/timer add <name> <h> <m> <s>
/timer command <name> [command]
/timer repeat <name> [count]
/timer sequence <name> [nextName|clear]
/timer condition <name> <objective> <score> [target|clear]
/timer list
/timer hide [targets]
/timer silent [targets]
/timer position <preset>
/timer sound <soundId> [volume] [pitch]
/timer scale <value>
/timer help [page|command]

All commands require operator permission level 4 (or a LuckPerms node if installed).

🌐 Localization

Available in English, Spanish (AR / ES / MX).

💬 Links