PlayerTimer Fabric

A Fabric mod providing independent per-player timers for Minecraft servers and singleplayer worlds.

Each player has their own timer which can:

• count up
• count down
• be paused/resumed
• be hidden or shown independently
• be triggered by commands or command blocks

Designed for:

• minigames
• escape rooms
• timed challenges
• parkour
• speedrunning
• multiplayer events
• adventure maps

Features

• Independent timer per player
• Countup and countdown modes
• Brigadier command support
• Pause and resume support
• Timer visibility control
• Countdown completion notification
• Sound effects on completion
• Multiple duration input formats
• Command block compatible using /execute as
• Built for Fabric
• Java 25 support

Commands

Duration Formats

The countdown command accepts multiple input formats.

1. Seconds

/playertimer startcountdown 300

Starts a 300 second countdown.

2. mm:ss

/playertimer startcountdown 05:30

Starts a 5 minute 30 second countdown.

Rules:

• mm must be between 0 and 59
• ss must be between 0 and 59

Examples:

05:30   ✓ valid
59:59   ✓ valid
60:00   ✗ invalid
05:60   ✗ invalid
99:99   ✗ invalid

3. hh:mm:ss

/playertimer startcountdown 01:40:05

Starts a 1 hour 40 minute 5 second countdown.

Rules:

• mm must be between 0 and 59
• ss must be between 0 and 59

Examples:

01:40:05   ✓ valid
10:59:59   ✓ valid
01:60:05   ✗ invalid
01:40:60   ✗ invalid

4. Text format

/playertimer startcountdown 1h40m5s
/playertimer startcountdown 10m
/playertimer startcountdown 45s
/playertimer startcountdown 2h
/playertimer startcountdown 1h5s

Supports:

• hours (h)
• minutes (m)
• seconds (s)

Any combination may be used.

Rules:

• m must be between 0 and 59
• s must be between 0 and 59

Examples:

1h40m5s   ✓ valid
10m30s    ✓ valid
59m59s    ✓ valid
1h60m     ✗ invalid
10m90s    ✗ invalid
10s49m    ✗ invalid

Maximum Duration

The maximum allowed duration is:

2147483647 seconds

which is approximately:

68 years

This limit exists because the timer internally uses Java int values.

Timer States

Internally the mod tracks timer state using a finite state model.

This prevents invalid operations such as:

• resuming finished timers
• starting multiple timers simultaneously
• resuming timers that were stopped

Visibility Behaviour

Timer visibility is independent of timer state.

Countdown Completion

When a countdown reaches zero:

• the timer stops automatically
• the timer enters the FINISHED state
• the player receives a notification
• a bell sound is played

Command Block Support

Commands can be triggered via command blocks using Minecraft's execute command.

Example:

execute as @p run playertimer startcountdown 5m

This allows:

• buttons
• pressure plates
• redstone systems
• region triggers
• adventure map integration

Building

Requirements

• Java 25
• Gradle
• Fabric Loader
• Fabric API

Build

./gradlew build

Compiled jars will appear in:

build/libs/

Versioning

PlayerTimer uses the following versioning scheme:

[target-minecraft-version]-[mod-version]

Example:

26.1.x-1.0

Meaning:

• Compatible with Minecraft 26.1.x / API 26.1.x
• Mod release version 1.0

Changelog

26.1.x-1.0

• Initial Fabric release
• Ported PlayerTimer from Paper to Fabric
• Added per-player timers
• Added countdown and countup modes
• Added timer state system
• Added visibility system
• Added Brigadier command support
• Added command block compatibility
• Added duration parsing with multiple formats
• Added action bar timer display
• Added countdown completion sounds
• Added Java 25 support
• Refactored timer logic into PlayerTimerService

License

MIT License

PlayerTimer-fabric