A Minecraft 1.8.9 Forge mod that replaces the default player list overlay (Tab list) with custom columns containing real-time player statistics retrieved from the Hypixel API.
- Custom Tab Columns: Replaces vanilla tab rendering with a configurable, multi-column statistics layout.
- Automatic Game Mode Detection: Reads scoreboard locraw data to detect the active game mode and switch formatting profiles. Supported modes:
- Bedwars: Stars, Winstreak, BBLR, WLR, K/D, final kills/deaths, and FKDR.
- SkyWars: Level, total kills, deaths, K/D, and wins.
- Mega Walls: Level, wins, total kills, final kills/assists, and FKDR.
- Duels: Wins, active winstreak, and K/D.
- Dynamic Stats Colorizing: Colorizes player statistics dynamically based on performance ranges (e.g., FKDR and winstreaks).
- Asynchronous Fetching & Cache:
- API requests run on background threads to prevent client-side FPS drops or stutter.
- Local caching prevents rate-limiting and updates player statistics progressively in the background without clearing the UI.
- OneConfig Support: Full configuration menu built on OneConfig.
Open the OneConfig settings in-game (usually Right-Shift or /oneconfig) and navigate to HypixelOverlay:
| Option | Type | Default | Description |
|---|---|---|---|
| Enable Overlay | Switch | true |
Toggles the custom Tab list overlay. |
| Hypixel API Key | Text | empty | Your Hypixel API key (obtainable via /api new in-game). |
| Auto Refresh Interval | Slider | 60 |
Background update interval in seconds (30s - 300s). |
| Overlay Scale | Slider | 1.0 |
Custom scaling for the tab overlay (0.5x - 2.0x). |
| Bedwars Format | Text | lv_|star_|rank|name|ws_|fkdr_|fk_|health_ |
Columns format for Bedwars. |
| SkyWars Format | Text | lv_|swstar_|rank|name|swkd_|swk_|health_ |
Columns format for SkyWars. |
| Mega Walls Format | Text | lv_|rank|name|mwfkdr_|mwfkc_|health_ |
Columns format for Mega Walls. |
| Duels Format | Text | lv_|rank|name|duelkd_|health_ |
Columns format for Duels. |
Formatting syntax:
- Columns are separated by the pipe character
|.- Suffixing a placeholder with an underscore
_(e.g.,fkdr_) aligns that column to the right.
src/main/java/dev/mxmblee/hypixeloverlay/
├── HypixelOverlay.java # Main mod entry, event hooks & rendering setup
├── config/
│ └── OverlayConfig.java # OneConfig options and definitions
├── gui/
│ ├── TabListOverlay.java # Custom Tab list rendering implementation
│ └── PlayerStats.java # Data holder and performance color ranges
└── util/
├── StatsManager.java # Async API fetcher, parsing, caching & updates
├── ScoreboardUtil.java # Scoreboard and Locraw game mode parser
└── TabFormatter.java # Column layout calculations and alignment
Build the mod using Gradle:
# Windows
.\gradlew.bat build
# Linux / macOS
./gradlew buildThe output JAR will be saved to:
versions/1.8.9-forge/build/libs/HypixelOverlay-1.8.9-forge.jar