Keen:Planet Modding/Voxel Materials - Revision history

CptTwinkie at 20:27, 18 July 2022

2022-07-18T20:27:31Z

← Older revision		Revision as of 20:27, 18 July 2022
Line 124:		Line 124:


	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Definition xsi:type="MyObjectBuilder_Dx11VoxelMaterialDefinition">		<Definition xsi:type="MyObjectBuilder_Dx11VoxelMaterialDefinition">
	<Id Type="VoxelMaterialDefinition" Subtype="Grass" /><!-- GLOBAL NAME OF THE VOXEL MATERIAL -->		<Id Type="VoxelMaterialDefinition" Subtype="Grass" /><!-- GLOBAL NAME OF THE VOXEL MATERIAL -->
Line 191:		Line 191:
	<DamagedMaterial>Soil</DamagedMaterial>		<DamagedMaterial>Soil</DamagedMaterial>
	</Definition>		</Definition>
	</~~source~~>		</syntaxhighlight>


Line 199:		Line 199:
	===Understanding how voxel textures are made===		===Understanding how voxel textures are made===
	The following lines of code define the textures for the base voxel. These textures define how the ground will look.		The following lines of code define the textures for the base voxel. These textures define how the ground will look.
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<ColorMetalXZnY>Textures\Voxels\Grass_cm.dds</ColorMetalXZnY>		<ColorMetalXZnY>Textures\Voxels\Grass_cm.dds</ColorMetalXZnY>
	<ColorMetalY>Textures\Voxels\Grass_cm.dds</ColorMetalY>		<ColorMetalY>Textures\Voxels\Grass_cm.dds</ColorMetalY>
Line 206:		Line 206:
	<ExtXZnY>Textures\Voxels\Grass_add.dds</ExtXZnY>		<ExtXZnY>Textures\Voxels\Grass_add.dds</ExtXZnY>
	<ExtY>Textures\Voxels\GrassAndHayY_add.dds</ExtY>		<ExtY>Textures\Voxels\GrassAndHayY_add.dds</ExtY>
	</~~source~~>		</syntaxhighlight>

	You may have noticed that for each texture there are two lines, a XZnY line and a Y line. Only the XZnY lines are strictly necessary to make the voxel work. The Y lines could be left out completely. The Y lines work by overriding the texture on the Y face of the voxels. This face is usually the one that is horizontal and is the one seen most often in the game. Overriding the Y face gives you the ability to use different textures for the other faces. This is done most often in Medieval Engineers for the mountains. That way the steep slopes can have a different texture than the mountain tops. This can also be done with other kinds of voxels, like Grass, but the results are not perfect. See the screenshot in the next section for a demonstration.		You may have noticed that for each texture there are two lines, a XZnY line and a Y line. Only the XZnY lines are strictly necessary to make the voxel work. The Y lines could be left out completely. The Y lines work by overriding the texture on the Y face of the voxels. This face is usually the one that is horizontal and is the one seen most often in the game. Overriding the Y face gives you the ability to use different textures for the other faces. This is done most often in Medieval Engineers for the mountains. That way the steep slopes can have a different texture than the mountain tops. This can also be done with other kinds of voxels, like Grass, but the results are not perfect. See the screenshot in the next section for a demonstration.
Line 286:		Line 286:
	Change your OrangeVoxels.sbc file’s definitions to use this file instead of the default one. Now is a good time to change all of the base textures.		Change your OrangeVoxels.sbc file’s definitions to use this file instead of the default one. Now is a good time to change all of the base textures.

	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<ColorMetalXZnY>Textures\Voxels\GrassOrange_cm.dds</ColorMetalXZnY>		<ColorMetalXZnY>Textures\Voxels\GrassOrange_cm.dds</ColorMetalXZnY>
	<ColorMetalY>Textures\Voxels\GrassOrange_cm.dds</ColorMetalY>		<ColorMetalY>Textures\Voxels\GrassOrange_cm.dds</ColorMetalY>
Line 293:		Line 293:
	<ExtXZnY>Textures\Voxels\GrassOrange_add.dds</ExtXZnY>		<ExtXZnY>Textures\Voxels\GrassOrange_add.dds</ExtXZnY>
	<ExtY>Textures\Voxels\GrassOrange_add.dds</ExtY>		<ExtY>Textures\Voxels\GrassOrange_add.dds</ExtY>
	</~~source~~>		</syntaxhighlight>


