Config.txt

This page describes the configuration file of MagicaVoxel, and explains its default settings.

That file is located in the `/config` folder of your software's install.

Each modification of that file requires MagicaVoxel to be restarted for changes to be applied.

* 0.99.5a
* 0.99.4.2a
* 0.99.3a
* 0.99.2a
* 0.99.1a
view **·** edit
```
// [EPHTRACY 11/11/2019]

workspace :
{
	// use '$' for current directory, otherwise use actual full path
	dir_model		: [[$/vox]]
	dir_pattern		: [[$/vox]]
	dir_palette		: [[$/palette]]
	dir_export		: [[$/export]]
	dir_snapshot		: [[$/export]]
	dir_xs_shader		: [[$/shader]]
	dir_ibl			: [[$/ibl]]
	dir_plugin		: [[$/plugin]]
}

view :
{
	ui_scale		: '1.0' // [0.5, 3.0]

	ambient_color		: '0.19 0.18 0.26' // [0.0 ~ 1.0]
}

render :
{
	dense_buffer		: '256'   // [16, 1024] MB
	sparse_buffer		: '256'   // [16, 1024] MB
}

model_editor :
{
	compute			: 'gl'	// { cpu, gl }
}

io_iso :
{
	size			: '2' // voxel size : [1, 8]
	height			: '4' // height : size * 2 : [1, 24]

	view			: '4' // num of views : [1, 4]
	outline			: '1' // outline and highlight : [0, 1]

	top			: '1.17 1.15 1.25'		// top lighting [0.0 - 1.0]
	left			: '0.37 0.35 0.55'		// left lighting
	right			: '0.87 0.85 0.95'		// right lighting
	bevel			: '0.13 0.13 0.13'		// bevel highlight
}

io_2d :
{
	size			: '16' // voxel size : [1, 32]
	shadow			: '1'  // enable shadow : [0, 1]
	outline			: '0'  // enable outline : [0, 1]
}

io_obj :
{
	scale			: '0.1'
	axis			: 'XZ-Y'	// axis : { 'XYZ' : Z up; 'XZ-Y' Y up }
	cw			: '0'		// { 0 : counter clockwise; 1 : clockwise }

	merge			: '1'		// merge voxel faces with same color
}

io_ply :
{
	scale			: '0.1'
	axis			: 'XYZ'
	cw			: '0'
}

io_mc :
{
	scale			: '0.1'
	axis			: 'XYZ'
	cw			: '0'
}

io_cube :
{
	scale			: '0.1'
	axis			: 'XYZ'
	cw			: '0'

	margin			: '0.1' // 0.0 ~ 1.0
}

io_point :
{
	scale			: '1'
	axis			: 'XYZ'

	sample_offset		: '0 0 0' // 0.0 ~ 1.0
}

```
view **·** edit
```
// [EPHTRACY 11/11/2019]
workspace :
{
 // 1. use '$' for current directory, otherwise use actual full path
 // 2. use single '/' or '\' in the path
 // 3. don't have empty space at ends of path

 dir\_model : [[$/vox]]
 dir\_pattern : [[$/vox]]
 dir\_palette : [[$/palette]]
 dir\_export : [[$/export]]
 dir\_snapshot : [[$/export]]
 dir\_xs\_shader : [[$/shader]]
}

view :
{
 // [0.5, 3.0]
 ui\_scale : '1.0'

 // [0, 255]
 ground\_color : '60 60 60 150'

 // [0, 255]
 edge\_color : '17 17 17'//'255 51 102'

 // [0, 255]
 bg\_color : '38 38 38'

 // [0.0, 1.0]
 bg\_fade : '0.5'

 // [0.0 ~ 1.0]
 ambient\_color : '0.19 0.18 0.26'
}

render :
{
 dense\_buffer : '256' // [16, 1024] MB
 sparse\_buffer : '256' // [16, 2048] MB
}

io\_iso :
{
 size : '2' // voxel size : [1, 8]
 height : '4' // height : size \* 2 : [1, 24]

 view : '4' // num of views : [1, 4]
 outline : '1' // outline and highlight : [0, 1]

 top : '1.17 1.15 1.25' // top lighting [0.0 - 1.0]
 left : '0.37 0.35 0.55' // left lighting
 right : '0.87 0.85 0.95' // right lighting
 bevel : '0.13 0.13 0.13' // bevel highlight
}

io\_2d :
{
 size : '16' // voxel size : [1, 32]
 shadow : '1' // enable shadow : [0, 1]
 outline : '0' // enable outline : [0, 1]
}

io\_obj :
{
 scale : '0.1'
 axis : 'XZ-Y' // axis : { 'XYZ' : Z up; 'XZ-Y' Y up }
 cw : '0' // { 0 : counter clockwise; 1 : clockwise }

 merge : '1' // merge voxel faces with same color
}

io\_ply :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'
}

io\_mc :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'
}

io\_cube :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'

 margin : '0.1' // 0.0 ~ 1.0
}

io\_point :
{
 scale : '1'
 axis : 'XYZ'

 sample\_offset : '0 0 0' // 0.0 ~ 1.0
}

```
view **·** edit
```
// [EPHTRACY 2/10/2019]
workspace :
{
 // 1. use '$' for current directory, otherwise use actual full path
 // 2. use single '/' or '\' in the path
 // 3. don't have empty space at ends of path

 dir\_model : [[$/vox]]
 dir\_pattern : [[$/vox]]
 dir\_palette : [[$/palette]]
 dir\_export : [[$/export]]
 dir\_snapshot : [[$/export]]
 dir\_xs\_shader : [[$/shader]]
}

view :
{
 // 0.5 ~ 3.0
 ui\_scale : '1.0'

 // 0 ~ 255
 ground\_color : '60 60 60 150'

 // 0 ~ 255
 edge\_color : '17 17 17'//'255 51 102'

 // 0 ~ 255
 bg\_color : '38 38 38'

 // 0.0 ~ 1.0
 bg\_fade : '0.5'

 // 0.0 ~ 1.0
 ambient\_color : '0.19 0.18 0.26'
}

io\_iso :
{
 size : '2' // voxel size : [1 - 8]
 height : '4' // height : size \* 2 : [1 - 24]

 view : '4' // num of views : [1 - 4]
 outline : '1' // outline and highlight : [0, 1]

 top : '1.17 1.15 1.25' // top lighting [0.0 - 1.0]
 left : '0.37 0.35 0.55' // left lighting
 right : '0.87 0.85 0.95' // right lighting
 bevel : '0.13 0.13 0.13' // bevel highlight
}

io\_2d :
{
 size : '16' // voxel size : [1 - 32]
 shadow : '1' // enable shadow : [0, 1]
 outline : '0' // enable outline : [0, 1]
}

io\_obj :
{
 scale : '0.1'
 axis : 'XZ-Y' // axis : { 'XYZ' : Z up; 'XZ-Y' Y up }
 cw : '0' // { 0 : counter clockwise; 1 : clockwise }

 merge : '1' // merge voxel faces with same color
}

io\_ply :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'
}

io\_mc :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'
}

io\_cube :
{
 scale : '0.1'
 axis : 'XYZ'
 cw : '0'

 margin : '0.1' // 0.0 ~ 1.0
}

io\_point :
{
 scale : '1'
 axis : 'XYZ'

 sample\_offset : '0 0 0' // 0.0 ~ 1.0
}

```
view **·** edit
```
// [EPHTRACY 9/26/2018]
workspace
(
 // notice :
 // 1. use '$' for current directory, otherwise use full path
 // 2. use single '/' or '\' in the path
 // 3. don't have empty space at ends of the path

 dir\_model = [[$/vox]]
 dir\_pattern = [[$/vox]]
 dir\_palette = [[$/palette]]
 dir\_export = [[$/export]]
 dir\_snapshot = [[$/export]]
 dir\_xs\_shader = [[$/shader]]
)

view
(
 // 0.5 ~ 3.0 : scale ui for high dpi screen
 ui\_scale = '1.0'

 // 0 ~ 255
 edge\_color = '17 17 17'//'255 51 102'

 // 0.0 ~ 1.0
 ambient\_color = '0.19 0.18 0.26'
)

file\_iso
(
 size = '2' // voxel size : [1 - 8]
 height = '4' // height = size \* 2 : [1 - 24]

 view = '1' // num of views : [1 - 4]
 outline = '1' // outline and highlight : [0, 1]

 top = '1.17 1.15 1.25' // top lighting [0.0 - 1.0]
 left = '0.37 0.35 0.55' // left lighting
 right = '0.87 0.85 0.95' // right lighting
 bevel = '0.13 0.13 0.13' // bevel highlight
)

file\_2d
(
 size = '16' // voxel size : [1 - 32]
 shadow = '1' // enable shadow : [0, 1]
 outline = '0' // enable outline : [0, 1]
)

file\_obj
(
 scale = '1 1 1' // scale size
 pivot = '0.5 0.5 0.0' // pivot point ( modelSize \* 'pivot' )
 tc\_offset = '0.5 0.5' // texture coordinate offset ( 0 : corner; 0.5 : center )
 cw = '0' // ( 0 : counter clockwise; 1 : clockwise )
 axis = 'XZ-Y' // axis ( 'XYZ' : Z up; 'XZ-Y' Y up )

 optimize = '1' // merge voxel faces with same color
)

file\_ply
(
 scale = '1 1 1'
 pivot = '0.5 0.5 0.0'
 tc\_offset = '0.5 0.5'
 cw = '0'
 axis = 'XYZ'
)

file\_3ds
(
 scale = '1 1 1'
 pivot = '0.5 0.5 0.0'
 tc\_offset = '0.5 0.5'
 cw = '0'
 axis = 'XYZ'

)
```
view **·** edit
```
// [EPHTRACY 3/11/2018]
workspace
(
 // notice :
 // 1. use '$' for current directory, otherwise use actual full path
 // 2. use single '/' or '\' in the path
 // 3. don't have empty space at ends of path

 dir\_model = [[$/vox]]
 dir\_pattern = [[$/vox]]
 dir\_palette = [[$/palette]]
 dir\_export = [[$/export]]
 dir\_snapshot = [[$/export]]
)

view
(
 // 0.5 ~ 3.0 : scale ui for high dpi screen
 ui\_scale = '1.0'

 // 0 ~ 255
 edge\_color = '17 17 17'//'255 51 102'

 // 0.0 ~ 1.0
 ambient\_color = '0.19 0.18 0.26'
)

bake
(
 perface = '0' // per face or per vertex [0, 1]
 ambient = '0.1' // constant ambient [0.0 - 1.0]
 gamma = '1.0' // gamma [1.0, 2.2]

 scale = '1 1 1'
 pivot = '0.5 0.5 0.0'
 tc\_offset = '0.5 0.5'
 cw = '0'
 axis = 'XYZ'
)

file\_iso
(
 size = '2' // voxel size : [1 - 8]
 height = '4' // height = size \* 2 : [1 - 24]

 view = '1' // num of views : [1 - 4]
 outline = '1' // outline and highlight : [0, 1]

 top = '1.17 1.15 1.25' // top lighting [0.0 - 1.0]
 left = '0.37 0.35 0.55' // left lighting
 right = '0.87 0.85 0.95' // right lighting
 bevel = '0.13 0.13 0.13' // bevel highlight
)

file\_2d
(
 size = '16' // voxel size : [1 - 32]
 shadow = '1' // enable shadow : [0, 1]
 outline = '0' // enable outline : [0, 1]
)

file\_obj
(
 scale = '1 1 1' // scale size
 pivot = '0.5 0.5 0.0' // pivot point ( modelSize \* 'pivot' )
 tc\_offset = '0.5 0.5' // texture coordinate offset ( 0 : corner; 0.5 : center )
 cw = '0' // ( 0 : counter clockwise; 1 : clockwise )
 axis = 'XZ-Y' // axis ( 'XYZ' : Z up; 'XZ-Y' Y up )

 optimize = '1' // merge voxel faces with same color
)

file\_ply
(
 scale = '1 1 1'
 pivot = '0.5 0.5 0.0'
 tc\_offset = '0.5 0.5'
 cw = '0'
 axis = 'XYZ'
)

file\_3ds
(
 scale = '1 1 1'
 pivot = '0.5 0.5 0.0'
 tc\_offset = '0.5 0.5'
 cw = '0'
 axis = 'XYZ'

)
```

# Settings examples

## Changing the default project path

On Windows, ask the software to look for projects into the drive `E:` and in the subfolder `3D/MagicaVoxel/Vox` by default:

```
dir_model : [[E:\3D\MagicaVoxel\Vox]]
```