Commands

Mycel's shared commands, client commands from Better Librarians and ItemHighlighter, and /pets from Better Pets.

The /mycel commands come from the Mycel library, so they work the same no matter which MyCelium mods you have. Viewing commands (help, info, mods, get) work for everyone; changing commands (set, reset, reload) need operator permission (level 2). In singleplayer with cheats enabled everything just works. /vname, /librarians and /hl are the exceptions: they belong to Better Librarians and ItemHighlighter respectively and run on your client, so they need no permissions at all. /pets from Better Pets runs on the server and is open to every player; it only ever touches your own pets.

All /mycel output shares one clean look in this wiki's colors: single replies start with a bold red Mycel › tag, lists tag only their header and indent the rows below, mod names and keys are blue, values are purple, and results carry a green ✔ or red ✘. Errors still show when sendCommandFeedback is off.

CommandWhat it does
/mycel reload instantxp Reloads config/instantxp.json without restarting. Use after editing the file by hand.
/mycel reload autoblockrefiller Reloads config/autoblockrefiller.json without restarting.
/mycel reload betterlibrarians Reloads config/betterlibrarians.json without restarting.
/mycel reload itemhighlighter Reloads config/itemhighlighter.json without restarting.
/mycel reload anvilcostcalculator Reloads config/anvilcostcalculator.json without restarting.
/mycel reload brewingplus Reloads config/brewingplus.json without restarting.
/mycel reload betterserverlist Reloads config/betterserverlist.json without restarting.
/mycel reload morebeaconcolors Reloads config/morebeaconcolors.json without restarting.
/mycel reload bedrockplacing Reloads config/bedrockplacing.json without restarting.
/mycel reload betterpets Reloads config/betterpets.json without restarting.
/mycel help Lists every /mycel subcommand with a one-line summary.
/mycel get instantxp Lists every config value of a mod with its current value, allowed range, and description. Anyone can use it.
/mycel get instantxp radius Shows one value in detail: current value, type, default, and description.
/mycel set instantxp radius 12 Changes a config value live and saves it — no file editing, no restart. Needs operator permission. Rejected out-of-range values tell you what was expected.
/mycel reset instantxp [key] Restores one value (or the whole config, when the key is left out) to its default. Needs operator permission.
/librarians Opens the librarian list: search a book, see who sells it and make them glow (client side). Same as pressing K.
/vname <name> Renames the villager you are looking at (client side). Supports legacy &0–&f colors, &l bold, &o italic, &n underline, &m strikethrough, &k obfuscated, &r reset, && for a literal &, and true RGB as &#RRGGBB, {#RRGGBB}, or &x&R&R&G&G&B&B. Names are clamped to 48 characters.
/vname clear Clears the rename of the villager you are looking at.
/hl #ff55aa Highlights the held item type in that color (client side). Hex (#ff55aa, &#ff55aa) and legacy codes (&a, §a) all work; anything after the color is ignored.
/hl Opens the highlight menu, on the held item if you have one. The H key does the same.
/hl clear Removes the held item's highlight.
/hl list Lists every highlighted item with a color swatch.
/pets Lists your pets with health, distance, direction, and clickable find, call, and name buttons. Works for pets in unloaded chunks too.
/pets menu [pet] Opens the pet book, or a chest menu if your client does not have the mod.
/pets find <pet> Makes the pet glow and shows an arrow with the distance above your hotbar.
/pets call <pet> Teleports a loaded pet next to you (30 second cooldown).
/pets name <pet> <name> Renames the pet, no name tag needed. Colors work with & codes or MiniMessage tags, e.g. <gradient:gold:red>Luna.
/pets give <pet> <player> Makes another online player the pet's owner.
/pets forget <pet> Removes a dead or lost pet from your list.
/betterpets Shows the Better Pets version and every setting with its value. Operators click a value to change it.
/betterpets menu Opens your pet book.
/betterpets settings Opens the pet book on its settings page: your cover colour, and the server's pet rules (operators can change them there).
/betterpets set <setting> <value> Operators: changes a setting, e.g. /betterpets set allowGive false.
/betterpets reset <setting>|all Operators: puts one setting, or all of them, back to the default.
/betterpets reload Operators: reads config/betterpets.json again after you edited it by hand.
/mycel info Shows Mycel diagnostics: versions, platform, and loader info. Handy when reporting a bug.
/mycel mods Lists every mod registered with Mycel and its config state.
/mycel dump Makes a support report: versions, every installed mod, each Mycel mod's config and the end of logs/latest.log. It first lists what will be shared; click [Upload] (or run /mycel dump confirm) to save it to mycel-dumps/ and get a dumps.mycelium-gg.org link to send with a bug report. IP addresses, tokens and your home folder are removed first. Operators (level 2) and the singleplayer host only. Set allowDumpUploads to false in config/mycel.json to only save it locally.

Config keys and values

Keys are the value's key, or category.key when it lives in a category — /mycel get <mod> prints the exact spelling of each one, and tab-completion suggests mod ids, keys, and (for on/off and multi-choice values) valid entries. A bare key works whenever it is unique; otherwise the command names the candidates. Value formats:

Examples

/mycel get instantxp               # show every value with ranges
/mycel get instantxp radius        # show one value in detail
/mycel set instantxp radius 12     # change + save it live (op)
/mycel set instantxp enabled off    # true/false also accepts on/off, yes/no, 1/0
/mycel reset instantxp radius       # restore one default (op)
/mycel reset instantxp              # restore all defaults (op)
/mycel reload instantxp          # pick up a hand-edited radius change
/mycel reload autoblockrefiller  # pick up a hand-edited searchHotbar change
/mycel reload betterlibrarians   # pick up a hand-edited card setting
/mycel reload itemhighlighter    # pick up a hand-edited highlight setting
/mycel reload anvilcostcalculator # pick up a hand-edited button setting
/mycel reload brewingplus         # pick up a hand-edited stand hint setting
/mycel reload bedrockplacing      # pick up a hand-edited repeatTicks change
/mycel reload betterpets          # pick up a hand-edited callCooldownSeconds change
/mycel reload betterserverlist    # pick up a hand-edited replaceScreen change
/mycel reload morebeaconcolors    # pick up a hand-edited allowAnimated change
/vname &aBob the &lBrave         # rename the villager you look at
/vname clear                     # remove that rename
/librarians                      # search your librarians by book
/hl #ff55aa                      # highlight the held item pink
/hl &a                           # highlight the held item green (legacy code)
/hl list                         # show all highlighted items
/pets find Rex                   # make Rex glow and point the way
/pets name 2 "Sir Barks"         # name pet number 2
/mycel mods                       # confirm your mods are registered
/mycel info                       # versions for a bug report
/mycel dump                       # full report with a link to share
Console works too. On a dedicated server you can run these from the server console without the leading slash: mycel reload instantxp.