Line 341:		Line 341:

	Open the Far1 and distant textures in Photoshop and add the same Hue/Saturation adjustment layer on top. You may want to adjust it to better match the coloring of the base texture. Save them the same way as the others and then add them to your sbc file.		Open the Far1 and distant textures in Photoshop and add the same Hue/Saturation adjustment layer on top. You may want to adjust it to better match the coloring of the base texture. Save them the same way as the others and then add them to your sbc file.
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<ColorMetalXZnYFar1>Textures\Voxels\GrassOrange_Far1_cm.dds</ColorMetalXZnYFar1>		<ColorMetalXZnYFar1>Textures\Voxels\GrassOrange_Far1_cm.dds</ColorMetalXZnYFar1>
	<NormalGlossXZnYFar1>Textures\Voxels\GrassOrange_Far1_ng.dds</NormalGlossXZnYFar1>		<NormalGlossXZnYFar1>Textures\Voxels\GrassOrange_Far1_ng.dds</NormalGlossXZnYFar1>
Line 349:		Line 349:
	<NormalGlossXZnYFar2>Textures\Voxels\GrassOrange_distance_ng.dds</NormalGlossXZnYFar2>		<NormalGlossXZnYFar2>Textures\Voxels\GrassOrange_distance_ng.dds</NormalGlossXZnYFar2>
	<ExtXZnYFar2>Textures\Voxels\GrassOrange_Far1_add.dds</ExtXZnYFar2>		<ExtXZnYFar2>Textures\Voxels\GrassOrange_Far1_add.dds</ExtXZnYFar2>
	</~~source~~>		</syntaxhighlight>

	You may have noticed that the same add file was used for both Far1 and Far2. Normally a small dummy file is substituted in far textures to save memory since ambient occlusion doesn't really play much of a role at such a distance. However, Medieval Engineers also has color shift information in the add texture which is necessary if players are to be able to find iron ore. Using the same add file for both just saves from adding an extra texture for each voxel.		You may have noticed that the same add file was used for both Far1 and Far2. Normally a small dummy file is substituted in far textures to save memory since ambient occlusion doesn't really play much of a role at such a distance. However, Medieval Engineers also has color shift information in the add texture which is necessary if players are to be able to find iron ore. Using the same add file for both just saves from adding an extra texture for each voxel.
Line 355:		Line 355:

	You may want to load the game and use the Voxel Materials screen again. This time to find appropriate far distance and scale settings. These are a little less complex than the base scaling settings. The distance is in meters.		You may want to load the game and use the Voxel Materials screen again. This time to find appropriate far distance and scale settings. These are a little less complex than the base scaling settings. The distance is in meters.
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Far1Distance>20</Far1Distance>		<Far1Distance>20</Far1Distance>
	<Far2Distance>120</Far2Distance>		<Far2Distance>120</Far2Distance>
	<Far1Scale>100</Far1Scale>		<Far1Scale>100</Far1Scale>
	<Far2Scale>300</Far2Scale>		<Far2Scale>300</Far2Scale>
	</~~source~~>		</sousyntaxhighlightrce>


Line 421:		Line 421:
	After you have saved the changes with appropriate compression, add the orange grasses to your sbc file.		After you have saved the changes with appropriate compression, add the orange grasses to your sbc file.

	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Foliage Density="30" Type="Grass">		<Foliage Density="30" Type="Grass">
	<Size x=".55" y=".55"/>		<Size x=".55" y=".55"/>
Line 430:		Line 430:
	<Variation Color="Textures\Models\Environment\Grass\GrassOrange_03_cm.dds" Normal="Textures\Models\Environment\Grass\GrassOrange_03_ng.dds" Frequency="1"/>		<Variation Color="Textures\Models\Environment\Grass\GrassOrange_03_cm.dds" Normal="Textures\Models\Environment\Grass\GrassOrange_03_ng.dds" Frequency="1"/>
	</Foliage>		</Foliage>
	</~~source~~>		</syntaxhighlight>
	<center><small>Note: The <code><SizeVariation></code> tag doesn't seem to be working correctly. Instead of allowing for variations it is only multiplying the size.</small></center>		<center><small>Note: The <code><SizeVariation></code> tag doesn't seem to be working correctly. Instead of allowing for variations it is only multiplying the size.</small></center>

