MC Day Counter
A Fabric client mod for Minecraft that highlights when a new in-game day begins. The day number matches the same counter as the F3 debug screen (Day #N), including worlds that use the overworld day timeline when available.
What it does
- When the day index advances (new day at the sunrise boundary), a label like
Day #123appears large in the center of the screen for a short hold, then animates (position and scale) to sit beside the hotbar on the right. - Optionally, the current day can stay visible next to the hotbar when nothing is animating.
Features
- F3-consistent day — Uses the overworld day timeline when the registry provides it; otherwise falls back to the classic day-from-ticks behavior.
- Configurable — Animation length, popup scale, idle hotbar label, and text color (via Mod Menu + Cloth Config when those mods are installed).
- JSON config — Settings are also written to
config/mc_day_counter.jsonin your game folder.
Requirements
| Requirement | Version (this repo) |
|---|---|
| Minecraft | 26.1 |
| Fabric Loader | ≥ 0.18.5 |
| Fabric API | bundled in gradle.properties |
| Java | 25+ |
| Cloth Config | required (Fabric) |
| Mod Menu | optional (recommended for in-game settings) |
Building
From the project root:
.\gradlew.bat build
The mod JAR is produced under build/libs/.
License
See LICENSE in the repository (mod metadata lists CC0-1.0).

