Cake Tower HUD Plus

Cake Tower HUD Plus is a HUD overhaul + optional server-side combat analytics mod built for the community map Cake Team Towers · Chapter 3.

It turns boss-bar text spam and /trigger ViewStats chat dumps into clean bars, panels, and live team stats — no map edits, no OP, no commands sent on your behalf (v8.4+ server-side install).

> Map-specific by design. On vanilla survival, unrelated servers, or other adventure maps, the entire UI stays hidden automatically. Zero pollution.

Why install

• See your 4 hearts (red / soul / black / blue) stacked on one bar instead of two rows of overflow icons.
• See every boss-bar mob's HP in 3D over its head, with a yellow ▶ marker on the closest target — even when the vanilla boss bar slot is taken by a Champion.
• See the long /trigger ViewStats panel as a clean two-column stats panel with tooltips, instead of spamming chat every few seconds.
• See your whole team's HP / lives / hearts in a draggable left-side roster and through-wall overhead bars.
• Optional damage / kills / assists / 5-second DPS analytics, per-stage and session totals, K-key full table with per-stage breakdown.

All of it works client-only. Installing the same mod on the server unlocks zero-cost server-pushed stats and 4-color teammate hearts.

Features

Status & hearts

• Custom gradient health bar with low-HP flashing (below ~25%).
• All four heart types (red / soul / black / blue) stacked and live-updated.
• Mana, coins, lives, momentum on separate bars (bottom-right).
• Class-aware UI — vampire blood gauge, jelly dash icon, etc.

Team & mobs

• Left roster panel: skin, name, HP bar, lives. Sorted by lives, you're always on top (gold name). Draggable, horizontal or vertical layout.
• 3D overhead HP for teammates (through walls) and every boss-bar mob.
• Closest target auto-marked with a ▶ indicator.
• v8.4+ (server-side mod required) — teammate side-panel, 3D overhead bars, and vanilla nameplates all render the same red/soul/black/blue layered overlay as your own main bar. Falls back to single-color overflow when the server doesn't have this mod.

Mob HP source (v8.3+)

3D overhead mob HP is fed by two complementary paths, picked automatically per-frame:

• Server-authoritative pipeline (preferred) — when this mod is installed on the server, a 4 Hz broadcaster scans a 48-block radius around each player, reads HP / MaxHP directly from the scoreboard, and pushes the closest 32 mobs to that player. Fully bypasses vanilla boss bars — fixes the "Boss champion present → other mobs glitch" bug end-to-end.
• Client-side bossbar approximation (fallback) — on vanilla / datapack-only / older servers, falls back to parsing the vanilla boss bar text, limited by the "one boss bar at a time" vanilla rule.

Player stats source (v8.4+)

The right-side stats panel is fed by two complementary paths:

• Server-authoritative push (preferred, v8.4+) — when this mod runs on the server, a 1 Hz broadcaster reads the scoreboard directly and pushes the full panel (33 standard stats + 4 hearts + size/gravity/speed + skulls + 30+ tag-based status effects like Berserk / Burnt / Dizzy / Cursed) as a custom S2C payload. The /trigger ViewStats chat-capture path is fully bypassed. No more anti-cheat kicks for "too-frequent triggers", no more tellraw storms. Effective cost: ~0.1 ms/s + ~12 KB/s for a 4-player party — ~30× cheaper than the datapack path.
• Legacy /trigger ViewStats chat capture (fallback) — on servers without this mod, periodically (and on big HP changes) sends /trigger ViewStats, intercepts the chat reply, parses the panel. Same behavior as v8.3.x.

Stats & boss bars

• Long ViewStats output → two-column panel with tooltips preserved. Modes: always on / inventory only / hidden.
• Independent toggles for self / party / mob boss bars — compatible with other boss-bar mods.
• Auto refresh on damage / big heals. Your Stats: header spam in chat is swallowed automatically.
• Optional auto TogglePartyBossbar with circuit breaker to avoid rate-limit kicks.

Combat analytics — server side (v6+, ⚠ experimental)

> ⚠ Experimental. Damage attribution, damage panel (L), K-D-A panel (N), per-stage chat report can still misbehave in edge cases. The HUD itself (health bars, stats panel, teammates, mob HP) is stable.

Install on the server (integrated singleplayer also counts).

