🕒 boti_timer — Global Countdown / Count-Up Timer (v0.1.0)
A lightweight, fully-vanilla Minecraft timer datapack that displays a running timer on the actionbar.
Designed for operators who need a simple, server-side stopwatch or countdown for events, speedruns, or minigames.
✨ Features
- ⏱️ Count up or down (configurable)
- 🎨 Selectable display colors (gold, yellow, purple, green, aqua, red, gray)
- 🧠 Built entirely with functions and scoreboards
- ⚙️ Operator-controlled start/stop/toggle functions
- 🔔 Real-time actionbar display (
HH:MM:SS) - 🧩 Works in vanilla, Paper, Fabric, or Forge servers — no mods required
🧭 Installation
- Place the
boti_timerfolder (zipped or unzipped) into your world’s
datapacks/directory. - Run
/reloadin-game.
⚙️ Initialization
The timer is initialised with the command /function boti_timer:init (see below). This will:
- Create required scoreboard objectives,
- Set defaults:
- mode is set to count up
- display colour is set to yellow
- the timer is made visible and will displays 00:00:00
- Start a repeating schedule every second.
⚙️ Usage
All Modes
The timer is controlled by typing commands into the chat or the server console. Vanilla behaviour is, that only server operators are allowed to use the /function command so other players are not able to start/pause etc. the timer.
| Action | Command |
|---|---|
| initialise the timer | /function boti_timer:init |
| start the timer | /function boti_timer:start |
| pause the timer | /function boti_timer:pause |
| reset the timer | /function boti_timer:reset |
| resume the timer | /function boti_timer:resume |
Countdown Mode
The countdown mode comes with 4 presets, for 5 minutes, 15 minutes, 30 minutes and 1 hour respectively. It can also be used with a custom period of time, which needs to be specified in seconds.
| Action | Command |
|---|---|
| initialise the timer | /function boti_timer:settings/preset/5m |
| start the timer | /function boti_timer:settings/preset/15m |
| pause the timer | /function boti_timer:settings/preset/30m |
| reset the timer | /function boti_timer:settings/preset/1h |
| resume the timer | /function boti_timer:resume |
When using the preset countdowns the timer has to be started manually by issuing the following command: /function boti_timer:start
When a different amount of time for the countdown timer is required, this can be done by issuing the comand /function boti_timer:settings/mode/countdown {secs:nnnn} where nnnn is the number of seconds required. If the countdown timer is used this way, it will start immediately. In the following example the countdown timer will run for 90 minutes:
/function boti_timer:settings/mode/countdown {secs:5400}
Note: This will start the countdown immediately.
🎮 Operator Controls
| Function | Description |
|---|---|
/function boti_timer:display/enable | Show timer on actionbar |
/function boti_timer:display/disable | Hide timer display |
/function boti_timer:display/toggle | Toggle show/hide |
/function boti_timer:settings/mode/countup | Switch to count-up mode |
/function boti_timer:settings/mode/countdown {secs:3600} | Switch to countdown mode and set seconds (1 h = 3600) |
Note: Only ops can run these functions.
🖌️ Customization
Colours
The timer colour can be one of 7 colours and it defaults to yellow. To change the colour:
| Command | Effect |
|---|---|
| /function boti_timer:settings/color.gold | set the display colour to gold |
| /function boti_timer:settings/color.yellow | set the display colour to yellow |
| /function boti_timer:settings/color.purple | set the display colour to light purple |
| /function boti_timer:settings/color.green | set the display colour to green |
| /function boti_timer:settings/color.aqua | set the display colour to aqua |
| /function boti_timer:settings/color.red | set the display colour to text |
| /function boti_timer:settings/color.gray | set the display colour to gray |
© Copyright
© 2025 DocBoti — Licensed under the MIT License.
