Diabotical Map Editing
Diabotical's in-game Map Editor is still feature-incomplete and requires knowledge of the in game console to use effectively. If you're familiar with some basic command line operations and willing to use a work-in-progress tool, then the Map Editor is extremely powerful and capable of making impressive maps - all of the official maps were made with it!
This documentation references an official document, which is currently better formatted.
Any help maintaining this new wiki is appreciated!
This quick guide will teach you the basics to get started, for more in-depth information, check the Navbox at the top.
This wiki will often reference console commands in the format of
/command. These are commands that you input into the console, which is opened by pressing `.
The Map Editor is accessible, through the Content Creation menu (folder icon in the top right corner of the Main Menu) by creating a new map, selecting it and editing. You can also bring up the console by pressing `, and typing
/edit. You can also use
/edit mapname, which will either open an existing map called 'mapname' or create a new one with that name.
- Before starting, take a look at the editing controls tab in your settings menu to get a feel for the default keybinds, and change any if you'd like to. Note that the default copy and paste binds are broken, and you'll need to bind them to a single key for them to work.
- There are a number of useful commands that currently don't have a spot on the settings menu that you may want to manually bind yourself. See Useful binds
- Toggle edit mode with F4. Any editor keybinds you set will only work in edit mode.
- In edit mode, bring up the tablet with F1.
- In the 'Add' tab, you can select materials, decals, props, and various entities to add to your map.
- The 'Properties' tab lets you manually manipulate your selected prop.
- Change scale and rotation with xyz coordinates.
- General properties, like color, clipping, sound and shadows are available for some props.
- Lights can change color, type and behavior.
- Set targets for jumppads and teleporters
This section is assuming default keybinds
- Work with blocks by using the select tool to click and drag over an area. Use your scroll wheel to add or remove blocks from the face you have selected. Double click to select all blocks on a face.
- Materials can be added to blocks via the tablet to change their appearance. You can also copy and paste materials.
- Materials can be adjusted by selecting a face and using NUM2, NUM4, NUM6, NUM8 and reset with NUM5.
- Materials can be rotated by selecting a face and using NUM7, and NUM9.
- All props and decals will snap to your current Grid Snap setting, which can be changed with F5, F6, F7, and F8.
- Translate props and decals with the arrow keys, Home and End.
- Rotate props by holding Ctrl and using the arrow keys, Home and End.
- Scale props and other entities by holding Shift and using the arrow keys, Home and End or through the Properties tab. Static props and other entities will rely on the keys that correspond to coordinates, while the direction keys used to increase the size of dynamic props depends on the player's perspective. Dynamic props will increase in length/width/depth with new segments being created, rather than increasing in scale and potentially being deformed (some will increase size in only some directions).
- Duplicate props and decals by holding Alt and using the arrow keys, Home or End.