# \ud83d\udd52 boti_timer \u2014 Global Countdown \/ Count-Up Timer (v0.1.0)<\/p>\n
A lightweight, fully-vanilla Minecraft **timer datapack** that displays a running timer on the **actionbar**. <\/p>\n
Designed for operators who need a simple, server-side stopwatch or countdown for events, speedruns, or minigames.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \u23f1\ufe0f Count **up** or **down** (configurable)
\n– \ud83c\udfa8 Selectable display colors (gold, yellow, purple, green, aqua, red, gray)
\n– \ud83e\udde0 Built entirely with **functions and scoreboards**
\n– \u2699\ufe0f Operator-controlled start\/stop\/toggle functions
\n– \ud83d\udd14 Real-time **actionbar display** (`HH:MM:SS`)
\n– \ud83e\udde9 Works in **vanilla**, **Paper**, **Fabric**, or **Forge** servers \u2014 no mods required<\/p>\n
—<\/p>\n
## \ud83e\udded Installation<\/p>\n
1. Place the `boti_timer` folder (zipped or unzipped) into your world\u2019s
\n `datapacks\/` directory.
\n2. Run `\/reload` in-game. <\/p>\n
—<\/p>\n
## \u2699\ufe0f Initialization<\/p>\n
The timer is initialised with the command `\/function boti_timer:init` (see below). This will:
\n– Create required scoreboard objectives,
\n– Set defaults:
\n\t– mode is set to count up
\n\t– display colour is set to yellow
\n\t– the timer is made visible and will displays 00:00:00
\n– Start a repeating schedule every second.<\/p>\n
—
\n## \u2699\ufe0f Usage
\n### All Modes
\nThe 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.<\/p>\n
| Action | Command |
\n|———–|————–|
\n| initialise the timer | `\/function boti_timer:init` |
\n| start the timer | `\/function boti_timer:start` |
\n| pause the timer | `\/function boti_timer:pause` |
\n| reset the timer | `\/function boti_timer:reset` |
\n| resume the timer | `\/function boti_timer:resume` |<\/p>\n
### Countdown Mode
\nThe 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.<\/p>\n
| Action | Command |
\n|———–|————–|
\n| initialise the timer | `\/function boti_timer:settings\/preset\/5m` |
\n| start the timer | `\/function boti_timer:settings\/preset\/15m` |
\n| pause the timer | `\/function boti_timer:settings\/preset\/30m` |
\n| reset the timer | `\/function boti_timer:settings\/preset\/1h` |
\n| resume the timer | `\/function boti_timer:resume` |<\/p>\n
When using the preset countdowns the timer has to be started manually by issuing the following command: `\/function boti_timer:start`<\/p>\n
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:<\/p>\n
– `\/function boti_timer:settings\/mode\/countdown {secs:5400}`<\/p>\n
> **Note: This will start the countdown immediately.**<\/p>\n
## \ud83c\udfae Operator Controls<\/p>\n
| Function | Description |
\n|———–|————–|
\n| `\/function boti_timer:display\/enable` | Show timer on actionbar |
\n| `\/function boti_timer:display\/disable` | Hide timer display |
\n| `\/function boti_timer:display\/toggle` | Toggle show\/hide |
\n| `\/function boti_timer:settings\/mode\/countup` | Switch to count-up mode |
\n| `\/function boti_timer:settings\/mode\/countdown {secs:3600}` | Switch to countdown mode and set seconds (1 h = 3600) |<\/p>\n
> **Note:** Only ops can run these functions.<\/p>\n
—<\/p>\n
## \ud83d\udd8c\ufe0f Customization<\/p>\n
### Colours
\nThe timer colour can be one of 7 colours and it defaults to yellow. To change the colour:<\/p>\n
| Command | Effect | —<\/p>\n ## © Copyright<\/p>\n © 2025 DocBoti \u2014 Licensed under the MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":" A Minecraft timer for use on multiplayer servers. It has count up and count down functionality and displays on the action bar.<\/p>\n","protected":false},"featured_media":34107,"template":"","meta":{"_minecraft_slug":"boti_timer","_minecraft_project_id":"nadUcmNo","_minecraft_author":"BlackShadowHRD","_minecraft_license":"MIT","_minecraft_downloads":42,"_minecraft_follows":0,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"boti_timer.zip","_minecraft_size_bytes":141259,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:31:51.613017Z","_minecraft_date_created":"2025-10-19T21:36:58.107894Z","_minecraft_date_modified":"2025-10-17T08:08:29.602658Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/boti_timer","_minecraft_icon_attachment_id":34107,"_minecraft_imported_at":"2026-06-01T16:10:35+00:00","_minecraft_import_hash":"bff7dad0cd5ce00f53f3a4ec1f83f98b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,89,866,92],"mod_loader":[86],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-34106","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-game-mechanics","mod_category-minigame","mod_category-utility","mod_loader-datapack","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|:–|:–|
\n| \/function boti_timer:settings\/color.gold | set the display colour to gold<\/span> |
\n| \/function boti_timer:settings\/color.yellow | set the display colour to yellow<\/span> |
\n| \/function boti_timer:settings\/color.purple | set the display colour to light purple<\/span> |
\n| \/function boti_timer:settings\/color.green | set the display colour to green<\/span> |
\n| \/function boti_timer:settings\/color.aqua | set the display colour to aqua<\/span> |
\n| \/function boti_timer:settings\/color.red | set the display colour to text<\/span> |
\n| \/function boti_timer:settings\/color.gray | set the display colour to gray<\/span> |<\/p>\n