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".
| Slider | What it does |
|---|---|
| Enemy health | Higher means tougher enemies |
| Enemy damage | How much a hit takes off you |
| Attack warning | Wind-up before enemies strike. Higher is easier to dodge |
| Elite frequency | How often stronger elite enemies show up |
| Loot | What you get from enemies and chests |
| Experience | How fast you level up |
| Day length | Higher means longer days and later nights |
| Party boss health | Extra 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:
{
"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.
- 1Build the look on the website
Open the item editor and sculpt your creation. The editor on the website is in Chinese.
- 2Copy 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.
- 3Paste 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".
- 4Set 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.
- 5Add 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#
| What | Limit |
|---|---|
| Size | At most 64 wide and deep, 48 tall (64 x 48 x 64) |
| Blocks | At most 20,000 |
| File size | At most 2 MB |
| Models | If the file holds several models, only the first is used |
| Colours | At 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 own | If 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:
| Setting | What it does |
|---|---|
| Where it appears | Pick 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 apart | Four choices: 200, 300, 500, 800. A bigger number means fewer of them in the world |
| At least this far from villages | Four 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.