Ryu's Timer

A simple on-screen timer for Fabric. I made it for challenge videos and speedruns, where you want a timer that looks good on screen and doesn't reset every time you close the game.

Every world and every server has its own timer. You can leave, play somewhere else, close Minecraft, and when you come back the time is still there.

What it can do

• Shows the time as 42s, 12m 4s, 2h 14m 9s or 3d 4h 12m 9s, with optional milliseconds
• Saves the timer per world and per server, also when the game closes
• You choose when it counts: always (real time, keeps going while you're offline), only while you're in the world, or only while you're actually playing (stops in the pause menu)
• Drag it anywhere on the screen with the mouse (/timer edit), or use one of 9 fixed positions
• Any size, from small to really big
• 28 color presets, including gradients like Fire, Ocean, Aurora and Galaxy, plus ✨
• Animated gradients that flow through the numbers, speed is adjustable
• Your own colors: one hex color, or two for a gradient
• Already played a world for weeks? /timer sync world sets the timer to the world's age, /timer sync playtime to your own playtime
• Client-side only, works in singleplayer and on any server

Commands

Command	What it does
/timer start	Starts the timer
/timer stop	Pauses it
/timer resume	Continues after a pause
/timer toggle	Start, pause or resume, depending on the state
/timer reset	Resets to zero (asks you to confirm first)
/timer edit	Opens the editor to drag and resize the timer
/timer sync world	Sets the timer to how long the world has existed
/timer sync playtime	Sets the timer to your playtime in this world or on this server
/timer show / /timer hide	Shows or hides it
/timer gradient <preset>	Changes the color preset
/timer color <#hex> [#hex]	One custom color, or two for a gradient
/timer pos <preset>	Moves it, e.g. TOP_LEFT or BOTTOM_CENTER
/timer pos <x> <y>	Puts it at exact coordinates

There are also keybinds for start/pause, reset and the editor. They're unbound by default, set them under Controls. Everything else can be changed in the settings screen (Mod Menu).

Color presets

Solid: White, Gray, Black, Red, Orange, Yellow, Green, Lime, Cyan, Blue, Purple, Pink

Gradients: Fire, Lava, Ice, Ocean, Forest, Sunset, Aurora, Gold, Neon, Plasma, Galaxy, Candy

Special: ✨, Basti, E63, Vito

Versions

Minecraft 1.21.4 to 1.21.11 and 26.1 to 26.3. Pick the file for your version.

You need

• Fabric API
• Cloth Config (for the settings screen)
• Mod Menu is optional, it opens the settings from the mod list

Bugs and ideas

If something doesn't work or you have an idea, open an issue. I read all of them.

Made by Ryu.