Commands
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.
| Command | What 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:
- On/off:
true/false(also1/0,yes/no,on/off). - Numbers: must stay inside the shown range, exactly like the config screen enforces.
- Multi-choice: case-insensitive name, e.g.
fastforFAST. - Lists: comma-separated, e.g.
a, b, c; an empty value clears the list.
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
mycel reload instantxp.