Skyblock Hades

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	Fabric Loader	Java
26.1.2	≥ 0.19.2	21

---

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).