Stamina System
- By
Adds a stamina bar above your hotbar. Sprinting and jumping drain your stamina; drop into the red zone and you're forced to walk until you recover. Fully compatible with TACZ (Timeless & Classics: Zero).
Full Description
A stamina bar that makes every sprint and jump matter. Made by Kei Team for Forge 1.20.1.
What It Does
- A clean stamina bar sits right above your hotbar / XP bar.
- Sprinting drains stamina continuously. Jumping takes a big chunk.
- Drop below 30% and the bar turns dark red (the danger zone).
- Hit 0 and you are forced to walk — sprinting is locked until your stamina recovers back above the danger-zone threshold.
- Stop moving and stamina regenerates automatically.
Features
- ✔ Smooth animated HUD — the bar glides, no janky jumps.
- ✔ Danger zone — dark red below 30%, cleared only after recovering above it.
- ✔ Exhaustion lock — forced walking at 0 stamina until you recover above the danger-zone line.
- ✔ Hidden when full — the bar only shows when your stamina is actually changing; hides again when full.
- ✔ Hidden in Creative / Spectator — no PvP or build-mode clutter.
- ✔ TACZ compatible — holding a gun drains stamina faster, scaled by the weight of the gun (≈ weapon class).
TACZ (Timeless & Classics: Zero) Integration
Sprint drain multiplier by gun weight (≈ class):
| Weapon type | Sprint drain multiplier |
|---|---|
| Pistol | ≈ ×1.23 |
| SMG | ≈ ×1.45 |
| Rifle | ≈ ×1.60 |
| Sniper | ≈ ×1.90 |
| MG / RPG | ≈ ×2.2+ |
No TACZ installed? The mod runs perfectly fine without it — integration is reflection-based, zero hard dependency.
Values (easy to tweak in StaminaData.java)
| Parameter | Default | Meaning |
|---|---|---|
| MAX | 100 | Max stamina |
| RUN_COST | 0.60/tick | Sprint drain (empty hand) — ~8 s to empty |
| JUMP_COST | 6.0 | Cost per jump |
| REGEN | 0.42/tick | Regeneration — full in ~12 s |
| DANGER_RATIO | 0.30 | Dark-red danger zone / exhaustion release threshold |
Compatibility
- Minecraft: 1.20.1
- Forge: 47.x (mod loader v47+)
- Java: 17+
- Mod id:
stamina— version 1.0.1 - No hard dependencies. Optional integration: TACZ 1.1.8+ (reflection).
Notes
- Stamina is a server-side value synced to the client — works in single player and multiplayer.
- Exhaustion release threshold uses the same 30% as the danger zone: you must recover above it before you can sprint again.
中文对照（供参考）
详细介绍要点：
- 底层栏正上方一条平滑体力条；白色正常，≤30% 变深红；
- 奔跑持续消耗、跳跃大额消耗；耗尽强制走路，恢复过 30% 才解除；
- 满体力自动隐藏；创造/旁观模式隐藏；
- TACZ 兼容：持枪消耗按枪械重量（≈品种）放大（手枪 ×1.23 … 机枪/RPG ×2.2+），纯反射无硬依赖；
- Forge 1.20.1 / Java 17+，modid
staminav1.0.1，单人/多人通用。
Stamina System Team
