Eric's MagicaVoxel Shaders

Shaders for MagicaVoxel including Terrain Generator, Advanced Flood System etc.

Internationalization

• 简体中文 - translated by CodingEric, target version: 0.1.0.0
• Français - translated by Pilou - Authorized reproduce, target version: 0.0.7.0

Project Info

• Current version: 0.1.0.1
• Tested with MagicaVoxel 0.99.4 for Windows
• Released under MIT License
• Language: GLSL

Installation

Copy the .txt files from the shader directory in this project to the shader directory of your MagicaVoxel installation.

Compatibility

Notice: The compatibility issue in older GLSL versions are thought of as issues.

Roadmap

• Cloud generator
• Implement more options (turbulence and so on) to the terrain generator.
• Tree randomizer.

Contribution

Feel free to make a PR as long as you've followed the contributing guidelines.

Debug

See this issue.

Shaders and usages

Note
- The parameters with <> can be ignored. Mostly, they are set to 0 as default.
- The shaders are not designed for selected areas without specific explanation.
- The documentation of deprecated/unstable shaders can be found in their folders.

INDEX

• tergen (Terrain Generator)
• tergen2 (Terrain Generator 2)
• cave (3D Noise Generator)
• flow (Waterflow Emulator)
• flow2 (A procedural closed-area filler)
• project (3d object to 2d plane)
• lifegame (A 2d cellular automaton)
• drop
• cubefill

tergen

index

• Usage:

xs tergen [seed] [altitude] 
[noise-scale] [voxel-color] <void-voxel-color> <vertical-shifting> <x-shifting> <y-shifting>

• Example:

xs tergen 19260817 40 90 1 -1 10 -50 -10
xs tergen 19260817 40 90 1

1. Set void-voxel-color to -1 to not remove the original scene.
2. By using the xyz-shifting of the shader & the new world system of MagicaVoxel 0.99.x, you'll be able to create a large terrain map. (fig. 3)

• Image preview:

  

tergen2

index

• Usage:

xs tergen2 [seed] [altitude] 
[noise-scale] [voxel-color] <void-voxel-color> <vertical-shifting> <x-shifting> <y-shifting>

• Example:

xs tergen2 19260817 16 70 1 -1 -10 -50 -10
xs tergen2 19260817 16 70 1

Set void-voxel-color to -1 to not remove the original scene.

• Image preview:

  

cave

index

• Usage:

xs cave [seed] [noise-scale] [voxel-color] [void-voxel-color (-1 for not emptying the scene)] [vertical-shifting] [x-shifting] [y-shifting]

• Example:

xs cave 19260817 75 1 -1 10 10 10`
xs cave 19260817 75 1 -1

Set void-voxel-color to -1 to not remove the original scene.

• Image preview:

  

flow

index

• Usage:

xs flow [color-index]

• Example:

xs flow 1

The voxels with given index are water source, the shader would not automatically create them, you must attach them first.

• Image preview:

  

flow2

index

• Usage:

xs flow2 [color-index]

• Example:

xs flow2 1

If you're tired of keeping executing this, consider the -n [num interations] parameter.

The voxels with given index are water source, you must attach them first.

• Image preview:

  

project

index

Supports x-y plane only. (To be fixed)

• Usage:

xs project [height]

• Example:

xs project 64

• Image preview:

  

lifegame

index

• Usage:

xs lifegame [color-index]

• Example:

xs lifegame 1

Designed for x-y plane. Use single color in your scene, or the shader will destroy it. (To be fixed)

• Image preview:

  

drop

index

This shader simulates the drop process.

• Usage:

xs drop [color-index]

• Example:

xs drop 1

• Image preview:

  

cubefill

index

• Usage:

  xs cubefill [mode (0 for filling, 1 for frame)] [point1_X] [point1_Y] [point1_Z] [point2_X] [point2_Y] [point2_Z] [voxel color]
  

  xs cubefill [mode (0 for filling, 1 for frame)] [pointX] [pointY] [pointZ] [length of a side] [voxel color]
  

• Example:

  xs cubefill 1 1 1 1 7 2 2 216
  

  Draw the edge frame of a red cuboid between the coordinates (1,1,1) and (7,2,2).

  xs cubefill 0 50 50 50 10 216
  

  Take coordinates (50,50,50) as the center, create a red cube with a side length of 10 units.

• Image preview: