Adding PBR to your mod

From Valve Developer Community
Jump to: navigation, search
Left: Base Source Engine shaders.
Right: The PBR shader.

The goal of this article is to show you how to implement Thexa4's PBR shader into your own Source SDK 2013 mod. Implementing this shader will allow you to use the metalness/roughness PBR workflow in materials.

Introduction

Main article: Physically Based Rendering

Requirements

  • Ability to compile shaders.
  • Ability to compile the solution.


Note:If you do not know how to compile shaders, or haven't worked with shaders in Source yet, it is advised that you follow and understand these articles first: Shader Authoring & Your First Shader

Implementation

Before doing anything, we need to download the files we need.


You can do this by going to the links below, clicking the "Raw" button and once the page has loaded right-click and select "Save As...".

Then all you have to do is save each one of the files to your Source mod's code directory under src/materialsystem/stdshaders/.


After you've finished saving the files, open the game_shader_dx9_*.vpc file appropriate for your situation (base/hl2mp/hl2/episodic), and add the PBR files within $Project "Shaders" like so:

$Project "Shaders"
{
	$Folder "fxc"
	{
		$File	"pbr_ps30.fxc"
		$File	"pbr_vs30.fxc"
	}

	$Folder "Source Files"
	{
		$File	"pbr_dx9.cpp"
	}
}

We do this so that when we refresh the solution they will appear in the solution explorer.

Shader Compilation

We need to compile the shaders that we have before we can use them. Create a file in src/materialsystem/stdshaders/ named mymod_dx9_30.txt and add this inside of it:

//
// vs 3.0   ps 3.0   shaders collection
//
//  These shaders are forced to compile as shader model 3.0
//  using the new compiler.
//	    _ps30.vcs
//	    _vs30.vcs
//

// There are no examples of such shaders in the SDK, but add yours here.

pbr_vs30.fxc
pbr_ps30.fxc

Adding a new text file for shader compilation will allow you to compile the PBR shaders without affecting the standard LightmappedGeneric shaders.

This will also reduce compile times significantly.


Now open the buildsdkshaders.bat file using Notepad and edit this part below from:

%BUILD_SHADER% stdshader_dx9_20b		-game %GAMEDIR% -source %SOURCEDIR%
%BUILD_SHADER% stdshader_dx9_30			-game %GAMEDIR% -source %SOURCEDIR% -dx9_30	-force30 

To:

%BUILD_SHADER% mymod_dx9_20b		        -game %GAMEDIR% -source %SOURCEDIR%
%BUILD_SHADER% mymod_dx9_30			-game %GAMEDIR% -source %SOURCEDIR% -dx9_30	-force30 

This will allow you to use the custom text file that we made earlier to compile our PBR shader.


After that, we can now start the shader compilation by running buildhl2mpshaders.bat, buildhl2shaders.bat or buildepisodicshaders.bat depending on your mod's base.

Make sure you've followed the Shader Authoring article to the point where the newly compiled shaders will be properly placed on your mod's shaders/fxc/ folder.

Note:Depending on your PC and the complexity of the shader, it might take a while.


If the shaders compile without problems, go back to your source code directory /src/ and run createallprojects.bat.

Run the solution and build shaders in Release.

Note:If pbr_dx9.cpp does not exist in the Shader project. Make sure that you've properly included it in the .vpc file you edited earlier.

VMT Setup

Here is an example VMT, something you would use on a model:

PBR
{
        $basetexture  "models\props\pbr_asset_d"
        $bumpmap      "models\props\pbr_asset_n"
        $mraotexture  "models\props\pbr_asset_mrao"
        $emissive     "models\props\pbr_asset_e"

        $envmap       "env_cubemap"
        $model        "1"
}

$basetexture

Will be the Base Color texture.

$bumpmap

Will be the Normal texture.

$mraotexture

Will be the MRAO texture.

$emissive

Will be for any glowing sections of the model.


Note:The Emissive texture is a color texture, not a mask.
Note:$envmap should just be left as env_cubemap.

Warning: $model 1 MUST be added for models to work!

Fixes

Physics props turn black when used with the PBR shader after 2-3 seconds due to Prop Sleeping. After a set time, props "bake" their lighting for optimization.

You can bypass this by typing r_PhysPropStaticLighting 0 on the console or by hardcoding it in src/game/client/c_physicsprop.cpp.


Here is how you can hardcode it:

Above #include "tier0/memdbgon.h" add this:

#define PBR_CHANGE

Then find ConVar r_PhysPropStaticLighting("r_PhysPropStaticLighting", "1"); and turn it into this:

#ifdef PBR_CHANGE
	ConVar r_PhysPropStaticLighting( "r_PhysPropStaticLighting", "0" );
#else
	ConVar r_PhysPropStaticLighting( "r_PhysPropStaticLighting", "1" );
#endif

Conclusion

And that's it! You should now have PBR in your mod.


You can find a list of all the shader parameters you can use when creating materials here:

https://wiki.empiresmod.com/PBR

Parameters

  • $basetexture - The albedo texture
  • $normaltexture - Sets the normal map (for backwards compatibility)
  • $bumpmap - Sets the normal map (new way of setting normalmap)
  • $mraotexture - A texture with the metalness on the red channel, roughness on the green channel and ambient occlusion on the blue channel.
  • $envmap - Defaults to "env_cubemap", allows you to use a custom one.
  • $surfaceprop - One of the following: https://developer.valvesoftware.com/wiki/$surfaceprop
  • $model - Should have a value of "1" if the texture is used on a prop.
  • $translucent - Setting this to "1" enables alpha blending.
  •  %keywords - A list of keywords separated by commas, should contain 'empires' as first element. Examples of keywords are: architectural,brown,gray,grime,hanger,industrial,metal,modern,shed,urban,wall,floor
  • $basetexturetransform - Looks like this: "center 0.5 0.5 scale 0.1025 0.1025 rotate 0 translate 0 0" for a 2m by 2m texture.
  • $alphatest <0|1> - Enables clipping the pixel when the alpha goes below $alphatestreference.
  • $alphatestreference <float> -
  • $emissiontexture - Allows setting an emission texture. Enabled self illumination.
  • $useEnvAmbient <0|1> - Makes it use the lowest mip level of the cubemap for ambient light instead of the ambient cubes. Can cause artifacts with moving props.
  • $speculartexture - Enables use of colored F0 (specular map), overrides metalness from MRAO texture

Examples

Brush (non-model surfaces) material example

"PBR"
{
 "$basetexture"   "mymod/newtexture_albedo"
 "$bumpmap"       "mymod/newtexture_normal"
 "$mraotexture"   "mymod/newtexture_mrao"

 "$surfaceprop"   "metal"
 "$model"         "0"
}

Model material example

"PBR"
{
 "$basetexture"   "mymod/newtexture_albedo"
 "$bumpmap"       "mymod/newtexture_normal"
 "$mraotexture"   "mymod/newtexture_mrao"

 "$surfaceprop"   "metal"
 "$model"         "1"
}

Model material example with specular map

Note:Metalness channel is ignored and $basetexture is treated as diffuse.
"PBR"
{
 "$basetexture"       "mymod/newtexture_diffuse"
 "$bumpmap"           "mymod/newtexture_normal"
 "$mraotexture"       "mymod/newtexture_mrao"
 "$speculartexture"   "mymod/newtexture_specular"

 "$surfaceprop"       "metal"
 "$model"             "1"
}