Mods are a feature of the full game, not the demo. They open when the full game launches, and details may change before then.

FAQ

The questions people hit most when making mods, using them and playing together, with short answers and where to read more.

If you do not find your answer here, try the matching page: Publishing and updates, Multiplayer, Limits and rules.

Do I need to know how to code?#

No. The in-game mod editor turns a mod into forms: type a name, drag a number, pick a colour, choose from a list, and there is no code to write. If you do not know where to start, press Copy from game and tweak an item or creature the game already has. To change the rules as a whole (enemy health, loot, day length), use the multiplier sliders on the Rules page, or press New rules pack. You can draw an item's look in the editor, or build it in the item editor on the website and paste it in with Paste an item. Scripts are optional, only for people who want them. See the Quick start.

Can I use mods in the demo?#

No. Mods are a feature of the full game and only work in the desktop (Steam) version. The demo and the web version do not have them. The web version says “Mods are only available in the desktop (Steam) version.”

Why can't my friend join my room?#

Most often your mods differ. For “Everyone needs it” mods, the version, content and options must all match, and a single different option counts. Usually when your friend presses join, a “This room uses mods” window appears. They press Download and reload, the game downloads the mods and reloads, and after they pick a character it takes them back into your room.

If they still cannot get in, check these:

  • Is your mod only in your own mods folder, never published to the Workshop? Others cannot download it. Publish it first, or send your friend the folder.
  • If it is published, is it still Private? A first upload is always Private. Change it to Friends Only or Public so your friend can get it.
  • Is your friend's Steam connected? If not, the mods cannot be downloaded.
  • Is your game newer than your friend's? When the host's world is from a newer version, your friend has to update the game first.

The full flow is on the Multiplayer page.

Where is my mod folder?#

The easy way: open Workshop on the title screen, switch to the Make Mods tab, and press Open mods folder. The game opens the folder that holds all your mods in your file browser. If you are inside the mod editor, Open folder in the top bar opens just that one mod's own folder. Each mod is a subfolder, and each subfolder has a mod.json. Where it lives on each operating system, and how the folder is laid out, is in Mod folder and mod.json.

Can mods break my save?#

No. Mod items and pets already in a world are set aside, not deleted, when their mod is missing, and they come back when you turn the mod back on. Mod quests the game does not recognize are hidden for now, and mod buildings do not appear in places you have not visited yet. Mod content is checked on your computer before it is applied, an entry with a problem is skipped, and the game starts as usual. Script mods run in a sandbox and cannot reach your save or the network. See Limits and rules.

The one thing that does not come back is a mod folder you deleted yourself without a backup.

Can I edit someone else's mod?#

The Workshop rules say to only upload assets you have the right to publish, and they forbid copying other people's work. If you want to change someone else's mod, get the author's permission first. Even then, only the Steam account that published a Workshop item can update it. Another account sees “This Workshop item was published by another account, so you cannot update it.” Your changed version would be a separate item of your own.

Why can't I see my teammates' custom looks?#

Settings has a Teammates' custom looks switch. When it is off, teammates are shown with their basic look (race, hair, clothes) and the looks they made or downloaded from the Workshop are not drawn. If a teammate's look is not what they described, check that this switch is on.

Why do my building colours differ from MagicaVoxel?#

Blueprint colours are painted exactly as you write them, with no darkening or ageing by the game. When you import a .vox, a model with more than 62 colours has its least-used colours merged into the nearest ones, which can shift the look slightly. Keep the model to 62 colours or fewer and nothing is merged.

How do updates reach players?#

You press Publish in the editor, raise the version, and press Publish Update (with a one-sentence change note) and subscribers download the new version automatically. Mods are applied only when the game starts, so players get it the next time the game loads. In multiplayer rooms the versions must match, so raise the version on every update (the Big change, New stuff and Small fix buttons in the publish window do the math). See Publishing and updates.

Can I sell mods?#

No. Mods are shared only through the Steam Workshop, and the game has no way to sell them. The Workshop rules also forbid pretending to be official or someone else, and using other people's assets without permission.

The mod list shows a problem or an error. What now?#

Each wording means something different:

What you seeWhat it means and what to do
“N problem(s)”, “Check failed”A mod you are making has something wrong in it. In the mod editor, the bottom bar shows “N problem(s) (click to see)” as you work, and clicking a problem jumps to the entry that has it, with the field named in the form. When you fix it, the check reruns and changes to “No problems, ready to test”. On the Make Mods page, selecting the mod also lists in plain language which file, which entry and which field.
“Problem”, cannot be enabledThe whole mod could not be read. Open the folder and check mod.json and the file formats.
“Not found”A mod that was enabled before cannot be found now. You may have unsubscribed, or its folder was moved. It is skipped when you apply, or you can press Remove from list.
“N part(s) of this mod did not apply last time the game started”The mod loaded, but a few entries had problems and were skipped. The rest works as normal.
“Needs”This mod asks for another mod to be installed first. Without it, some content may be missing.

I enabled a mod but nothing changed#

Mods are applied only when the game starts. For normal play, after you enable or disable something, press Apply and reload. For a mod you are making, press Test in the editor: the game saves, reloads and takes you straight into a test field, with no need to create a world. Press it again after you change something. (Test on the Make Mods page reloads the game and then you create a new world to play.)

Can I switch between the editor and a text editor?#

Yes, and you can keep both open. When you change a mod's files in an outside text editor and save, the mod editor reads the changes in by itself. If both sides changed the same file, a notice appears at the top of the editor, and you choose Use theirs or Keep mine, so nothing is overwritten quietly. Fields that the forms do not have (advanced settings you wrote into the file by hand) are kept exactly as they were when the editor saves. See the mod editor page.

Why didn't my achievement unlock?#

A world created with mods that change numbers or content is a modded world, and Steam achievements do not unlock in it. A player who joins a modded room is in the same situation while in that room. This is by design, not a bug. The game warns you when you create such a world.

I published, but nobody can find it#

A first upload is always Private, so only you can see it. When you have checked that it works, use an update to change the visibility to Public. Unlisted items do not show up in searches or lists either. Once public, players can find it in the Explore tab of the Workshop in the game, using the Mods category or a name search. See Publishing and updates.