A Simple Timer

A lightweight, client-side countdown timer overlay for Minecraft 26.1.2 (Fabric).

Set a length, hit a key, watch the clock — that's it.

Features

• Async countdown that ticks in real time. The world pausing, lag spikes, or low frame rate don't affect it (unless you opt in via Auto-Pause).
• Always-on-top HUD that draws over chat, the hotbar, and the debug overlay. Drag-to-place anywhere on screen.
• Smart time formatting that scales with the chosen length:
  • Under 1 hour → 20:00
  • 1–9 hours → 1:00:00
  • 10–99 hours → 10:00:00
  • 100+ hours → 100:00:00
  • State-aware accent bar on the left edge of the timer:
    • Green while running
    • Amber while paused
    • Red when expired
  • Bell on expiry — a soft note-block bell rings once when the timer hits zero, routed through the UI sound channel so it respects your GUI volume slider.
  • Pause-menu integration — a clock button sits to the left of the Advancements button in the Esc menu and opens the settings screen.

Keybinds (rebindable in vanilla Controls)

Settings

Open via the clock icon in the pause menu.

• Length — three numeric fields (hours / minutes / seconds) with a reset-to-default icon to the right.
• Reposition Timer — opens a dedicated drag screen with a faint grid, instruction banner and controls in the top-left corner so they never get in the way of where you want to put the timer. The timer always renders on top of the grid for visibility.
• Visible — toggle the on-screen overlay.
• Padding — adjust the black space around the numbers (2 px to 24 px in 2 px steps).
• Auto-Pause — when on, the timer pauses with the game (singleplayer pause menu) and resumes when you unpause.
• Live controls — Start/Pause and Reset buttons sit above the settings panel so you can scrub the timer without leaving the menu.

All settings persist to <config>/simple_timer.json.

Requirements

• Minecraft 26.1.x (built and tested on 26.1.2)
• Fabric Loader 0.19.2+
• Fabric API 0.148.0+26.1.2 or compatible

Compatibility

This mod is client-side only. It will not load on dedicated servers and does not require server-side cooperation — install it on your client, then feel free to join any vanilla or modded server. It will still work!