A Simple Timer

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

- Pause-menu integration 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). - Pause-menu integration that draws over chat, the hotbar, and the debug overlay. Drag-to-place anywhere on screen. - Pause-menu integration 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` - Pause-menu integration on the left edge of the timer: - Green while running - Amber while paused - Red when expired - Pause-menu integration — 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.

- Live controls — three numeric fields (hours / minutes / seconds) with a reset-to-default icon to the right. - Live controls — 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. - Live controls — toggle the on-screen overlay. - Live controls — adjust the black space around the numbers (2 px to 24 px in 2 px steps). - Live controls — 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 0.148.0+26.1.2 (built and tested on 26.1.2) - Fabric Loader 0.148.0+26.1.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!