Skip to content

English

Michael Bork edited this page Oct 16, 2026 · 5 revisions

TrackTimer – Overview

Documents version 1.3.1 · Project on GitHub

Home and language selection · Deutsche Übersicht

TrackTimer is a Paper plugin for race tracks and timed races in Minecraft. It records lap and checkpoint times, manages multiple tracks and displays race results through leaderboards and optional holograms.

Start modes and results

Player start: Each player starts an individual run by crossing a start trigger.

Signal start: A redstone signal releases a shared start. Players who then cross the start trigger receive the signal's start time.

Traffic-light start: A redstone signal begins a sequence of five lights. After a randomized countdown, the start is released. Crossing the start line early causes a false start and aborts the sequence.

Player starts are recorded as normal races. Signal and traffic-light starts share the redstone races results category. You can change an event's start mode; existing results remain classified by how each race started.

What does TrackTimer offer?

  • Multiple tracks with their own lap counts.
  • Track management and settings through GUIs.
  • Tools for placing start, checkpoint, finish, signal and traffic-light triggers directly in the world.
  • Select redstone races by start time and view them in TopTen GUIs, chat and results holograms.
  • Live holograms for normal and redstone races.
  • Several trigger blocks for the same checkpoint, for example across the full width of a track.
  • Checkpoints in a defined order. The finish line only counts a lap once all required checkpoints have been reached.
  • A running timer in the boss bar and checkpoint times in the action bar.
  • Leaderboards and personal lap and checkpoint times.
  • Optional results holograms that update after completed races.
  • German and English text, with SQLite or MySQL/MariaDB storage.

Using TrackTimer

/tt is the default alias for /tracktimer. Use /tt help to see the commands you have permission to use. /tt editor opens track management and /tt config opens the settings.

When editing a track, selection tools let you choose the trigger blocks. Type exit in chat to finish selecting triggers. Use /tt leave to cancel your current run.

Optional plugins

CMI or DecentHolograms is required for holograms. TrackTimer still starts without either plugin; hologram buttons and the hologram command are then unavailable.

HeadDatabase supplies the custom heads used in the GUIs and is also optional.

Requirements

The current version uses Paper API 26.2 and Java 25.

Project and README

Reference

Clone this wiki locally