Troubleshooting
A mod does nothing at all
Work through this list top to bottom:
- Is Mycel installed? Every MyCelium mod needs the Mycel jar in the same
modsfolder. Without it the game usually refuses to start, but double-check all jars are there and for the right loader. - Is the mod enabled? Check its config file (
config/<mod id>.json, e.g.config/instantxp.jsonorconfig/brewingplus.json) and make sureenabledistrue. - Are the conditions right? InstantXP only collects orbs inside its
radiusand never for spectators. AutoBlockRefiller only refills blocks into slots that are actually empty, from the main inventory (or hotbar withsearchHotbar). Better Librarians only shows cards for librarians you have traded with, while no screen is open. ItemHighlighter only highlights the held item's type (or exact stack withmatchComponents), and only where its own toggles allow. Check the mod's features page if the behavior surprises you. - Is another mod interfering? Try with only Mycel and the one mod installed to confirm.
Game crashes on startup
- Check the versions. MyCelium mods need Minecraft 26.3, 26.2 or 26.1 with the jar built for that version (its file name says which), Java 25, the latest Mycel (currently 1.6.1), and a matching loader (see the loader versions). A wrong Minecraft or Java version is the most common cause.
- Check the loader. A Fabric jar on Forge (or any mix-up) will not load. The file names tell you which is which.
- Read the crash report. It names the failing mod near the top. If it points at a MyCelium mod or Mycel, include it when asking for help.
Config changes do nothing
Editing a config file while the game runs does nothing until you reload it (/mycel reload <mod id>, e.g. /mycel reload brewingplus; see commands) or restart. Also check you edited the right file: singleplayer and each server have their own config folder, and Better Librarians, ItemHighlighter, Anvil Cost Calculator, and Brewing+ settings live on your client, never on the server. A mangled file falls back to defaults with a warning in the log; delete it and restart for a fresh one.
It only half works on a server
Each mod runs on one side, so where you install it matters:
| Install | Mods |
|---|---|
| In your own game | Better Librarians, ItemHighlighter, Anvil Cost Calculator, Brewing+, Better Server List, Dark Mode. The server needs nothing. |
| On the server | InstantXP, AutoBlockRefiller, Essentials GG. Players need nothing. In singleplayer, install them in your own game. |
| On both | BedrockPlacing, Better Pets, More Beacon Colors, Colored Nether Portals. Vanilla players can still join. |
On the "both" mods, players without the mod get the plain version: a chest menu instead of the Better Pets screen, normal placing instead of BedrockPlacing, and vanilla beams and portals.
A button, key or menu does not open
- Better Librarians: press K or run
/librarians. If another mod uses K, rebind it under Controls, in the Gameplay group. - ItemHighlighter: press H while hovering an item in an inventory, or run
/hl. If another mod uses H, rebind it under Controls, in the Inventory group. - Better Pets: shift-right-click a pet you own, or run
/pets menu. The custom screen needs the mod on your client too. - Brewing+ and Anvil Cost Calculator: the button sits on the brewing stand and anvil screens. Check that
showButtonistruein the mod's config. - Colored Nether Portals: sneak and right-click the portal with an empty hand.
Other players do not see my colors
ItemHighlighter is private: nobody else ever sees your highlights. More Beacon Colors and Colored Nether Portals are shared only when the server has the mod and the other player has it too. On a server without the mod, your colors stay on your computer.
Unknown command, or no permission
/mycel reload and /mycel set need operator permission (level 2) on a server; viewing commands do not. See commands.
Still stuck?
Run /mycel dump and click [Upload]. You get a dumps.mycelium-gg.org link with your versions, mods, config and log in one place; send it with your issue. It needs op (level 2) on a server, or being the host in singleplayer. If you cannot run commands, gather these three things by hand and open an issue on the mod's GitHub page (InstantXP, AutoBlockRefiller, Better Librarians):
- The output of
/mycel info(versions and platform). - Your mod's config file.
- The log or crash report from
logs/latest.log.