3 minute install · Fabric · MC 1.21.11

Install Auto Secret Routes

If you've installed a Fabric mod before, you can skip to step 3. If you haven't — start at the top. The whole thing is three minutes if your launcher is open.

Step by step

Four steps, no terminal required

  1. Install Fabric Loader 0.16+ for Minecraft 1.21.11

    Head to fabricmc.net/use and download the Windows / macOS / Linux installer. Run it, set Minecraft Version to 1.21.11, leave the Loader on latest, then click Install.

    If you're using Modrinth App, Prism or ATLauncher, skip this — just create a new Fabric 1.21.11 instance from inside the launcher.

  2. Drop Fabric API into your mods folder

    Open %appdata%\.minecraft\mods (Windows) or ~/Library/Application Support/minecraft/mods (macOS) and drag in the latest Fabric API for 1.21.11 from Modrinth.

    If the mods/ folder doesn't exist yet, create it.

  3. Add AutoSecretRoutes-1.4.7.jar

    Grab the latest from /download/ (or directly from Modrinth/CurseForge inside your launcher), and drop it into the same mods/ folder. Don't extract it.

    Verify the SHA-256 if you downloaded it from an unfamiliar mirror — the checksum is on the download page.

  4. Launch Fabric Loader 1.21.11 and join Hypixel

    In the official launcher, select the new profile labelled fabric-loader-1.21.11 and click Play. Once in the main menu, connect to mc.hypixel.net.

    Auto Secret Routes activates the moment SkyBlock starts loading. Open the config GUI any time with /asr.

If something goes wrong

Troubleshooting

Game crashes immediately after the Mojang logo

Almost always a Fabric API mismatch. Check that your Fabric API jar matches Minecraft 1.21.11 (it's in the filename — look for fabric-api-0.111.x+1.21.11 or similar). The crash log lives at .minecraft/crash-reports/; the relevant line starts with java.lang.LinkageError.

Black screen / world doesn't load on Hypixel

Sodium 0.6+ ships with the change that breaks older Iris versions. If you run shaders, update both Sodium and Iris to the 1.21.11 builds. Disable shaders first as a control test.

Overlay isn't showing

  1. Make sure you're actually on mc.hypixel.net and on SkyBlock (not Bedwars/Skywars).
  2. Open /asr and check that HUD enabled is on.
  3. If you bind another mod (like ModMenu) to F12, your config keys may be intercepted — rebind in /asr keybinds.

"Mod conflict detected" warning

ASR talks to other community mods via a shared HUD layer. If you have Skyblocker, NEU or Patcher running, the warning is informational — nothing's broken, but you may see duplicate overlays. Toggle the relevant module off in /asr.

Still stuck?

Open an issue on GitHub with your latest.log and crash report. Most issues are resolved inside 24 hours.

You're in. Now tune it.

The default settings work, but most players tweak HUD scale and overlay opacity on day one.

Best settings →