Keen:Planet Modding/Material Texture - Revision history

CptTwinkie at 20:26, 18 July 2022

2022-07-18T20:26:44Z

← Older revision		Revision as of 20:26, 18 July 2022
Line 43:		Line 43:
	Surface “voxel materials” refers to what you know as grass, soil, stone.. We use red channel of the material texture to set where all the terrain appears. Then you need to write definitions in the Content\Data\PlanetGenerator.sbc to tell game which voxel should appear at specific red channel value.		Surface “voxel materials” refers to what you know as grass, soil, stone.. We use red channel of the material texture to set where all the terrain appears. Then you need to write definitions in the Content\Data\PlanetGenerator.sbc to tell game which voxel should appear at specific red channel value.
	Example of the definition of road:		Example of the definition of road:
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<ComplexMaterials>		<ComplexMaterials>
	<MaterialGroup Name="Road" Value="67">		<MaterialGroup Name="Road" Value="67">
Line 54:		Line 54:
	</MaterialGroup>		</MaterialGroup>
	</ComplexMaterials>		</ComplexMaterials>
	</~~source~~>		</syntaxhighlight>
	Example of corresponding material texture with road:		Example of corresponding material texture with road:

Line 62:		Line 62:
	====Complex materials====		====Complex materials====
	Complex materials definition allows to paint the map with a set of “voxel coloring rules”. Meaning that one color value in red channel can color terrain with different voxels based on rules like slope, longitude or latitude and height. (So with our road example)		Complex materials definition allows to paint the map with a set of “voxel coloring rules”. Meaning that one color value in red channel can color terrain with different voxels based on rules like slope, longitude or latitude and height. (So with our road example)
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<MaterialGroup Name="Forest_Grass" Value="120">		<MaterialGroup Name="Forest_Grass" Value="120">
	<Rule>		<Rule>
Line 90:		Line 90:
	</Rule>		</Rule>
	</MaterialGroup>		</MaterialGroup>
	</~~source~~>		</syntaxhighlight>
	This definition says what voxels should be generated in spots, that are painted with red channel value of 120.		This definition says what voxels should be generated in spots, that are painted with red channel value of 120.
	The rules in this definition will lead to following:		The rules in this definition will lead to following:
Line 96:		Line 96:
	In places with medium slope, there is Grass instead of WoodGrass. And in slopes from 45 to 55 there is rocks grass 2 m thick with stone right away under it.		In places with medium slope, there is Grass instead of WoodGrass. And in slopes from 45 to 55 there is rocks grass 2 m thick with stone right away under it.
	With this technology, we can make the color react on its own to terrain bumps or even position on planet. This saves lots of meticulous painting with heightmap.		With this technology, we can make the color react on its own to terrain bumps or even position on planet. This saves lots of meticulous painting with heightmap.
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Layer Material="Woods_grass" Depth="1"/><!-- Material refers to voxelmaterial definition. (You can find it in Content\Data\VoxelMaterials.sbc). Depth means how deep should the material go under ground. -->		<Layer Material="Woods_grass" Depth="1"/><!-- Material refers to voxelmaterial definition. (You can find it in Content\Data\VoxelMaterials.sbc). Depth means how deep should the material go under ground. -->
	<Slope Min="0" Max="25"/><!-- Slope of the terrain in degrees. -->		<Slope Min="0" Max="25"/><!-- Slope of the terrain in degrees. -->
	<Latitude Min="-180" Max="180"/><!-- Latitude in degrees. 0 degree is an equator. -->		<Latitude Min="-180" Max="180"/><!-- Latitude in degrees. 0 degree is an equator. -->
	<Longitude Min="-180" Max="180"/><!-- Longitude in degrees. 0 is in the middle of front planetary texture. (Fareon Kingdom) -->		<Longitude Min="-180" Max="180"/><!-- Longitude in degrees. 0 is in the middle of front planetary texture. (Fareon Kingdom) -->
	</~~source~~>		</syntaxhighlight>


