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

In-game tools

The three quick tools on the Make Mods page: rules pack sliders, pasting an item from the website, and importing a MagicaVoxel .vox building. The main tool for making mods is the mod editor.

The main tool for making mods is the mod editor. This page covers three other quick tools. On the title screen open Workshop, go to the Make Mods tab, and pick one of your mods under My creations on the left. Three tool buttons appear on the right: Rules pack, Paste an item and Import a building. They write the content into your mod folder for you, so you never have to open a file.

Rules pack: tune multipliers with sliders#

A rules pack does not add anything. It changes the difficulty and pace of the game. New rules pack opens the New mod window with the Rules pack template already picked; after you name it and press Create, you stay on the Make Mods page so you can tune the sliders right away. You can also press the Rules pack button inside any mod of yours. The Rules tab in the mod editor has the same sliders, plus an advanced section for tuning more things separately for each difficulty.

There are 8 sliders, and each one is a multiplier: 1 is the original game, and the range runs from 0.25x to 4x. The sliders use a log scale, so "half" and "double" sit the same distance from the middle, which makes them easier to control. At the original value the label on the right reads "Default".

SliderWhat it does
Enemy healthHigher means tougher enemies
Enemy damageHow much a hit takes off you
Attack warningWind-up before enemies strike. Higher is easier to dodge
Elite frequencyHow often stronger elite enemies show up
LootWhat you get from enemies and chests
ExperienceHow fast you level up
Day lengthHigher means longer days and later nights
Party boss healthExtra boss health when several players fight together

When you are happy, press Save and you will see "Saved". Reset all to default puts every slider back to 1. If the mod has no rules pack yet, saving adds one. Other settings you wrote by hand in the file (such as the advanced difficulty) are kept as they are.

The saved file is a small, flat object, with 1 for anything you did not change. You can still edit it by hand later:

data/rules.json
{
  "enemyHealth": 1.5,
  "enemyDamage": 1,
  "telegraph": 1,
  "eliteRate": 1,
  "loot": 2,
  "xp": 1,
  "dayLength": 1.5,
  "partyBossHp": 1
}

Paste an item: turn a website design into an item#

Our website has an item editor where you sculpt a weapon, prop or piece of furniture out of blocks. It checks your work as you go, so you cannot make something oversized. When you are done you can drop it straight into a mod.

  1. 1
    Build the look on the website

    Open the item editor and sculpt your creation. The editor on the website is in Chinese.

  2. 2
    Copy the item

    Press the Import / Export button (匯入 / 匯出) in the editor, and in the export area press Copy item (複製道具). Creations saved in your list have an Export item (匯出道具) action on their card too. Either one copies a block of text to your clipboard.

  3. 3
    Paste it into the game

    Back in the game's Make Mods tab, pick the mod to put it in, press Paste an item, and paste the whole text into the box. When it works you will see "Read N blocks".

  4. 4
    Set name and numbers

    Fill in Item name, choose the Kind (weapon, shield, bow, staff, gun, helmet, chestplate, leggings, boots, material or consumable) and the Rarity, then fill in Attack, Armor or Bonus health depending on the kind.

  5. 5
    Add it to the mod

    Press Add to this mod. When it says "Added. Reload to see it" you are done. Press Test to reload and find the item in the game.

The game saves the look as a file under models/ in your mod folder and adds one item to data/items.json. Limits: an item can have at most 4000 blocks. Blocks that are out of range or duplicated are skipped, and you are told how many. If a number is out of a sensible range, loading the mod tells you instead of quietly changing it.

Import a building: a .vox file placed in the world#

Build a building in the free MagicaVoxel (saved as a .vox file) and you can place it in the world for players to run into while exploring. Press Import a building, then Choose a .vox file.

File limits#

WhatLimit
SizeAt most 64 wide and deep, 48 tall (64 x 48 x 64)
BlocksAt most 20,000
File sizeAt most 2 MB
ModelsIf the file holds several models, only the first is used
ColoursAt most 62. If there are more, the game merges similar ones and tells you "It used N colours, which is too many. Similar ones were merged into M"
No colours of its ownIf the file has no palette, the default palette is used

After it is read you see the size and block count, plus a picture of the view from above. If something is wrong you get a plain message such as "The building is too big", "Too many blocks" or "This is not a .vox file". Fix it in MagicaVoxel, save again and choose the file once more.

Placement settings#

Once it is read, fill in Building name, choose which mod to add it to, then decide where it appears:

SettingWhat it does
Where it appearsPick any of: Grassland, Forest, Desert, Red rock, Snowfield, At sea. Allow in water lets it be placed in water too
How common (slider)From Common through Sometimes to Rare. The more common, the sooner you run into one
At least this many blocks apartFour choices: 200, 300, 500, 800. A bigger number means fewer of them in the world
At least this far from villagesFour choices: 60, 120, 250, 400. Keeps it from being built right next to a village

Press Add to this mod; on success it shows "Added". After you reload (press Test) and create a new world, you can find it out in the wild. MagicaVoxel has its z axis pointing up and the game uses y as up, and the game converts it for you.