View source for Texturing the mesh in Substance 3D Painter

 Prerequisites
 [[Configuring Substance Painter]]
 [[Modeling the mesh in Blender]]

== Setup ==

# Create a '''New Project'''.
## Select the <code>Kerbal_Space_Program_2_Parts_Paintable</code> template.
## Select your part model's '''FBX''' file.
## Choose a '''Document Resolution''', for small parts 2048 should be enough but for anything larger 4096 is recommended.
## Press '''OK''' to create your project.
# Make sure the UV map looks ok in Substance Painter, if you spot any errors, overlapping faces, etc... You need to go back to UV unwrapping in [[Modeling the mesh in Blender]].
# Import any 3rd party resources you might want to use, you can do so by following the steps in [[Configuring Substance Painter]].

== General texturing tips ==

# Find the <code>KSP2_Part</code> '''Smart Material''' and apply it to the mesh. You can delete the default layer.
# Locate the '''Bake''' button (looks like a croissant) in the upper right of Substance Painter and click it.
## '''Uncheck''' the option to make an '''Opacity Mesh Map'''.
## Click the large blue '''Back Selected Textures''' button.
## When baking is done, click the '''Return to Painting Mode''' button.
# Expand the folder by the <code>KSP2_Part</code> smart material in the '''Layers''' panel and the <code>Base Material</code> smart material within.
# Some stuff might already be on the Edges layer that applies to the Heightmap (thus the orange bar under it). You should clear the black mask on Edges to get rid of those. Just right click on the black mask and select Clear Mask.

=== Simple material ===
You can drop any materials (smart or otherwise) into the Base Material folder inside the KSP2_Part folder. These are what you use for most details, with the exceptions being some things you'll do on Nails, or Edges, or Emissivity. Since applying the KSP2 smart material to the whole thing includes applying a KSP2 Steel material without a mask inside the Base Material folder, everything will start out as a shiny steel. Leave this as the last layer in that stack to catch anything not otherwise painted, and put other painting layers above it with masks.
Example ''"white boron nitride ceramic"'':

# Click the Add Fill Layer button (paint can) ''<INSERT GRAPHIC HERE>''.
# Drag the new fill layer onto the Base Material folder.
# In the Propertied panel under Materials, leave only color, roughness, and metal selected.
# In the Properties panel set the base color to what you need (white in this case).
# Set the metallic slider to 1.0.
# Set the roughness slider to 0.3.
# Add a black mask to the fill layer.
# Paint like a pro.

=== Paint map ===
For paint map, just open up the PaintMap folder and apply whatever strength you need to the black masks for Base and Accent.

This works just like painting on any other black mask. Mostly, you'll just apply full strength to indicate (yes, please apply the player's base or accent paint color here). Using anything less would result in the player's attempt to paint the part being diluted. You need to paint Base everywhere you want any color (accent or base), and then also paint Accent where you want the accent paint to be applied.

If there is no base paint somewhere, then whatever you paint in Substance Painter will be what the player gets and they can't change it.
 Did you know?
 
 The height channel induces a real deformation of the mesh (works well with a lot of polygons) while the normal channel is a bumb map.
 
 Substance 3D Painter converts Roughness to Glossiness automatically. The export template uses the Glossiness channel.

=== Creating gradients ===
# You must bake at some point before this, and your bake must include Position as we'll need that. If you've already baked your model in SP, you don't need to do it again.
# Starting with an Emissive layer (you can have more than one if you need more than one color - just duplicate and customize), paint at full strength (1.0) on the black mask everywhere you want the gradient to be.
# Right Click the black mask and pick the <code>add generator</code> option.
# Click on the resulting <code>Generator (no generator selected)</code> button, and pick the second option from the left for <code>3D Linear Gradient</code>.
# The Image inputs should default to Position, so just switch your display from Material or whatever to Position and orient your part so you can see the point where you want the 0 for the gradient to be like this (the display picker is in the upper right corner of the panel with your 3D view).
# Take the eye dropper from the <code>3D Position End</code> and click on the place you want the End to be. This assumes that the <code>Start</code> is already where you want one endpoint of the gradiant to be, as it is in the view above. If you oriented your model so that the <code>End</code> is already where you want it, then use the other eye dropper and set the start. The objective is that you've got the Position mapped colors pinning down the range across which you want the gradient to go. Don't worry if <code>Start</code> and <code>End</code> are reversed from what you want because...
# Set Invert to be <code>True</code> if the gradient is going the wrong way! (as it is in the example above).
# ''Most Important!'' Set the generator to apply as <code>Multiply</code> (it will default to <code>Normal</code>). This is the part where the work done on Step 2 will help you as it will then correctly constrain where the gradient is applied.
# When you're all done, you can set your display to <code>Mask</code> so you can see how the gradient will be applied to whatever color you set for your Emissive. BTW, there's nothing magical or special about the name for the layer. If you chance it to <code>Engine Glow</code> or <code>Emissive 1</code> or whatever it will still add to the emissive <code>*_e.png</code> texture as that is how the Emissive layer was setup when you applied the KSP2 Smart Material.

=== Nails ===
This is where you add various surface details via the height map, and works for painting on nuts, bolts, fasteners, etc. All of these can be added as “alphas” like this:

# Import your alpha(s)!
# In Layers, select the black mask for Nails in the Heightmap.
# Select Radial Symmetry (for applications around radially symmetric parts like I've got here).
# Set your X, Y, Z point about which things will be symmetric, where Y is the vertical. (Switch the Show/Hide Manipulator on to help see where this point is in your model).
# Set Mirror Y, the count you want, and the angular span the radial pattern should follow (360 for all the way around).
# With the brush tool active, select your alpha.
# Move your cursor onto the part and see the red dots where the "Nails" will be placed.
# Adjust the size of the "Nail" using [ and ] to make it smaller or larger respectively.
# Click where you want the first "Nail" to appear, this will place them all.

=== Stickers ===
This is where you add signs, stickers, decals, etc., where the sticker has a uniform color (like a radiation symbol, etc.).

# Import your alpha(s)!
# In Layers, under Base Material, add a fill layer for the sticker.
## Uncheck all material properties for the layer except color, metal, and rough.
## Set the fill color to be what you want the sticker to look like.
## Move the layer to be above any other Base Material layer that impacts the part(s) you’re going to apply stickers to (or it will be overwritten and you won’t see your stickers!)
# Select Radial Symmetry (for applications around radially symmetric parts like I've got here).
# Set your X, Y, Z point about which things will be symmetric, where Y is the vertical. (Switch the Show/Hide Manipulator on to help see where this point is in your model).
# Set Mirror Y, the count you want, and the angular span the radial pattern should follow (360 for all the way around).
# With the brush tool active, select your alpha.
# Move your cursor onto the part and see the red dots where the "Stickers" will be placed.
# Adjust the size of the "Sticker" using [ and ] to make it smaller or larger respectively.
# Click where you want the first "Sticker" to appear, this will place them all.

== Exporting the textures ==

# Press '''Ctrl+Shift+E''' to open the export window.
# Select the <code>Kerbal_Space_program_2_Parts_Paintable</code> output template.

== Useful links ==

* Substance 3D Painter tutorial: https://www.youtube.com/watch?v=_j27AS0VQOw
* Free materials: https://substance3d.adobe.com/community-assets/
* Paid materials: https://www.artstation.com/
* Lux's notes on Paint Map: https://luxstice.notion.site/How-to-create-a-paintmap-texture-59c51441f4d048a5803c0b2b108cd041
[[Category:Parts and modules]]