Line 121:		Line 121:

	=====Definition elements explained=====		=====Definition elements explained=====
	<~~source~~ lang="xml"><!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->		<syntaxhighlight lang="xml" line>
			<!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->
	<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">		<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">
	<Id Type="MyObjectBuilder_ProceduralWorldEnvironment" Subtype="Earth Environment" />		<Id Type="MyObjectBuilder_ProceduralWorldEnvironment" Subtype="Earth Environment" />
Line 158:		Line 159:
	<ItemGroup Density=".36" Name="Small Items" LodStart="0" LodEnd="0">...</ItemGroup>		<ItemGroup Density=".36" Name="Small Items" LodStart="0" LodEnd="0">...</ItemGroup>
	</Definition>		</Definition>
	</~~source~~>		</syntaxhighlight>


Line 174:		Line 175:
	=====EnvironmentItemTypesDefinition=====		=====EnvironmentItemTypesDefinition=====
	Here you define various types of items. Currently we have these types: Tree, Gatherable, Farmable, Static and Bot. Before you add any item, you must make sure it fits within these types of environment items or you created a new type for them.		Here you define various types of items. Currently we have these types: Tree, Gatherable, Farmable, Static and Bot. Before you add any item, you must make sure it fits within these types of environment items or you created a new type for them.
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Definition xsi:type="MyObjectBuilder_EnvironmentItemTypesDefinition">		<Definition xsi:type="MyObjectBuilder_EnvironmentItemTypesDefinition">
	<Id Type="MyObjectBuilder_EnvironmentItemTypesDefinition" Subtype="Default"/>		<Id Type="MyObjectBuilder_EnvironmentItemTypesDefinition" Subtype="Default"/>
Line 183:		Line 184:
	<Item Name="Bot">...</Item>		<Item Name="Bot">...</Item>
	</Definition>		</Definition>
	</~~source~~>		</syntaxhighlight>
	EnvironmentItemTypes		EnvironmentItemTypes
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Item Name="Tree">		<Item Name="Tree">
	<ProxyActivationLod>0</ProxyActivationLod>		<ProxyActivationLod>0</ProxyActivationLod>
Line 196:		Line 197:
	<ProxyActivationLod>0</ProxyActivationLod>This line says from which lod is the game logic attached to the environmental item. (when set on 0 only trees very close to you become “gatherable” and “cuttable”). This way we don’t use game logic on environmental items that couldn’t be used anyway and game is better optimized thanks to that.		<ProxyActivationLod>0</ProxyActivationLod>This line says from which lod is the game logic attached to the environmental item. (when set on 0 only trees very close to you become “gatherable” and “cuttable”). This way we don’t use game logic on environmental items that couldn’t be used anyway and game is better optimized thanks to that.
	</Item>		</Item>
	</~~source~~>		</syntaxhighlight>
	Available proxy and providers:		Available proxy and providers:

Line 202:		Line 203:
	====Assign environment to a planet====		====Assign environment to a planet====
	Last thing is to assign your brand new procedural environment to a planet where it is supposed to appear. Go to Content\Data\PlanetGenerator.sbc and find definition of the planet you want your environment to be on. Then assign the environment to the planet by adding following line to the planet definition with name of your environment:		Last thing is to assign your brand new procedural environment to a planet where it is supposed to appear. Go to Content\Data\PlanetGenerator.sbc and find definition of the planet you want your environment to be on. Then assign the environment to the planet by adding following line to the planet definition with name of your environment:
	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<Environment>		<Environment>
	<TypeId>MyObjectBuilder_ProceduralWorldEnvironment</TypeId>		<TypeId>MyObjectBuilder_ProceduralWorldEnvironment</TypeId>
	<SubtypeId>NAMEOFYOURENVIRONMENTDEFINITION</SubtypeId>		<SubtypeId>NAMEOFYOURENVIRONMENTDEFINITION</SubtypeId>
	</Environment>		</Environment>
	</~~source~~>		</syntaxhighlight>
	SutypeId refers to the name of the environment from:		SutypeId refers to the name of the environment from:
	Content\Data\Environment\ProceduralEnvironments.sbc		Content\Data\Environment\ProceduralEnvironments.sbc
