Open-source ยท Fabric ยท Minecraft 1.21.x

Firmament

The Hypixel SkyBlock mod that rewrites the NEU playbook for modern Minecraft. Browse every item, view every recipe, edit every HUD, lock every slot - all from inside the game.

  • 1.39M+ downloads
  • GPL-3.0 free & open-source
  • Client-side only
  • Kotlin ยท 84.6%
1.39M+downloads on Modrinth
60releases shipped
1.20 โ†’ 1.21.11versions supported
100%open-source ยท GPL-3.0
What's inside

Every SkyBlock quality-of-life tool you actually use.

Firmament is built feature-by-feature from the community up. Flip any of these on from /firm config - everything is modular, everything is free.

๐Ÿ“š

Item browser for every SkyBlock item

Core

A complete catalog of every SkyBlock item with stats, reforge rolls, crafting recipes, NPC sell prices and smart grouping - fed by the open NEU item repository.

  • Search by name, lore, or ID
  • Group related drops automatically
  • Custom texture packs load straight from your repo
๐Ÿงช

Recipe & forge viewers

Click any item to see its crafting or forge recipe, with ingredient breakdowns and the exact slot layout.

๐Ÿงญ

Crafting guidance

Move-item & slot-highlight overlays step you through a recipe so you stop misplacing ingredients mid-hypixel-lag.

โœจ

Fairy soul finder

Fan favorite

Undiscovered fairy souls glow through walls with waypoint pings. Finish Hub, the Barn and Mushroom Desert in an afternoon.

๐ŸŽ›๏ธ

HUD editor (Jarvis)

Drag-and-drop every overlay element. Snap-lines, per-element opacity, and a one-key toggle to compare layouts.

๐Ÿ”’

Slot locking

Pin your talismans, pet item and stashed wardrobe. Click-to-drop and right-click-drop simply stop working on locked slots.

๐Ÿ—‚๏ธ

Storage overview

See every storage page, ender chest and backpack at a glance - plus an interactive overlay for bulk moves.

๐ŸŽฃ

Fishing particle helper

Surfaces the correct particle effect around your bobber so you never miss a hook in a laggy pond.

๐Ÿ“

NPC waypoints

Auto-pathing markers to every vendor, merchant and NPC you might be looking for. Turn them on only where you need them.

๐Ÿ–ผ๏ธ

Chat image preview

Hover an imgur or i.redd link in chat and see the image inline. No more alt-tabbing out of a duel.

๐Ÿงต

Cursor-position memory

Your mouse returns exactly where you left it across menus. Tiny feature, enormous quality-of-life.

โš™๏ธ

Configurable from inside the game

/jarvis options

Every toggle, color, keybind and threshold lives behind /firm config. Need something fast? /jarvis options "your search" fuzzy-matches across every setting in the mod.

Installing the mod

Five minutes from zero to SkyBlock.

# installing-firmament | Works on Minecraft 1.20.x โ€“ 1.21.11 with Fabric
1
Step one

Install Fabric Loader for your Minecraft version. In the installer, pick the Minecraft version you play (e.g. 1.21.11) and check Create profile.

2
Step two

Drop these two jars into your .minecraft/mods folder:

dependencies
# required
Fabric API              # modrinth.com/mod/fabric-api
Fabric Language Kotlin  # modrinth.com/mod/fabric-language-kotlin

# optional (enables full item browser)
RoughlyEnoughItems (REI)
Architectury API
Cloth Config
3
Step three

Grab the firmament-*.jar that matches your Minecraft version and drop it into the same mods folder. Launch Minecraft with the Fabric profile.

.minecraft/mods/
fabric-api-0.x-1.21.11.jar
fabric-language-kotlin-1.x-1.21.11.jar
firmament-44.0.1+mc1.21.11.jar
4
Step four

Join hypixel.net, warp to SkyBlock, and run:

in-game chat
/firm config

Tip: everything is searchable with /jarvis options <query>.

Reference

Commands & keybinds.

The entire mod is pilotable from chat. Nothing is locked behind a keyboard shortcut you can't rebind.

/firm config

Opens the in-game settings GUI - all features, colors and keybinds.

/jarvis options "<query>"

Fuzzy-search every option in the mod. Jumps straight to the matching toggle.

/firm repo update

Force-refresh the NEU item repository used for recipes & prices.

/firm hud

Opens the drag-and-drop HUD editor with live preview & snap-lines.

/firm storage

Opens the storage overview (all pages, ender chest and backpacks).

/firm debug

Diagnostics dump - use this when filing a GitHub issue.

System requirements

Where it runs.

ComponentMinimumRecommended
Minecraft1.20.1 (legacy branch)1.21.11 Java Edition
LoaderFabric Loader 0.15+Fabric Loader 0.16+
JavaJava 17Java 21 (required for 1.21+)
Fabric APImatching MC versionlatest stable
Fabric Language Kotlinmatching MC versionlatest stable
REI + Architectury + Clothoptionalrecommended (full item browser)
RAM allocation3 GB4 โ€“ 6 GB
ServerHypixel / hypixel.netSkyBlock profile active
Under the hood

Powered by an open item database.

Item stats, recipes and prices come from the community-maintained NotEnoughUpdates repository. Firmament fetches it on-demand - so the day a new SkyBlock item drops, it's already searchable.

FAQ

Stuff we get asked every day.

Is Firmament free?

Yes. 100% free, 100% open-source under the GPL-3.0 license. There is no paid tier, no telemetry, and no ads. If someone is selling it to you, they're scamming you.

Does it work on Forge?

No - Firmament is a Fabric mod. You'll need Fabric Loader, Fabric API and Fabric Language Kotlin. A Forge port is not on the roadmap.

Which Minecraft versions are supported?

The actively developed branch targets 1.21.x (currently up to 1.21.11). Legacy builds exist for 1.20.x if you're stuck there. Every release is tagged on Modrinth with the exact MC version it's for.

Will I get banned on Hypixel?

No. Firmament only uses information already visible to you (tooltips, chat, the SkyBlock scoreboard) and does not automate gameplay. It falls under the same policy Hypixel uses for NEU / SkyHanni / SkyBlocker.

How is it different from NEU?

Same spiritual lineage - fresh codebase. Firmament is written in Kotlin for modern Minecraft, ships its own configuration system (Jarvis), a modular HUD editor, and uses the NEU item repository directly so data stays in sync with the rest of the SkyBlock mod ecosystem.

It crashes / recipes don't load. What do I do?

Nine times out of ten: your Fabric API or Fabric Language Kotlin version is too old for the MC version you're on. Update those first. Still broken? Run /firm debug and drop the output on the Discord #support channel or open a GitHub issue.

Can I contribute?

Please do. The repo has a detailed CONTRIBUTING.md. Issues tagged good-first-issue are a great starting point, and PRs for translations, HUD widgets and item-repo fixes are always welcome.

Community

Come hang out in the server.

The dev, contributors and a few thousand SkyBlockers live in the Discord. Feature ideas ship faster than anywhere else, and the #changelog feed is the fastest way to know what's new.

Join the Discord 2,417 online