I Can Show Your Speed (ICSYS) 🏃‍♂️

A lightweight, client-side speed HUD overlay mod for Minecraft.

[!IMPORTANT] Archive Notice: This repository has been archived by the owner and is no longer actively maintained. The code and assets are preserved solely for historical, reference, and educational purposes.

Track your movement speed in real time with a fully customizable overlay — choose which metrics to display, add progress bars, adjust smoothing, and position the HUD anywhere on screen.

📽️ Demo

🎯 Features

Displays your real-time movement speed as a compact HUD overlay with three metrics:

• Speed: Total 3D movement speed (blocks/second).
• H-Speed: Horizontal speed only (useful for sprinting/elytra).
• V-Speed: Vertical speed with ↑↓ direction (useful for falling/flying).

Each metric can be shown as text, a color-coded progress bar, or both.

✨ Highlights

• Fully Customizable: Toggle each metric and bar individually, adjust opacity, and choose color themes.
• Drag & Drop: Position the HUD anywhere with mouse dragging and pixel-perfect arrow key nudging.
• Smart Snapping: HUD snaps to screen edges and center with visual guides.
• Adjustable Smoothing: Cycle between 6 smoothing presets (1t to 60t) for raw or smooth readings.
• Color-Coded: Speed values change color: white → yellow → red as you move faster.
• Bar-Only Mode: Minimal bars with tiny labels (S, H, V↑/V↓) when text is off.
• Zero Overhead: No mixins, client-side only, uses Fabric API events.

⌨️ Controls

• H: Toggle the speed HUD on/off.
• K: Open the interactive configuration positioning screen.

Layout Positioning Screen Controls

• Drag: Reposition the HUD block using the mouse cursor.
• Arrow Keys / WASD: Nudge HUD position by exactly 1 pixel (Ctrl to nudge 10px).
• 1 / 2 / 3: Toggle textual display of Speed, Horizontal Speed, and Vertical Speed.
• Ctrl + 1 / 2 / 3: Toggle visual speed progress bar overlays.
• R: Cycle through reading smoothing averages (1 → 5 → 10 → 20 → 40 → 60 ticks).
• O / Ctrl+O: Cycle background opacity levels.
• T: Cycle visual HUD color themes.
• ESC: Save active configurations and exit screen.

📦 Requirements

• Minecraft Version: 26.1
• Fabric Loader Version: ≥ 0.18.4
• Fabric API
• Fabric Language Kotlin
• Mod Menu (Optional — provides a graphical config menu button in your mod list)

📄 License

Licensed under the terms of the MIT License.