boti_timer
A Minecraft timer for use on multiplayer servers. It has count up and count down functionality and displays on the action bar.
I don't know my version or loader
🕒 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’sdatapacks/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.
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 26.1, 26.1.1, 26.1.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — see the MC Java Mods guides for the full walkthrough.
- Downloads as boti_timer_v0.2.1.zip
- Download size: 147 KB
- Download link checked 21 Aug 2026 — working
These come from our own check of the pack file, not from the source page.