A collection of shaders for MagicaVoxel to simplify common and repetitive tasks.
Install these shaders by copying the files from the shader directory in this project into the shader directory of your MagicaVoxel installation.
If you encounter an issue with these shaders, please review any open issues and create a new issue if one does not exist already.
 |
Slice | Remove segments from a model | sx sy sz |
|---|---|---|---|
 |
Pyramid | Generates a pyramid effect layer-by-layer | py py2 |
 |
Sand | Generates a sand effect, layer-by-layer | sand sand2 |
 |
Soil | Adds a layer on top of voxels; i.e. sand or snow | soil soil2 soil3 |
 |
Bricks | Generates a brick pattern of different colors and sizes | bx by |
 |
Case | Encase voxels in voxels | case |
 |
Outline | Generate an outline surrounding voxels | outline outline2 |
 |
Noise | Add colored different sized noise | noise |
 |
Random | Add noise at a specific probability | rand |
 |
Flood | Add voxels bottom-up, as if it were flooding | flood flood2 |
 |
Grid | Generate a grid of different sizes | grid |
 |
Lines | Generate lines | lnx lny lnz |
xs sx [offset] [count]
xs sy [offset] [count]
xs sz [offset] [count]
The slice shaders removes one or more segments from the X, Y or Z-axis. All other segments are shuffled to full the available space. The first parameter c is the coordinate of the segment you wish to remove and count is the number of segments. Note that count is optional and defaults to 1.
For example, in the first image, segments are removed with these commands:
xs sx 19 1
xs sy 15 1
xs py [index]
xs py2 [index]
The py and py2 shaders add a layer of voxel on top of voxels matching the selected colour. A voxel is only added when the voxel beneath has adjacent voxels, creating the effect of a pyramid.
py will only add voxels when the adjacent voxels match the selected color. Whereas, py2 will add voxels if there are adjacent voxels of any color.
If provided, index will be the color index of the added voxels. This parameter is optional; if ommitted (or set to 0) the selected color index is used instead.
Each time the shader is executed, a single layer is added. To add multiple layers at once, use -n to set a number of iterations:
xs -n 50 py
xs -n 50 py2
If neither axis modes (or both X and Y) are set, the shader will form a square pyramid. However, if either X or Y modes are set, the shader will form a pyramid with the slope facing the X or Y axes respectively.
xs sand [index] [add]
xs sand2 [index] [add]
The sand and sand2 shaders add a layer voxels on top of voxels matching the selected colour. Voxels are added randomly and only added when the voxel beneath has adjacent voxels, creating the effect of a rough pile of sand. The number of adjacent neighbours affects the randomness, with a higher number of neighbours increasing the odds a voxel will be added.
If provided, index will be the color index of the added voxels. This parameter is optional; if ommitted (or set to 0) the selected color index is used instead.
add can be used to increase the odds of adding voxels. Numbers between 0.01 and 0.4 have the best effect. Because add is the second parameter, you can set index to 0 if using add in a loop.
Each time the shader is executed, a single layer is added. To add multiple layers at once, use -n to set a number of iterations:
xs -n 50 sand
xs -n 50 sand2 0 0.125
xs line [index] [spacing] [offset]
Replaces all voxels which match your selected color with lines set to the color passed as index. Setting the index to 0 will remove the voxels. Lines are spaced based on the spacing parameter, which defaults to 2. Lines can be offset with the offset parameter. You should use axis modes to limit the lines to a particular axis.
(This shader combines the lnx, lny and lnz shaders from the earlier versions.)
xs soil [index] [headroom]
xs soil2 [index] [headroom]
xs soil3 [headroom]
The soil and soil2 shaders adds voxels, set to the color passed as index, on top of voxels matching your selected colour. soil adds voxels, set as the selected color, on top of all voxels.
- Voxels are only added where there is empty space. By default, voxels are added if there is at least one empty space above, however you can adjust the number of voxels that are checked with
headroom. soil2is similar tosoil, except voxels are replaced instead of added on top.
xs bx [width] [depth] [height] [a] [b]
xs by [width] [depth] [height] [a] [b]
Generates a brick texture between two colors; a and b. The difference between the shaders is the facing direction of the bricks (if the bricks are not generating, try switching shader)
Examples
To generate bricks between color 1 and 8:
 |
||
| Model | ||
 |
 |
 |
xs bx 6 1 1 1 8 |
xs bx 4 4 4 1 8 |
xs bx 4 3 2 1 8 |
 |
 |
 |
xs bx 4 2 2 1 8 |
xs bx 2 4 2 1 8 |
xs bx 2 1 1 1 8 |
xs case [index]
Surrounds (encases) the all voxels which match your selected color. Axis modes can use used to only add voxels on certain axes. The outline color will be the provided index.
This shader is similar to the Dilation tool; except you can select an axis mode and target color.
xs outline [color]
xs outline2 [color]
Replaces all voxels which match your selected color which are adjacent to another voxel of a different color. The outline color will be the provided color. Setting the index to 0 will remove the voxels.
outline2 is similar to outline, but produces thinner lines.
xs grid [index] [x] [y] [xoffset] [yoffset]
Replaces all voxels which match your selected color with a grid with a cell size determined by x and y. Grid cells are colored based on the provided index. Setting the index to 0 will remove the voxels. Grids can be square or rectangular. You can offset the position of the grid with xoffset and yoffset parameters, which default to 0.
xs noise [a] [b] [size_x] [size_y] [size_z]
Replaces all voxels which match your selected color with a randomly chosen color within a range of colors (a and b, inclusive). size_x, size_y and size_z can be used to increase the size to be larger than a single voxel. For example, 3 3 3 will randomly generate noise in 3 x 3 x 3 cubes.
Voxels are replaced across all axes. The shader can be limited to the X, Y, or Z-axis (or a combination) by setting an axis mode.
xs rand [f] [index]
Replaces all voxels which match your selected color with a randomly chosen index. If index is 0, voxels are randomly removed instead. You can control the threshold by adjusting the f value. Values closer to 0.0 will replace more voxels. Values closer to 1.0 will replace less.
Voxels are replaced across all axes. You can randomize the X, Y, or Z-axis (or a combination) with the axis mode.
xs flood [n]
xs flood2 [n]
Adds n number of layers of voxels of your selected color from the bottom of your model upwards. Voxels are only added to empty space and won't replace existing voxels.
flood2 is similar to flood, except flooding stops when a voxel is encountered so that exclosed spaces aren't filled.