RPG Tab Overlay

🤖 Honest Disclaimer

I want to be upfront: this project was entirely vibe-coded (written with the help of AI). I needed a mod like this for my own modpack and couldn't find one, so I made it and decided to share it in case it helps someone else.

I'm not a professional mod developer, so expect rough edges. It works for my use case, but I can't promise perfect support or polish. Bug reports and contributions are welcome, and feel free to use it, fork it, or improve it!

🛡️ RPG Tab Overlay (NeoForge 1.21.1)

A clean, highly customizable medieval/fantasy RPG player list (TAB menu) replacement for Minecraft NeoForge 1.21.1.

Transform your standard multiplayer player list into an immersive adventurer roster with live player stats, dynamic health gauges, client FPS (with frame generation support), and real-time server hardware performance monitoring.

✨ Features

👑 Player Roster & Stats

• Fantasy RPG Design: Dark translucent backdrop framed with double gold/bronze borders and ornate corner accents.
• Top-Priority HUD Layer: Automatically suppresses conflicting HUD layers (like PartyHUD or RPG-HUD) while TAB is held for optimal readability.
• Player Avatar: Dynamic head render of player skins.
• FTB Teams Support: Displays party team names in italics directly below player usernames (MyTeam) only when the player belongs to a team.
• Player Dimension: Displays current dimension (✦ Dim: Overworld, Nether, The End, or modded dimensions).
• Dynamic Health Bar: Visual fill bar with exact numerical HP centered inside (e.g. 20/20) with smooth green > orange > red color progression.
• Food & Hunger: Precise hunger points (20/20).
• Experience Level: Formatted level (Lvl X).
• Deaths Counter: Official vanilla death statistic tracking (Dead X).
• FTB Quests: Total completed quests per player or team.
• Advancements: Unlocked achievements count (crafting recipes excluded).
• Playtime & Ping: Total server playtime (e.g. 1h 23m) and color-coded network latency in ms.

⚡ Performance & Hardware Metrics (Footer)

• Client FPS (GGTU Frame Gen Compatible): Live FPS counter in the top-right corner, displaying native rendering frames and generated/interpolated frames from NeoForge GGTU (Resolution Scaler) (e.g. 136 FPS (68 + 68 gen)).
• Server Performance Footer Bar:
  • Line 1 (Hardware & Network):
  • TPS & MSPT: Instantaneous tick performance (☼ TPS: 20.0 (15.4ms)).
  • CPU Quota: Process CPU usage normalized against container allocated cores (🖥 CPU: 614% / 600%).
  • GPU Load: Real-time GPU load percentage (⚡ GPU: 92%).
  • RAM & Swap: Container cgroup RAM & Swap usage (💾 RAM: 7.5 Go/16.8 Go, swap displayed only when active).
  • Network Traffic: Real-time cumulative data transfer (🌐 Net: ↓ 35.0 MiB ↑ 48.6 MiB).
  • Uptime: Server uptime since last reboot (⏱ Up: 8m).
  • Line 2 (World Generation & Engines):
  • Loaded Chunks: Total active world chunks on the server (☵ 543 loaded).
  • Distant Horizons: Real-time LOD chunk generation queue tracking (🌌 DH: 53 gen).
  • C2ME OpenCL: GPU chunk acceleration module status (✔ C2ME OpenCL: Actif).

🧩 Built-in Ecosystem Compatibility

Designed with safe, soft-reflection integrations — no hard dependencies and zero crashes if any mod is absent:

⚙️ Server Configuration (config/rpgtab-server.toml)

Every single column, metric, color, and title can be toggled and customized to fit your server's style. Includes an optional [pelican_api] section to query your hosting panel directly.