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)

| Action | Default |
|---|---|
| Start / Pause | = |
| Reset | - |
| Hide / Show | unbound by default|

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!