Hades

A client-side dungeon map for Hypixel SkyBlock Catacombs — a modern Fabric remake of UnclaimedBloom6's IllegalMap (originally a 1.8.9 ChatTriggers module). Hades is not affiliated with the original author; all credit for the original design goes to UnclaimedBloom6.

GitHub: https://github.com/noname-mods/Hades

Requires PlayerAPI 1.19.0+ and YetAnotherConfigLib to run. ModMenu is optional — it adds a settings button to the mod list.

Features

Dungeon Map

The full Catacombs layout as a movable HUD overlay — rooms, doors, room names, and secret counts, drawn as you explore. Rooms are recognised from their block layout, so names and secret counts appear automatically for rooms in the database. Move and scale the map (and the score panel) with the HUD editor.

Checkmarks & Secrets

Each room shows Hypixel's own checkmark once cleared — green (all secrets found), white (cleared, star drop only), or red (failed) — read directly from the dungeon map item, so it reflects the whole party, not just what you've personally visited. The checkmark replaces the room name once cleared; uncleared rooms keep their name for planning.

Dungeon Score

A live score panel using an exact port of Hypixel's real Catacombs score formula — the same number Skyblocker shows, category-for-category (Skill / Explore / Speed / Bonus). An optional line-by-line breakdown shows each category so you can see what to push. The score keeps updating through the boss fight — dying or going over the time limit in the boss still lowers it — and locks when the run ends. A Mayor Paul (+10) toggle is included for when the EZPZ perk is active.

Score Milestones, Secrets-Done & Titles

Client-side alerts when you reach 270 and 300 score, and when your secrets reach the amount needed for full secret score. Each can also pop an on-screen title (off by default) and/or announce in party chat. The title duration is adjustable, and a precise-time (millisecond) option is available for speedrunners.

Star-Mob ESP + Radar

Through-wall boxes around starred mobs and minibosses (with distinct miniboss colours), coloured dots on the map (the radar), and an optional line to the nearest star mob. All opt-in.

Wither / Blood-Door ESP

Through-wall boxes on the next wither/blood doors along the route to the Blood room, so you can path ahead. Configurable how many doors ahead to show; hides once they're open.

Mimic Detection (Floor 6+)

Finds the Mimic by comparing trapped-chest counts against the room database, tints its room red on the map, and optionally highlights the Mimic chest through walls so you can go break it. Alerts on the kill (+2 score), with optional title and party-chat announce.

Party-Player Markers

Your teammates appear on the map as their skin-face heads — even when they're out of render distance — because Hypixel plots the whole party on the Magical Map. Names come from the dungeon tab list.

Room Database & Community Mapping

Hades identifies rooms from their block layout. Most rooms are recognised automatically. When you enter a room Hades has never seen, it posts a clickable prompt so you can help map it — the room is added to your local database (which survives mod/repo updates) and you can optionally submit it to the repo so everyone benefits. The database also auto-updates from the repo once per launch, so new room data reaches you without waiting for a mod release. No account, username, or personal data is ever included — only the room's block layout.

Join Aliases (optional, off by default)

Short shortcuts for /joininstance: /ce, /c1–/c7 (Catacombs floors), /m1–/m7 (Master), /k1–/k5 (Kuudra tiers). Off by default — enable them in the config (takes effect on your next world join).

Fully Configurable

Every feature has a toggle in the YACL config screen (open with /hades or the ModMenu button). The map and score panels are positioned with the shared HUD editor — drag to move, scroll to scale.

Controls

• /hades — open the config screen.
• Edit HUD — move/scale the map + score panels (config screen → Edit HUD, or /hades hudeditor).
• Community mapping is entirely prompt/GUI-driven — no commands to memorise.

Installation

1. Install Fabric Loader for Minecraft 26.1.2
2. Install Fabric API
3. Install PlayerAPI
4. Install YetAnotherConfigLib
5. Install ModMenu (optional)
6. Drop hades-*.jar into your mods folder

Compatibility

Minecraft Version Support

This mod targets one Minecraft version at a time. When it updates to a new Minecraft version, previous versions receive zero further support — no backports, no bug fixes, and a release is never published with support for multiple Minecraft versions at once.

• Want the newest features? You must be on the mod's currently supported Minecraft version.
• Want to stay on an older Minecraft version? Stay on that version's last release — it won't be updated.

The in-game update checker is Minecraft-version aware: if the latest release targets a different Minecraft version than you're running, it tells you so instead of prompting you to install an incompatible build.

Contributions

Room data is a community effort. If you're the first to submit the block data (cores) for a room that wasn't in the database yet, you can get a shout-out here — pick any handle you like when you submit (it does not have to be your Minecraft or real name, and it shouldn't be). Just include your chosen name in the submission and we'll credit you below when the room is merged.

Room contributors

Be the first!

Credits

• Original IllegalMap design by UnclaimedBloom6. Hades is an independent remake and is not affiliated with the original author.

For Developers

Hades — Design & Documentation

Version: 1.0.0 (config schema v19) Platform: Fabric 26.1.2, Java 21 Dependencies: PlayerAPI 1.19.0, Fabric API, YACL v3, ModMenu (optional) Mod ID: hades Entry point: com.hades.HadesMod Config file: <game_dir>/config/hades/config.json

The full design & documentation is maintained in HADES_DOCS.md. A summary of the internals:

• DungeonManager is the spine — it decides whether you're in a dungeon, what run phase you're in (read from the 9th hotbar slot: Magical Map → exploring, SkyBlock Menu → boss, Your Score Summary → won), drives the world scanner, and owns the DungeonMap. During the boss the scanner/ESP/mimic shut off; only the score timer + deaths keep going.
• DungeonScanner / RoomFingerprint / RoomDatabase detect rooms from roof heights + the y=69 door block, then identify them by a modern block fingerprint (with the original 1.8.9 legacy cores as a fallback). Learned fingerprints and locally-mapped rooms persist across sessions, and the bundled rooms.json is refreshed from the repo once per launch (ETag-conditional).
• CheckmarkReader reads checkmarks from the vanilla map item's colour array, anchoring the grid to the world via the player's map decoration (held for the run) and sampling each room's top-left cell.
• ScoreCalculator (pure) + DungeonRunState port Skyblocker's DungeonScore exactly: inputs come from the tab list (rooms/secrets/puzzles/crypts/deaths), the sidebar (floor/cleared %/time-recovery), chat (Mort start, kills), and the map item (run-end); the score computes live through the boss and the clock stops at the end.
• MapRenderer / ScoreRenderer are the two HUD elements (owner "hades") drawn through PlayerAPI's shared HUD editor. StarMobTracker / WitherDoorEsp / MimicManager are the ESP + Mimic layers.
• RoomIdScreen / RoomSubmit / AutoIdentifyPrompt drive the GUI-only community-mapping flow.

See HADES_DOCS.md for the full section-by-section reference (coordinate model, scanning, identification, checkmarks, rendering, score, phase detection, each ESP layer, community mapping, the room-database auto-update, configuration, commands, and event wiring).