No auto-start, no surprises. The timer stays at 00:00 until you type /start, so the time on screen is always time you deliberately tracked. Pause it when you take a break, stop it when the session ends, and check your totals whenever you want.
Features
- Playtime display above the hearts — left-aligned, clear of the health and armor bars
- Manual control — the timer never starts on its own; use
/start, /pause and /stop
- Two time modes — This session (since your last
/start) or Total (accumulated across all sessions and saved to disk)
- Fully customizable look — text color and opacity, background color and opacity, drop shadow, and scale from 50 % to 300 %
- Five positions — above the hearts, on the hotbar, above the hotbar, bottom left, bottom right — plus X/Y fine-tuning
- Custom label — replace "Playtime" with anything you like
- HUD-aware — optionally hides itself together with the HUD when you press F1
- Settings via Mod Menu — or press F8 in game if you don't have Mod Menu installed
- Client-side only — works in singleplayer and on any server, no server-side installation needed
Commands
| Command |
What it does |
/start |
Starts the timer (from 00:00 when stopped, continues when paused) |
/pause |
Pauses the running timer; the time stays on screen |
/stop |
Stops the timer; the reached time stays visible until the next /start |
/time |
Prints status, session time and total time to chat |
/time info |
Shows mod info: version, current display, mode, position and settings |
/time reset |
Resets only the session time back to 00:00 |
/time only intercepts its own subcommands — anything else, such as /time set day, is passed straight through to the server, so vanilla commands keep working.
Configuration
| Option |
Description |
| Show timer |
Turn the whole display on or off |
| Time mode |
This session / Total |
| Show label |
Toggle the text in front of the time |
| Label |
Custom label text (default: Playtime) |
| Text color |
Color and opacity of the text |
| Text shadow |
Drop shadow behind the text |
| Scale |
50 % – 300 % |
| Background |
Box behind the text, on/off |
| Background color |
Color and opacity of the box |
| Position |
Above the hearts, on the hotbar, above the hotbar, bottom left, bottom right |
| Offset X / Y |
Fine adjustment (positive Y moves up) |
Settings are saved automatically to config/playtimetimer.json; the total playtime is stored in config/playtimetimer-stats.json.
Installation
- Install Fabric Loader for Minecraft 1.21.11
- Put Fabric API into your
mods folder
- Put
playtimetimer-1.0.1.jar into your mods folder
- Start the game with the Fabric profile
Mod Menu is optional but recommended — it adds the settings screen to the mod list. Without it, press F8 in game to open the same screen.
Cloth Config is bundled inside the mod jar, so you do not need to install it separately.
Requirements
- Minecraft 1.21.11
- Fabric Loader 0.16.0 or newer
- Fabric API
- Java 21
Notes
- The timer only counts while you are in a world and the game is not paused (ESC or lost focus).
/start, /pause and /stop are client commands and take priority over server commands with the same name.
