Описание
# TPS HUD (TickPulse)
**See tick health at a glance.** A super-lightweight **client-side** overlay for **TPS** and **MSPT** on NeoForge.
No server install. No custom packets. Just local math.
## Highlights
- Live **TPS** and **MSPT** overlay (top-left by default)
- **Client-only**: join any server without them installing this mod
- **Zero network impact**: no handshake channels, no custom payloads
- Stable readout via world-time sampling with a short smoothing window (client-tick fallback)
- Tidy, always-on **Detail** layout (labels + values)
- Tiny footprint (low CPU and memory)
## Config & keybinds
- Open in-game config: **Mods → TPS HUD → Config**
- Tweak the HUD: **anchor, padding, scale, precision, format** (TPS / MSPT / BOTH), **smoothing**, **color thresholds**
- Buttons: **Apply** (save without closing), **Preview** (overlay-only view), **Reset** (defaults), **Done/Cancel**
- Keybinds (rebindable): **F7** = Toggle HUD, **F8** = Reload config
## Why use it?
- The vanilla debug screen doesn’t show TPS or MSPT
- Players and server owners can spot lag quickly (entity spikes, heavy bases, farms)
- Works in single-player, LAN, and public servers
## Compatibility
- **Minecraft:** 1.21.1
- **Loader:** NeoForge 21.1.213
- Plays nicely with performance mods (Sodium, ModernFix, etc.)
## Quick Start
1. Install NeoForge 1.21.1
2. Drop `tpshudneoforge-.jar` into your `mods` folder
3. Launch the game, the overlay appears once ticks start
## FAQ
**Is this server-side?**
No. It is client-side only.
**Does it send packets or open channels?**
No. It passively reads timing and estimates locally.
**Why do I see `TPS: --` at first?**
The sampler has no data yet. Move around or wait a moment.
**Why doesn’t TPS ever show above 20?**
For clarity the display is capped at **20.00** (internally we still track the true rate for coloring and logic).
**Why does the HUD disappear when I press F3?**
Enable/disable **Auto-hide on F3** in the config.
**Where is “Compact” mode?**
Removed for simplicity. The default **Detail** layout is clearer and consistent.
**Can I edit the config file directly?**
Use the in-game config whenever possible. Editing the JSON is optional if the game isn’t running.
## Credits
- Inspired by the Fabric mod `tpshud-fabric` by **mooziii**
- NeoForge port and re-implementation by **Zivalez**