Troubleshooting
Eight out of ten install issues come down to three things: wrong Minecraft version, missing Fabric API, or OptiFine in the mods folder. Start here.
The HUD doesn't appear
- Confirm you're launching the Fabric 1.21 profile, not vanilla 1.21.
- Confirm Fabric API is in the mods folder next to DrAyriAddons.
- Press Right Shift — if the config menu opens, the mod is loaded and the HUD just needs to be re-enabled in the menu.
- If Right Shift does nothing, check the launcher log for "DrAyriAddons loaded". If it's not there, the jar isn't being picked up.
Minecraft crashes immediately on launch
Open .minecraft/logs/latest.log, search for "FabricLoader" or "Mod resolution exception".
- Missing Fabric API — install it from Modrinth or CurseForge.
- OptiFine in the mods folder — remove it. OptiFine is not Fabric-compatible. Use Sodium + Iris.
- Wrong Minecraft version — DrAyriAddons 1.1.x requires Minecraft 1.21 exactly.
- Java version too old — Minecraft 1.21 needs Java 21. The launcher usually handles this, but custom Java installs can break it.
EasyPlace places the wrong block
EasyPlace pulls blocks from your hotbar. If the correct material isn't on the bar, the mod falls back to the closest match. Either move the right block into a hotbar slot, or enable Inventory Rotation in the EasyPlace config — that lets the mod auto-swap from your full inventory.
BaseFinder is spamming false positives
Open the BaseFinder config and raise the Pattern Threshold. The default is tuned for overworld; underground stripmines often surface natural ore clusters that resemble player patterns at low thresholds.
ElytraBoost feels uncontrollable
Lower the speed cap in the ElytraBoost config from 5× to 3×, learn the controls, then ramp up. The release-on-low-velocity safety can also be toggled off — but we don't recommend that unless you have a clear flight path.
Auto Totem isn't swapping
- Make sure totems are in your inventory somewhere. Auto Totem doesn't conjure them.
- Check the configured backup slot in the module config — it defaults to slot 35, the bottom-right inventory cell.
- Ensure no other mod is also moving items off your off-hand (some PvP clients do this).
Performance dropped after installing
DrAyriAddons itself is GPU-light, so a sudden FPS drop is usually caused by something else in the same install:
- Iris shaders set too high — try a lighter shader pack.
- Sodium not installed — vanilla 1.21 chunk rendering is slow even without mods.
- Render distance set higher than your old setup allowed.
See the performance page for a recommended Fabric stack.
Still stuck?
Re-check the install guide top to bottom — most issues are install-order mistakes. After that, see the FAQ for compatibility questions.