Temp-new mod materials - Revision history

Jayelinda: /* ColourSecondaryMaskParam (Texture Parameters) */

2021-11-16T23:57:32Z

ColourSecondaryMaskParam (Texture Parameters)

← Older revision		Revision as of 15:57, 16 November 2021
Line 47:		Line 47:
	This group of parameters controls the diffuse map of the material. See [[#Texture Parameter Data\|'''Texture Parameter Data''']], below.		This group of parameters controls the diffuse map of the material. See [[#Texture Parameter Data\|'''Texture Parameter Data''']], below.

	=== ~~DiffuseTextureToColourLerp~~ (Scalar Parameters) ===		=== Diffuse Texture To Colour Lerp (Scalar Parameters) ===
	This group of parameters controls the value for lerping from the given diffuse texture to the diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the value for lerping from the given diffuse texture to the diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.

Line 55:		Line 55:
	This colour is blended with the main colour using the texture specified in Colour Secondary Mask Param.		This colour is blended with the main colour using the texture specified in Colour Secondary Mask Param.

	=== ~~ColourSecondaryMaskParam~~ (Texture Parameters) ===		=== Colour Secondary Mask Param (Texture Parameters) ===
	This group of parameters controls the mask that blends between the primary and secondary colours of the material. See [[#Texture Parameter Data\|'''Texture Parameter Data''']], below.		This group of parameters controls the mask that blends between the primary and secondary colours of the material. See [[#Texture Parameter Data\|'''Texture Parameter Data''']], below.

Jayelinda: /* ColourSecondaryParam (Vector Parameters) */

2021-11-16T23:56:09Z

ColourSecondaryParam (Vector Parameters)

← Older revision		Revision as of 15:56, 16 November 2021
Line 50:		Line 50:
	This group of parameters controls the value for lerping from the given diffuse texture to the diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the value for lerping from the given diffuse texture to the diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.

	=== ~~ColourSecondaryParam~~ (Vector Parameters) ===		=== Colour Secondary Param (Vector Parameters) ===
	This group of parameters controls the secondary diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the secondary diffuse colour of the material. See [[#Combined Parameter Data\|'''Combined Parameter Data''']], below.

			This colour is blended with the main colour using the texture specified in Colour Secondary Mask Param.

	=== ColourSecondaryMaskParam (Texture Parameters) ===		=== ColourSecondaryMaskParam (Texture Parameters) ===

Jayelinda at 23:51, 16 November 2021

2021-11-16T23:51:45Z

Show changes

Jayelinda at 23:51, 16 November 2021

2021-11-16T23:51:13Z

← Older revision		Revision as of 15:51, 16 November 2021
Line 33:		Line 33:

	=== Material Type ===		=== Material Type ===

	The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.		The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.

Jayelinda: /* Roughness Texture Param (Texture Parameters) */

2021-11-16T22:53:52Z

Roughness Texture Param (Texture Parameters)

← Older revision		Revision as of 14:53, 16 November 2021
Line 51:		Line 51:
	This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.
	=== Roughness Texture Param (Texture Parameters) ===		=== Roughness Texture Param (Texture Parameters) ===
	This group of parameters controls the roughness map of the material. See [[#Texture Data\|'''Texture Data''']], below.		This group of parameters controls the roughness map of the material. See [[#Texture Parameter Data\|'''Texture Parameter Data''']], below.

	=== Metallic Param (Scalar Parameters) ===		=== Metallic Param (Scalar Parameters) ===

Jayelinda at 22:52, 16 November 2021

2021-11-16T22:52:10Z

← Older revision		Revision as of 14:52, 16 November 2021
Line 18:		Line 18:

	= Material Export Parameters =		= Material Export Parameters =
	This is the data attached to Automation materials to help the BeamNG exporter know how to interpret these materials in order to build one that works in BeamNG. Developed after all attempts at naming conventions failed, it ~~lists~~ material ~~parameter names according to the function those parameters perform~~, as well as a few other bits of information that the exporter needs to know about.		This is the data attached to Automation materials to help the BeamNG exporter know how to interpret these materials in order to build one that works in BeamNG. Developed after all attempts at naming conventions failed, it basically defines the naming convention used by the material, as well as storing a few other bits of information that the exporter needs to know about.

	Many of the parameters use the '''Combined Parameter Data''' ~~type~~, which ~~allows~~ a group of parameters to be combined into one for export.		Many of the parameters use the '''Combined Parameter Data''' and '''Texture Data''' types, which allow a group of parameters to be combined into one for export.

	* An exported material defaults to a colour and opacity of #FFFFFFFF. This is a hexadecimal colour of "White, and completely opaque."		* An exported material defaults to a colour and opacity of #FFFFFFFF. This is a hexadecimal colour of "White, and completely opaque."
Line 35:		Line 35:
	The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.		The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.

	* '''Grille''' - ~~The exporter will create~~ a ~~proper two layered material~~ and ~~generate~~ a ~~blend map. One layer is chrome, the other is~~ black.		* '''Grille''' - A material using a mask to blend between metal and a (usually black) background.
	* '''Clear Glass''' - For transparent glass materials.		* '''Clear Glass''' - For transparent glass materials.
	* '''Decal''' - ~~This is~~ for ~~multicoloured decals. Because these don’t work in a consistent way in Automation,~~ the ~~output is hard-coded for each base material~~. ~~Don’t use~~ this ~~value for a brand~~ new ~~material as the exporter won’t know what to do with it~~.		* '''Decal''' - One of a set series of materials each with custom handling for the diffuse texture. Do not put this type on new materials.
	* '''Other''' - default behaviour. If in doubt, use this value.		* '''Other''' - default behaviour. If in doubt, use this value.

	=== Colour Param (Vector Parameters) ===		=== Colour Param (Vector Parameters) ===
	This group of parameters controls the diffuse colour of the material. See '''[[Mods and the Beam.NG Exporter#Combined Parameter Data\|Combined Parameter Data]]''', below.		This group of parameters controls the diffuse colour of the material. See '''[[Mods and the Beam.NG Exporter#Combined Parameter Data\|Combined Parameter Data]]''', below.


	=== Opacity Param (Scalar Parameters) ===		=== Opacity Param (Scalar Parameters) ===
	This group of parameters controls the opacity of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the opacity of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.


	=== Roughness Param (Scalar Parameters) ===		=== Roughness Param (Scalar Parameters) ===
	This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.
			=== Roughness Texture Param (Texture Parameters) ===
			This group of parameters controls the roughness map of the material. See [[#Texture Data\|'''Texture Data''']], below.

	=== Metallic Param (Scalar Parameters) ===		=== Metallic Param (Scalar Parameters) ===
	This group of parameters controls the metallic value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the metallic value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.
			=== Metallic Texture Param (Texture Parameters) ===
			This group of parameters controls the metallic map of the material. See [[Mods and the Beam.NG Exporter#Texture Data\|'''Texture Data''']], below.

	=== Specular Param (Scalar Parameters) ===		=== Specular Param (Scalar Parameters) ===
	This group of parameters controls the specular value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the specular value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.
			=== Specular Texture Param (Texture Parameters) ===
			This group of parameters controls the specular value map of the material. See [[Mods and the Beam.NG Exporter#Texture Data\|'''Texture Data''']], below.

	~~=== Diffuse Tex Param Name ===~~
	~~The name of the parameter that refers to the diffuse texture.~~

	== Extra Parameters ==		== Extra Parameters ==
Line 124:		Line 130:
	=== Value Override ===		=== Value Override ===
	If Override is true, this value will be used for the parameter instead of the named material parameter.		If Override is true, this value will be used for the parameter instead of the named material parameter.

			= Texture Parameter Data =
			This data allows for the various ways textures are defined for Automation materials.

			=== Param Name (Texture Parameter) ===
			The main parameter for the value.

			=== Param Name List (Texture Parameters) ===
			Some materials select a texture from a list, instead of just defining one.

			This list takes priority over Param Name.

			=== Param Name Selector (Scalar Parameter) ===
			This parameter controls the selection from the above list. It has no effect if the list is empty. The value of the parameter should be a normalised (0 - 1) value.

			=== Mask Channel ===
			If the texture being defined is a single-coloured mask, this allows you to specify which channel of the Automation texture is being used as the mask.

Jayelinda at 22:37, 16 November 2021

2021-11-16T22:37:38Z

← Older revision		Revision as of 14:37, 16 November 2021
Line 103:		Line 103:
	This data allows for a group of parameters to be combined into one for export.		This data allows for a group of parameters to be combined into one for export.

	Unless Override has been set, the final value for the material will be an interpolation between [Name] and [Name2] by [Lerp][Lerp Power].		Unless Override has been set, the final value for the material will be an interpolation between [Name] and [Name2] by [Lerp]<sup>[Lerp Power]</sup>.

	The Name and Name2 parameters will both either be for scalar or vector parameters.		The Name and Name2 parameters will both either be for scalar or vector parameters.

Jayelinda: New Materials params pass 1

2021-11-16T22:33:15Z

New Materials params pass 1

← Older revision		Revision as of 14:33, 16 November 2021
Line 1:		Line 1:
	New material ~~paramters~~		New material parameters

	Car body and fixture mods should in theory export to Beam.NG just like the built in bodies and fixtures. If it works in Automation, then the exporter should be able to deal with it. One exception to this is custom materials.		Car body and fixture mods should in theory export to Beam.NG just like the built in bodies and fixtures. If it works in Automation, then the exporter should be able to deal with it. One exception to this is custom materials.
Line 38:		Line 38:
	* '''Clear Glass''' - For transparent glass materials.		* '''Clear Glass''' - For transparent glass materials.
	* '''Decal''' - This is for multicoloured decals. Because these don’t work in a consistent way in Automation, the output is hard-coded for each base material. Don’t use this value for a brand new material as the exporter won’t know what to do with it.		* '''Decal''' - This is for multicoloured decals. Because these don’t work in a consistent way in Automation, the output is hard-coded for each base material. Don’t use this value for a brand new material as the exporter won’t know what to do with it.
	* '''Number Plate''' - Another one that needs a two-layered material, one for the plate background and one for the numbering/lettering.
	* '''Badge, Mirror''' - These are treated the same as “Metal” for BeamNG, though custom exporters may wish to separate them.
	* '''Metal''' - For metallic materials. These default to full metallic and specular values, if those parameters are not specified.
	* '''Black Plastic, Carbon Fiber, Leather, Opaque Glass''' - These are treated the same as “Other” for BeamNG, though custom exporters may wish to separate them.
	* '''Other''' - default behaviour. If in doubt, use this value.		* '''Other''' - default behaviour. If in doubt, use this value.

	=== Colour Param ===		=== Colour Param (Vector Parameters) ===
	This group of parameters controls the diffuse colour of the material. See '''[[Mods and the Beam.NG Exporter#Combined Parameter Data\|Combined Parameter Data]]''', below.		This group of parameters controls the diffuse colour of the material. See '''[[Mods and the Beam.NG Exporter#Combined Parameter Data\|Combined Parameter Data]]''', below.

	=== Opacity Param ===		=== Opacity Param (Scalar Parameters) ===
	This group of parameters controls the opacity of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the opacity of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.

	=== Roughness Param ===		=== Roughness Param (Scalar Parameters) ===
	This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.

	=== Metallic Param ===		=== Metallic Param (Scalar Parameters) ===
	This group of parameters controls the metallic value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the metallic value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.

	=== Specular Param ===		=== Specular Param (Scalar Parameters) ===
	This group of parameters controls the specular value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.		This group of parameters controls the specular value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data\|'''Combined Parameter Data''']], below.

Line 106:		Line 102:
	= Combined Parameter Data =		= Combined Parameter Data =
	This data allows for a group of parameters to be combined into one for export.		This data allows for a group of parameters to be combined into one for export.

			Unless Override has been set, the final value for the material will be an interpolation between [Name] and [Name2] by [Lerp][Lerp Power].

			The Name and Name2 parameters will both either be for scalar or vector parameters.

	=== Param Name ===		=== Param Name ===
Line 113:		Line 113:
	The second parameter for the value. Many Automation materials blend between colours or other values via a noise/bump map or via some other user or child driven value. Because BeamNG needs a single value, we need to do the blending once for the whole material.		The second parameter for the value. Many Automation materials blend between colours or other values via a noise/bump map or via some other user or child driven value. Because BeamNG needs a single value, we need to do the blending once for the whole material.

	=== Param Name Lerp ===		=== Param Name Lerp (Scalar Parameter) ===
	This parameter, if named, controls the blending between the values of Param Name and Param Name 2. If Param Name 2 is empty, this value has no effect. ~~If this value~~ is ~~empty but~~ Param Name 2 is ~~not,~~ the ~~two values will be averaged~~.		This parameter, if named, controls the blending between the values of Param Name and Param Name 2. If Param Name 2 is empty, this value has no effect. This defaults to 0.5 if no valid parameter is specified.

			=== Param Name Lerp Power (Scalar Parameter) ===
			This parameter is an exponent applied to the value of the lerp parameter. This defaults to 1.0 if no valid parameter is specified.

	=== Override ===		=== Override ===

Jayelinda: Created page with "New material paramters Car body and fixture mods should in theory export to Beam.NG just like the built in bodies and fixtures. If it works in Automation, then the exporter s..."

2021-11-16T22:08:01Z

Created page with "New material paramters Car body and fixture mods should in theory export to Beam.NG just like the built in bodies and fixtures. If it works in Automation, then the exporter s..."

New page

New material paramters

Car body and fixture mods should in theory export to Beam.NG just like the built in bodies and fixtures. If it works in Automation, then the exporter should be able to deal with it. One exception to this is custom materials.
=Custom Materials=
When the exporter exports a material, it checks which base material is being used and chooses from a series of built-in handlers based on that. Custom materials that are material instances of existing car/fixture materials should already export properly. Where possible, it’s best to use instances of existing materials rather than create new ones.
==Textures==
Pixel formats (selected in the “Compression settings” dropdown) supported by the exporter:
* RGBA8
* DTX1/BC1
* DXT3/BC2
* DXT5/BC3
* BC4 (Alpha)
* BC5 (Normal map)

RGBA textures will be saved with DTX5/BC3 compression by the exporter.

For best results on export, make sure the “Global Force Resident Mip Levels” option is ticked on, otherwise the texture may export down-resed, depending on whether or not Unreal feels like loading the full resolution texture at that time.

= Material Export Parameters =
This is the data attached to Automation materials to help the BeamNG exporter know how to interpret these materials in order to build one that works in BeamNG. Developed after all attempts at naming conventions failed, it lists material parameter names according to the function those parameters perform, as well as a few other bits of information that the exporter needs to know about.

Many of the parameters use the '''Combined Parameter Data''' type, which allows a group of parameters to be combined into one for export.

* An exported material defaults to a colour and opacity of #FFFFFFFF. This is a hexadecimal colour of "White, and completely opaque."
* If a vector or texture parameter is specified in the Colour Param or Diffuse Tex variables within the Export Material User Data, those variables will be used for the colour of the exported material.
* If both are specified, they will be multiplied together.
* The exported opacity is assumed to be 1 (completely opaque) if no Alpha Param is specified. if a Diffuse Tex variable is specified, then the opacity is defined by the alpha channel of the texture. If the texture is single-channel, it is assumed to be an alpha texture as well as a diffuse texture. If a texture is RGB without an alpha, the alpha is unaffected by the diffuse tex.

== To Add ==
To add export parameters, click the plus icon next to Asset User Data, in the material editor. In the dropdown that appears, select "Export Material User Data".

== Basic Parameters ==

=== Material Type ===
The type of material. Some materials need special handling by the exporter. The type is used to help determine these. If in doubt as to the correct type, leave it as the default (Other) value.

* '''Grille''' - The exporter will create a proper two layered material and generate a blend map. One layer is chrome, the other is black.
* '''Clear Glass''' - For transparent glass materials.
* '''Decal''' - This is for multicoloured decals. Because these don’t work in a consistent way in Automation, the output is hard-coded for each base material. Don’t use this value for a brand new material as the exporter won’t know what to do with it.
* '''Number Plate''' - Another one that needs a two-layered material, one for the plate background and one for the numbering/lettering.
* '''Badge, Mirror''' - These are treated the same as “Metal” for BeamNG, though custom exporters may wish to separate them.
* '''Metal''' - For metallic materials. These default to full metallic and specular values, if those parameters are not specified.
* '''Black Plastic, Carbon Fiber, Leather, Opaque Glass''' - These are treated the same as “Other” for BeamNG, though custom exporters may wish to separate them.
* '''Other''' - default behaviour. If in doubt, use this value.

=== Colour Param ===
This group of parameters controls the diffuse colour of the material. See '''[[Mods and the Beam.NG Exporter#Combined Parameter Data|Combined Parameter Data]]''', below.

=== Opacity Param ===
This group of parameters controls the opacity of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data|'''Combined Parameter Data''']], below.

=== Roughness Param ===
This group of parameters controls the roughness of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data|'''Combined Parameter Data''']], below.

=== Metallic Param ===
This group of parameters controls the metallic value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data|'''Combined Parameter Data''']], below.

=== Specular Param ===
This group of parameters controls the specular value of the material. See [[Mods and the Beam.NG Exporter#Combined Parameter Data|'''Combined Parameter Data''']], below.

=== Diffuse Tex Param Name ===
The name of the parameter that refers to the diffuse texture.

== Extra Parameters ==

=== Alpha Cutoff Name ===
This parameter determines the alpha cutoff, or the point where the pixel being rendered gets culled.

=== Secondary Colour ===
This is a secondary colour parameter. Not currently used.

=== Multi Colour Decal Texture ===
This parameter identifies the texture for a multicoloured decal.

== Normal Map ==

=== Bypass Normal Map ===
If true, this material will not be exported with a normal map.

=== Normal Switch Name ===
The name of the switch parameter that turns normal mapping on/off for this material.

=== Explicit Normal Map ===
Normally, the exporter will pull out all of the textures in a material and use the first one it finds with the normal map pixel type as the material’s normal map. If the material has a 'detail normal' and a 'normal map', or multiple normal maps, the explicit normal map should be set to 'normal map' (or the same name as the variable name of the texture you want to be the normal map).

== UV Tiling ==
UV tiling in Automation uses all kinds of projection maths that is not available to us in BeamNG. These parameters are used to help us get something that looks approximately right, though it will likely never be an exact match.

Because BeamNG does not support UV offset and scale, the UV data in the mesh vertices need to be modified for tiled UVs to work.

=== UV Tiling ===
The name of the parameter that controls UV tiling.

=== V Stretch ===
This parameter controls a scaling multiplier in the Z axis of the object. Only has effect if World Scaled UVs is true.

=== World Scaled UVs ===
If true, the UV scale is determined by the size of the mesh.

=== Uniform Scaled UVs ===
If true, UV scale values are forced to be the same in all 3 axes. Only has effect if World Scaled UVs is true.

=== Force Rescale UVs ===
If true, overrides the meshes UVs to a Z-projected (top-down) version of the vertex position, scaled to 2cm per UV tile.

= Combined Parameter Data =
This data allows for a group of parameters to be combined into one for export.

=== Param Name ===
The main parameter for the value. If Param Name 2 is empty, this will be the only parameter used and its value will be exported as is.

=== Param Name 2 ===
The second parameter for the value. Many Automation materials blend between colours or other values via a noise/bump map or via some other user or child driven value. Because BeamNG needs a single value, we need to do the blending once for the whole material.

=== Param Name Lerp ===
This parameter, if named, controls the blending between the values of Param Name and Param Name 2. If Param Name 2 is empty, this value has no effect. If this value is empty but Param Name 2 is not, the two values will be averaged.

=== Override ===
If set to true, the above parameter names will be ignored in favour of the given override value.

=== Value Override ===
If Override is true, this value will be used for the parameter instead of the named material parameter.