Line 220:		Line 221:
	Ores are placed using blue channel of the material texture to set where should ore deposits appear. When your ore deposits are painted on the material map, you need to define what ores will be there. Go to Content\Data\Environment\ProceduralEnvironments.sbc to tell game which ore should appear at specific blue channel value.		Ores are placed using blue channel of the material texture to set where should ore deposits appear. When your ore deposits are painted on the material map, you need to define what ores will be there. Go to Content\Data\Environment\ProceduralEnvironments.sbc to tell game which ore should appear at specific blue channel value.

	<~~source~~ lang="xml">		<syntaxhighlight lang="xml" line>
	<OreMappings>		<OreMappings>
	<Ore Value="130" Type="IronOre_RichYield" Start="3" Depth="7" TargetColor="#b7340a" ColorInfluence="15 "/>		<Ore Value="130" Type="IronOre_RichYield" Start="3" Depth="7" TargetColor="#b7340a" ColorInfluence="15 "/>
Line 226:		Line 227:
	<Ore Value="110" Type="IronOre_PoorYield" Start="2" Depth="5" TargetColor="#a76a41" ColorInfluence="15" />		<Ore Value="110" Type="IronOre_PoorYield" Start="2" Depth="5" TargetColor="#a76a41" ColorInfluence="15" />
	</OreMappings>		</OreMappings>
	</~~source~~>		</syntaxhighlight>
	The section you need to use is Ore Mappings.		The section you need to use is Ore Mappings.
	<~~source~~ lang="xml"><Ore Value="120" Type="IronOre_RegularYield" Start="3" Depth="7" TargetColor="#b75e0a" ColorInfluence="15" /></~~source~~>		<syntaxhighlight lang="xml"><Ore Value="120" Type="IronOre_RegularYield" Start="3" Depth="7" TargetColor="#b75e0a" ColorInfluence="15" /></syntaxhighlight>
	Value refers to blue channel value on material texture.		Value refers to blue channel value on material texture.
	Type refers to name of a voxel material from Content\Data\VoxelMaterials.sbc.		Type refers to name of a voxel material from Content\Data\VoxelMaterials.sbc.

CptTwinkie at 10:54, 29 June 2018

2018-06-29T10:54:17Z

← Older revision		Revision as of 10:54, 29 June 2018
Line 1:		Line 1:
	<noinclude>{{SEO\|image_url=http://www.medievalengineerswiki.com/images/a/a7/MaterialMapBreakdown.jpg\|description=Material texture is used to store information about location of various planet surface features. These features are surface materials, biomes (trees, bots, plants,..etc) and where you can find ore.}}		<noinclude>{{SEO\|image_url=http://www.medievalengineerswiki.com/images/a/a7/MaterialMapBreakdown.jpg\|description=Material texture is used to store information about location of various planet surface features. These features are surface materials, biomes (trees, bots, plants,..etc) and where you can find ore.}}
	{{:~~Official Content/~~OCH}}		{{Keen:OCH}}

CptTwinkie: CptTwinkie moved page Official Content/Planet Modding/Material Texture to Keen:Planet Modding/Material Texture

2018-06-29T10:38:03Z

CptTwinkie moved page Official Content/Planet Modding/Material Texture to Keen:Planet Modding/Material Texture

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

CptTwinkie at 10:33, 29 June 2018

2018-06-29T10:33:36Z

← Older revision		Revision as of 10:33, 29 June 2018
Line 6:		Line 6:
	\|release=0\|major=4\|minor=X\|suppress=true}}		\|release=0\|major=4\|minor=X\|suppress=true}}
	[[Category:Keen Modding Guides]]</noinclude>		[[Category:Keen Modding Guides]]</noinclude>
	==[[~~Official Content/~~Planet Modding/Material Texture\|Material Texture modding]]==		==[[Keen:Planet Modding/Material Texture\|Material Texture modding]]==
	Material texture is used to store information about location of various planet surface features. These features are surface materials, biomes (trees, bots, plants,..etc) and where you can find ore. Each one of these uses one color channel. Surface materials use red channel. Biomes use green. Ores are in blue channel.		Material texture is used to store information about location of various planet surface features. These features are surface materials, biomes (trees, bots, plants,..etc) and where you can find ore. Each one of these uses one color channel. Surface materials use red channel. Biomes use green. Ores are in blue channel.
	We use 6 material textures (2048x2048) for each planet. You can find all our material textures here: Content\Data\PlanetDataFiles.		We use 6 material textures (2048x2048) for each planet. You can find all our material textures here: Content\Data\PlanetDataFiles.
