MagicaVoxel Wiki
MagicaVoxel Wiki

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.

// [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
}

// [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 }

// [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 }

// [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'

)

// [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]]