FANDOM


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]]
Community content is available under CC-BY-SA unless otherwise noted.