Line 236:		Line 236:


	<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:50Z

← 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/a/a7/MaterialMapBreakdown.jpg\|description=Material texture is used to store information about location of various planet surface features. These features are surface materials, biomes (trees, bots, plants,..etc) and where you can find ore.}}
			{{:Official Content/OCH}}

CptTwinkie at 15:00, 30 May 2018

2018-05-30T15:00:26Z

← 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=4\|minor=X\|suppress=true}}		\|release=0\|major=4\|minor=X\|suppress=true}}
	[[Category:Keen Modding Guides]]</noinclude>		[[Category:Keen Modding Guides]]</noinclude>

CptTwinkie at 10:05, 13 April 2018

2018-04-13T10:05:25Z

← Older revision		Revision as of 10:05, 13 April 2018
Line 155:		Line 155:
	</Definition>		</Definition>
	</source>		</source>


	=====Environment items=====		=====Environment items=====

CptTwinkie: /* Definition elements explained */

2018-04-13T09:28:23Z

Definition elements explained

← Older revision		Revision as of 09:28, 13 April 2018
Line 119:		Line 119:
	<source lang="xml"><!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->		<source lang="xml"><!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->
	<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">		<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">
	<Id>		<Id Type="MyObjectBuilder_ProceduralWorldEnvironment" Subtype="Earth Environment" />
	~~<TypeId>~~MyObjectBuilder_ProceduralWorldEnvironment~~</TypeId>~~
	~~<SubtypeId>~~Earth Environment~~</SubtypeId>~~
	</Id>


Line 158:		Line 155:
	</Definition>		</Definition>
	</source>		</source>


	=====Environment items=====		=====Environment items=====

CptTwinkie at 08:16, 13 April 2018

2018-04-13T08:16:52Z

← Older revision		Revision as of 08:16, 13 April 2018
Line 13:		Line 13:
	[[File:Planet Material Texture Order.jpg\|512px]]		[[File:Planet Material Texture Order.jpg\|512px]]

	====The process of material texture creation is really simple. You have two options:====
	=====Copy an existing map to your folder and overwrite the green channel and edit them to your liking~~=====~~		====Texture creation====
			The process of material texture creation is really simple. You have two options:


			=====Modifying the vanilla texture=====
			Copy an existing map to your folder and overwrite the green channel and edit them to your liking
	This is highly recommended to avoid errors!		This is highly recommended to avoid errors!
	=====~~Create~~ a new~~: step by step in Photoshop~~=====

			=====Creating a new texture=====
			Step by step in Photoshop:
	#Set both width and height to 2048 pixels		#Set both width and height to 2048 pixels
	#(for smaller planets this can also be 1024 or less, but all textures need to have the same resolution! Even the heightmap)		#(for smaller planets this can also be 1024 or less, but all textures need to have the same resolution! Even the heightmap)
Line 24:		Line 32:
	#Never on all three at once! (It will F. up everything - trust me).		#Never on all three at once! (It will F. up everything - trust me).

	===Surface ~~voxel~~ material definitions ~~modding -~~ grass, sand, snow===
			===Surface material definitions (grass, sand, snow)===

	[[File:RedChannel.jpg\|22px\|frameless]]		[[File:RedChannel.jpg\|22px\|frameless]]
Line 45:		Line 54:

	[[File:RoadMaterialTextureExample.png\|512px]]		[[File:RoadMaterialTextureExample.png\|512px]]


	====Complex materials====		====Complex materials====