CptTwinkie: /* Y texture overrides */

2018-11-13T08:30:42Z

Y texture overrides

← Older revision		Revision as of 08:30, 13 November 2018
Line 376:		Line 376:


	As you can see the purple base texture blends in where the edge of the voxel becomes steep. However, on the other side of the hole you'll notice that the orange is still showing. This is because voxels are not always perfectly aligned with the surface of the planet. This is because voxels are large, clustered, and cubic. They do not map well to the curved surface of the planet. ~~The~~ are stretched and bent at the surface to make things smooth. These means that there will be some inconsistencies in texturing. You'll want to be aware of this behavior when using Y overrides. It's best to keep your override textures and base textures similar so that they blend smoothly. Bigger differences can be made in the far textures, although they have almost no blending at all. This can be seen quite clearly on the edges of distant snow where it does not blend with the surrounding voxels. Instead it has jagged square edges.		As you can see the purple base texture blends in where the edge of the voxel becomes steep. However, on the other side of the hole you'll notice that the orange is still showing. This is because voxels are not always perfectly aligned with the surface of the planet. This is because voxels are large, clustered, and cubic. They do not map well to the curved surface of the planet. They are stretched and bent at the surface to make things smooth. These means that there will be some inconsistencies in texturing. You'll want to be aware of this behavior when using Y overrides. It's best to keep your override textures and base textures similar so that they blend smoothly. Bigger differences can be made in the far textures, although they have almost no blending at all. This can be seen quite clearly on the edges of distant snow where it does not blend with the surrounding voxels. Instead it has jagged square edges.


	===Understanding how grass textures are made===		===Understanding how grass textures are made===

CptTwinkie at 10:53, 29 June 2018

2018-06-29T10:53:08Z

← Older revision		Revision as of 10:53, 29 June 2018
Line 1:		Line 1:
	<noinclude>{{SEO\|image_url=http://www.medievalengineerswiki.com/images/d/da/Voxels_6-3.jpg\|description=In this guide you'll learn how to modify voxel and grass (foliage) textures and how to create voxel definitions.}}		<noinclude>{{SEO\|image_url=http://www.medievalengineerswiki.com/images/d/da/Voxels_6-3.jpg\|description=In this guide you'll learn how to modify voxel and grass (foliage) textures and how to create voxel definitions.}}
	{{:~~Official Content/~~OCH}}		{{Keen:OCH}}

CptTwinkie: CptTwinkie moved page Official Content/Planet Modding/Voxel Materials to Keen:Planet Modding/Voxel Materials

2018-06-29T10:38:17Z

CptTwinkie moved page Official Content/Planet Modding/Voxel Materials to Keen:Planet Modding/Voxel Materials

← Older revision		Revision as of 10:38, 29 June 2018
(No difference)

CptTwinkie at 10:30, 29 June 2018

2018-06-29T10:30:54Z

← Older revision		Revision as of 10:30, 29 June 2018
Line 6:		Line 6:
	\|release=0\|major=6\|minor=X\|suppress=true}}		\|release=0\|major=6\|minor=X\|suppress=true}}
	[[Category:Keen_Modding_Guides]]</noinclude>		[[Category:Keen_Modding_Guides]]</noinclude>
	==[[~~Official Content/~~Planet Modding/Voxel Materials\|Voxel Material Modding]]==		==[[Keen:Planet Modding/Voxel Materials\|Voxel Material Modding]]==
	Hello and welcome to the voxel materials modding guide. In this guide you'll learn how to modify voxel and grass (foliage) textures and how to create voxel definitions.		Hello and welcome to the voxel materials modding guide. In this guide you'll learn how to modify voxel and grass (foliage) textures and how to create voxel definitions.

