Skip to content

Etoryx/PlayClock

Repository files navigation

Minecraft Fabric Java Tests Release

PlayClock

PlayClock is a client-side Fabric Minecraft mod that tracks your server playtime and singleplayer world playtime directly inside Minecraft — and turns it into clean, shareable playtime cards.

If you want a Minecraft playtime tracker mod with an in-game HUD, menu markers, hover tooltips, shareable summary cards, weekly & monthly recaps, AFK-aware tracking, and full Mod Menu settings, PlayClock is built for exactly that.

PlayClock per-server playtime card PlayClock weekly recap card

Why Use PlayClock?

PlayClock answers the questions vanilla Minecraft does not:

  • How long have I played on this server, in total?
  • How much did I play today, and this week?
  • How long is my current session?
  • When did I last open this world?
  • What's my current daily play streak?

Everything shows up in the UI you already use — the server list, the world list, hover tooltips, and an in-game HUD — and any of it can be turned into a card you can copy straight into Discord.

Features

Tracking

  • Tracks playtime for saved servers, direct-connect targets, LAN / localhost servers, and singleplayer worlds
  • Shows today, total, session, and last played
  • AFK-aware: idle time (no movement) is excluded from your totals — toggleable
  • Reliable singleplayer saving: active world time is flushed quickly while playing and saved again when leaving a world or closing the client
  • Retro-import: on first launch, your existing singleplayer worlds are backfilled from Minecraft's own playtime stats, so the mod isn't empty on day one

Shareable cards

  • Generate a clean per-server / per-world card, or a weekly or monthly "Wrapped" recap
  • Copy to clipboard (paste straight into Discord) or save as PNG
  • Recap cards show a day-by-day chart (7 or 30 days), this period vs the previous one, your top server, streak, and active days
  • Cards include your username and a customizable accent color (10 presets)

In-game HUD

  • Text HUD with 3 layout variantsMinimal, Compact, Stacked
  • Drag-and-drop position and adjustable scale via a live HUD editor
  • Optional today and session lines

In menus

  • Lightweight playtime markers in the server and world lists
  • Mouse-follow hover tooltip with detailed stats
  • Optional header summary in list screens

Quality of life

  • Daily-play streak milestones with achievement toasts (3, 7, 14, 30, 60, 100, 180, 365 days)
  • Weekly recap reminder — a once-a-week toast nudging you to open your summary
  • Hotkeys for quick toggling and for opening the summary / HUD editor

Customization & languages

  • Five UI color presets: Vanilla, Grass, Sunset, Amethyst, Cyberlime
  • Fully custom UI colors with RGB / HEX editing in Mod Menu
  • Configurable card accent, time format, and language override
  • English, Русский, Українська

Privacy

  • 100% client-side — nothing is sent anywhere
  • All data is stored locally in JSON

Supported Versions

PlayClock currently supports:

  • Minecraft 1.21.11
  • Minecraft 26.1 / 26.1.1 / 26.1.2

There are separate release files for each Minecraft branch.

Download

Get the latest build from the releases page:

GitHub Releases

Pick the jar that matches your Minecraft branch:

  • playclock-mc12111-1.2.0.jar for Minecraft 1.21.11
  • playclock-mc261x-1.2.0.jar for Minecraft 26.1 / 26.1.1 / 26.1.2

You will also need:

  • Fabric Loader
  • Fabric API
  • Mod Menu (optional, but recommended for the settings screen)
  • Java 21 for Minecraft 1.21.11, or Java 25 for Minecraft 26.1+

Installation

  1. Download the correct PlayClock jar for your Minecraft version.
  2. Make sure you are using Fabric Loader.
  3. Install Fabric API.
  4. Put the PlayClock jar into your Minecraft mods folder.
  5. Launch the game.

How To Use

In Menus

  • Open the multiplayer server list or singleplayer world list.
  • Look for the playtime text shown next to each entry.
  • Hover an entry to see today, total, session, and last played.

In Game

PlayClock shows a text HUD with your current playtime. Choose a layout (Minimal, Compact, Stacked) in the settings, and use the HUD editor to drag it anywhere and scale it to taste.

Sharing a Card

  1. Bind the Open PlayClock Summary hotkey in Controls → PlayClock (unbound by default).
  2. Press it in-game to open the summary screen.
  3. Switch between the Server card, Weekly, and Monthly views, pick a target, then:
    • Copy the image to your clipboard and paste it into Discord, or
    • Save PNG to screenshots/playclock/, or Open folder.

Hotkeys

Found in the standard Minecraft Controls screen under the PlayClock category:

Action Default
Toggle HUD H
Toggle menu markers B
Open PlayClock Summary unbound
Open PlayClock HUD Editor unbound

Configuration

With Mod Menu installed, PlayClock includes a settings screen where you can change:

  • HUD enabled / disabled, menu markers enabled / disabled, tooltips enabled / disabled
  • HUD variant, HUD position & scale (opens the drag editor)
  • Time format, language override
  • Show / hide today and session in the HUD
  • Header summary enabled / disabled
  • Ignore AFK time (AFK-aware tracking)
  • Card accent color
  • UI color preset (Vanilla, Grass, Sunset, Amethyst, Cyberlime)
  • Custom UI colors with RGB / HEX editing

Notes

  • PlayClock is client-side only.
  • Your playtime data is stored locally.
  • Realms is not supported in the current release.

Data Storage

PlayClock stores its data locally:

  • Playtime & settings: config/playclock/playclock-state.json
  • Saved cards: screenshots/playclock/

License

GPL-3.0-or-later

Packages

 
 
 

Contributors

Languages