Welcome

Welcome to the official documentation for Aevum, a flexible timer and stopwatch system for your Minecraft server — create countdowns and stopwatches, scope them however you like, and wire them into your gameplay.

##What is Aevum?

Aevum lets you run as many timers and stopwatches as you need, each addressed by name and scope. A timer counts down to zero; a stopwatch counts up. Both can be paused, resumed, adjusted on the fly, and tagged with named checkpoints.

• Timers & stopwatches — countdowns that end and fire events, or stopwatches that run until you stop them.
• Three scopes — make an instance global (one shared clock), per-player (one each), or per-team (one per Stella team).
• Bulk targeting — apply a command to a single player/team or to everyone at once with @all.
• Checkpoints (marks) — record named splits on any timer/stopwatch and read them back later.
• Flexible time input — 90, 90s, 5m, 1h30m, 2d all work.
• Action engine — fire console commands, messages and broadcasts on tick, end or mark, gated by conditions (config.yml).
• PlaceholderAPI support — show any timer/stopwatch (and its marks) on scoreboards, tab, chat and more.
• Stella integration — team-scoped instances follow your Stella teams.
• Crash-safe persistence — every instance is saved on shutdown and restored exactly where it left off; server downtime is never counted.
• Developer API — drive Aevum from your own plugin and react to its events.

##Useful Links

Stay connected and keep your plugin up to date by visiting the following links:

• Modrinth — Download and rate the plugin on Modrinth!
• GitHub Repository — Access the source code and dev releases.

##Ready to Begin?

Jump to the Setup section to install Aevum and start tracking time like never before!