• 9 damage types tracked per player with attribution (Melee / Bullet / Force / Fire / Water / Ice / Dark / Light / Electric). Handles teammates, summons, DoT carryover sensibly.
• Kills / assists / damage taken, with optional chat broadcasts.
• Live KPI rows on the team panel: damage, taken, kills, assists, rolling 5s DPS.
• Per-stage chat report (v8.3.9+, subscription-based) — opt in per-player via /ctthd broadcast stage_report on (or all on for all 4 channels). Ops can force-broadcast via JSON flag.
• Auto-save: up to 20 past sessions, periodic + on stage change + on shutdown.
• v8 performance: boss-fight TPS back to vanilla territory.
• v8.1+ Magum Trials: per-floor stats inside MT (~30 floors per difficulty), namespace-isolated from main-tower stages so same-id floors don't bucket-collide.

Client-only mode (v7+)

No server mod required. Independently samples DamageShower particles to keep stats alive.

• HUD aggregate row: ⚔ global / ⚔ stage / ☠ global / ☠ stage / ⚡ 5s DPS.
• Per-stage history with client-side stage detection, rest rooms excluded from global totals.
• Kill counter based on ScoreboardHP drop + entity destroy.
• K-key stats table with full session totals + per-stage breakdown + [Clear] with confirm.
• Persistence (v8+): config/ctt-health-display-cdp.json, saved on stage change / disconnect / quit, loaded on startup.
• MT limitation: MT per-floor split needs the server-side mod. In client-only mode MT runs are bucketed as generic MINIGAME.

Config & localization

• ModMenu (recommended): main HUD screen + server-config sub-screen.
• All major panels are draggable.
• English + Simplified Chinese.

Default keybinds

Requirements

• Minecraft 1.21.4
• Fabric Loader ≥ 0.16.9
• Java 21+
• Fabric API
• (optional) Mod Menu — recommended for the config GUI

Server install is optional. Client-only is fully supported since v7 — you keep the HUD, client-side aggregate damage, kill counter, per-stage history, and persistent stats. Install on the server to unlock zero-cost server-pushed stats and 4-color teammate hearts.

Version compatibility

• v8.1.x ↔ v8.0.x: StagePayload wire format changed; both client and server must be on v8.1.x or newer. Mixing with v8.0.x will disconnect on packet decode error. Upgrade in lockstep.
• v8.4.x ↔ v8.3.x: new S2C payloads (PlayerStatsPayload, TeamHeartsPayload) added with explicit version fields and forward-compatible drain. Mixing is safe — old clients ignore unknown payloads and fall back to the legacy chat-capture path. For the full feature set (zero-cost stats panel + 4-color teammate hearts), install v8.4.3+ on both sides.

Safety & compatibility

• No datapack edits, no OP, no arbitrary save writes.
• v8.4+ server install: stats panel is read directly from the scoreboard (read-only) and pushed via custom S2C payloads — no commands are sent on your behalf.
• Without server mod: client falls back to the map's own /trigger flow (read-only, same path vanilla survival uses).
• Auto-hides outside the Cake Team Towers map context — vanilla survival and unrelated servers stay clean.

中文简介

Cake Tower HUD Plus 是为社区图 Cake Team Towers · Chapter 3（蛋糕队塔 第三章） 量身打造的 HUD 美化 mod，可选搭配服务端战斗分析。

• 自绘 4 色血条（红 / 灵魂 / 黑 / 蓝叠加）+ 低血量闪烁；
• 队友左侧栏（头像 / 名字 / HP / 命数，可拖拽 + 横竖切换）+ 队友 3D 头顶穿墙血条；
• 怪物 3D 头顶 HP，最近一只自动标 ▶；v8.3+ 服务端安装彻底修掉 "Boss 冠军占用 bar 时其他怪血条错位"；
• 冗长的 /trigger ViewStats 输出转双列属性面板，v8.4+ 服务端安装彻底取消自发 /trigger 命令（消除反作弊误踢 + 30× datapack 性能优化）；
• ⚠ 实验性服务端战斗分析：9 类伤害归属、击杀 / 助攻 / 承伤、5s 滚动 DPS、每关战绩订阅式广播、最多 20 局历史；
• 纯客户端可用：v7 起独立采集 DamageShower 粒子，HUD / 击杀 / 分关史 / 持久化全保留；
• 非 CTT 环境自动隐藏，不污染原版 / 无关服务器；
• ModMenu 可视化配置 + 中英双语 + 所有主面板可拖拽。

安装需求：MC 1.21.4 · Fabric Loader ≥ 0.16.9 · Java 21+ · Fabric API。服务端安装可选（解锁零成本属性面板 + 队友 4 色心）。

Credits

• Author: Kirin0321 (麒麟)
• Map: Cake Team Towers Chapter 3 by the CTT team
• License: MIT