Line 313:		Line 313:


	The solution to this is to create a <code>metadata.mod</code> file in your mod folder. See the [[~~Official Content/~~Mod Metadata\|Mod Metadata]] guide for details.		The solution to this is to create a <code>metadata.mod</code> file in your mod folder. See the [[Keen:Mod Metadata\|Mod Metadata]] guide for details.

	===Voxel scaling===		===Voxel scaling===
Line 458:		Line 458:


	<noinclude>View the full [[~~Official Content/~~Planet Modding - Full Guide\|Planet Modding Guide]]</noinclude>		<noinclude>View the full [[Keen:Planet Modding - Full Guide\|Planet Modding Guide]]</noinclude>

CptTwinkie at 21:36, 1 June 2018

2018-06-01T21:36:03Z

← Older revision		Revision as of 21:36, 1 June 2018
Line 1:		Line 1:
	<noinclude>{{:Official Content/OCH}}		<noinclude>{{SEO\|image_url=http://www.medievalengineerswiki.com/images/d/da/Voxels_6-3.jpg\|description=In this guide you'll learn how to modify voxel and grass (foliage) textures and how to create voxel definitions.}}
			{{:Official Content/OCH}}

CptTwinkie at 15:00, 30 May 2018

2018-05-30T15:00:31Z

← Older revision		Revision as of 15:00, 30 May 2018
Line 1:		Line 1:
	<noinclude>{{Version <!-- Do not change the version until the entire page is up-to-date -->		<noinclude>{{:Official Content/OCH}}


			{{Version <!-- Do not change the version until the entire page is up-to-date -->
	\|release=0\|major=6\|minor=X\|suppress=true}}		\|release=0\|major=6\|minor=X\|suppress=true}}
	[[Category:Keen_Modding_Guides]]</noinclude>		[[Category:Keen_Modding_Guides]]</noinclude>

CptTwinkie: /* Mod Compatibility */

2018-05-18T07:58:48Z

Mod Compatibility

← Older revision		Revision as of 07:58, 18 May 2018
Line 301:		Line 301:


			# Numbered list item
	===Mod Compatibility===		===Mod Compatibility===
	You may have noticed a message box with the following warning.		You may have noticed a message box with the following warning.


	[[File:Voxels_3-85.jpg~~\|center~~\|600px]]		[[File:Voxels_3-85.jpg\|600px]]


	The solution to this is to create a <code>metadata.mod</code> file in your mod folder. See the [[Official Content/Mod Metadata\|Mod Metadata]] guide for details.		The solution to this is to create a <code>metadata.mod</code> file in your mod folder. See the [[Official Content/Mod Metadata\|Mod Metadata]] guide for details.


	===Voxel scaling===		===Voxel scaling===

CptTwinkie at 09:50, 15 April 2018

2018-04-15T09:50:53Z

← Older revision		Revision as of 09:50, 15 April 2018
Line 114:		Line 114:

	You may be wondering why it's not named GrassOrange.png. We are wondering the same thing. Hopefully you will not make mistakes like this when making your own mods. This just goes to show how easy it is to mess up the details.		You may be wondering why it's not named GrassOrange.png. We are wondering the same thing. Hopefully you will not make mistakes like this when making your own mods. This just goes to show how easy it is to mess up the details.


	===Voxel material definitions===		===Voxel material definitions===
Line 393:		Line 394:


	There is no metalness channel, only a more 2D style Alpha channel transparency. It is necessary for the grass to have this ~~transparency~~ since it is not a 3D model.		There is no metalness channel, only a more 2D style Alpha channel transparency. It is necessary for the grass to have this alpha masking since it is not a 3D model.

	Grasses are actually planes with ~~transparency~~. This allows them to render quickly and be animated en masse.		Grasses are actually planes with alpha masks. This allows them to render quickly and be animated en masse.

	<center>		<center>

CptTwinkie at 23:59, 14 April 2018

2018-04-14T23:59:19Z

← Older revision		Revision as of 23:59, 14 April 2018
Line 438:		Line 438:

	Make sure to add it to the sbc file <code><Icon>Textures\GUI\Icons\Voxel\OrangeGrass.png</Icon></code>.		Make sure to add it to the sbc file <code><Icon>Textures\GUI\Icons\Voxel\OrangeGrass.png</Icon></code>.


			[[File:Icon.jpg\|center]]