Skip to content

Install English

Jump to bottom
Bloody_Mind edited this page Oct 16, 2026 · 2 revisions

Install – English

Documents version 1.3

Overview · Commands · Permissions · Deutsch

Requirements

  • A compatible Paper server. The current TrackTimer version uses Paper API 26.2 and Java 25.
  • For setup: operator status or the corresponding permissions.
  • Optional: CMI or DecentHolograms for results holograms and HeadDatabase for custom GUI heads. Race timing works without these plugins.

Installation

  1. Stop the server.
  2. Place the TrackTimer JAR in the plugins folder.
  3. Start the server. TrackTimer creates its files in plugins/TrackTimer.
  4. Check the console log to confirm that TrackTimer started successfully. It also reports the detected hologram provider or that none is available.

TrackTimer defaults to German and a local SQLite database. No extensive configuration is needed to get started. Use /tt config to change settings in-game, including the language. To use MySQL/MariaDB, enter the connection details in config.yml and restart the server.

First steps

1. Create a track

For a normal track with three laps:

/tt create Speedway 3 player

For a shared signal start or a traffic-light start:

/tt create Signaltrack 3 signal
/tt create TrafficLightTrack 3 traffic_light

player gives each player an individual start time. signal uses the shared start time of the redstone signal. traffic_light runs a traffic-light sequence. You can change the start mode later in the event editor. /tt is the default alias for /tracktimer.

2. Place triggers

  1. Open /tt editor and select your track.
  2. Select the start trigger tool. Left-click to add the desired start blocks; right-click to remove a placed trigger.
  3. Type exit in chat to finish the selection. The tool is removed and exit is not sent to public chat.
  4. Add checkpoints if needed. All blocks placed during one tool selection belong to the same checkpoint. For example, mark four blocks across the track for checkpoint 1. After exit, the next selection uses the next higher checkpoint number.
  5. Use the finish trigger tool to mark the finish line and end the selection with exit.
  6. For a signal start, place the redstone signal trigger. For a traffic-light start, select the traffic-light tool in the trigger editor, left-click an empty anchor block, then type exit. The tool places five traffic-light heads. Power the anchor block with redstone to start the sequence.

3. Drive your first lap

With a player start, the timer begins when you cross a start trigger. A signal start gives all participants the shared signal time. With a traffic-light start, the redstone signal begins the countdown; after release, each run begins when the player crosses the start line. An early crossing aborts the sequence. Signal and traffic-light starts appear together as redstone races.

Pass checkpoints in numerical order. Only then does crossing the finish line count a lap. The run ends once the configured number of laps has been completed.

The running time appears in the boss bar; checkpoint split times appear in the action bar. Use /tt leave to cancel your active run.

4. View results

/tt overview opens the track and results overview. /tt topten Speedway displays normal player starts in chat; add a date to select signal and traffic-light results in the redstone category. See Commands for syntax and additional commands.

Use /tt help to see the commands you have permission to use.

TrackTimer

GitHub

Clone this wiki locally