🕒 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

1. Place the boti_timer folder (zipped or unzipped) into your world’s
   datapacks/ directory.
2. Run /reload in-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.

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.

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

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:

© Copyright

© 2025 DocBoti — Licensed under the MIT License.