Line 89:		Line 99:
	</source>		</source>

	===Biomes definitions ~~modding -~~ trees, plants and bots===
			===Biomes definitions (trees, plants and bots)===
	[[File:GreenChannel.jpg\|frameless\|22px]]		[[File:GreenChannel.jpg\|frameless\|22px]]

	Biomes refers to everything that is spawned on top of the planet. We use green channel of the material texture to set where all the terrain features appear and definitions in the Content\Data\Environment\ProceduralEnvironments.sbc to tell game which environment item should appear at specific green channel value. Also you need to assign Environment to planet in the Content\Data\PlanetGenerator.sbc in case you are adding a brand new planet.		Biomes refers to everything that is spawned on top of the planet. We use green channel of the material texture to set where all the terrain features appear and definitions in the Content\Data\Environment\ProceduralEnvironments.sbc to tell game which environment item should appear at specific green channel value. Also you need to assign Environment to planet in the Content\Data\PlanetGenerator.sbc in case you are adding a brand new planet.

	====~~First make/~~modify environment:====
			====Make or modify environment:====
	Go to Content\Data\Environment\ProceduralEnvironments.sbc		Go to Content\Data\Environment\ProceduralEnvironments.sbc

	=====Procedural ~~World~~ Environment definition=====
			=====Procedural Environment definition=====
	This definition defines where will the environmental items spawn and with which density. (note: bots are also considered environmental item). Best way to explain how procedural environment is working is to imagine that it puts spots on entire surface of a planet. And when you start defining trees, bots and bushes, the spots get “reserved” by these categories based on how many of those should appear in the world according to your mod.		This definition defines where will the environmental items spawn and with which density. (note: bots are also considered environmental item). Best way to explain how procedural environment is working is to imagine that it puts spots on entire surface of a planet. And when you start defining trees, bots and bushes, the spots get “reserved” by these categories based on how many of those should appear in the world according to your mod.
	Spots are always different for each single planet.		Spots are always different for each single planet.
	In order to mod the procedural environment, mod our “Earth Environment” definition. Or create your own but if you do, don’t forget to also mod PlanetGeneratorDefinition, so that planet has your new procedura environment assigned to it.		In order to mod the procedural environment, mod our “Earth Environment” definition. Or create your own but if you do, don’t forget to also mod PlanetGeneratorDefinition, so that planet has your new procedura environment assigned to it.

	=====Definition elements explained ~~point by point:~~=====
			=====Definition elements explained=====
	<source lang="xml"><!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->		<source lang="xml"><!-- This part of definition is called ID. It says what type of definition this is <TypeID> and unique name of that definition <SubtypeID>. -->
	<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">		<Definition xsi:type="MyObjectBuilder_ProceduralWorldEnvironment">
Line 144:		Line 158:
	</Definition>		</Definition>
	</source>		</source>


	=====Environment items=====		=====Environment items=====
Line 154:		Line 169:

	If you want to mod bots:		If you want to mod bots:


	=====EnvironmentItemTypesDefinition=====		=====EnvironmentItemTypesDefinition=====
Line 181:		Line 197:
	</source>		</source>
	Available proxy and providers:		Available proxy and providers:


	====Assign environment to a planet====		====Assign environment to a planet====
Line 196:		Line 213:
	''Note: This is not necessary if you just modded existing vanilla environment and have not changed its SubtypeID''		''Note: This is not necessary if you just modded existing vanilla environment and have not changed its SubtypeID''

	===Ores definitions ~~modding~~===
			===Ores definitions===
	[[File:BlueChannel.jpg\|frameless\|22px]]		[[File:BlueChannel.jpg\|frameless\|22px]]

CptTwinkie at 20:12, 12 April 2018

2018-04-12T20:12:49Z

← Older revision		Revision as of 20:12, 12 April 2018
Line 215:		Line 215:
	TargetColor is color that will be used to color surface above the ore.		TargetColor is color that will be used to color surface above the ore.
	ColorInfluence sets strenght of coloring.		ColorInfluence sets strenght of coloring.


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