Known Issues
Some issues may appear while using this shader. A few of them are shader-related, but most are caused by the engine itself.
Keep in mind that most of the issues listed here cannot be fixed on our side. These are engine-side problems, so we will have to wait for the S&box developers to address them.
Weird, blocky or bad shading on model surfaces
This issue can appear most often when using Shadow Shading or other shading effects that wrap around the model. it appears like the shading is jaggy, blocky or other broken ways. It's caused by Bad tangents calculated by ModelDoc.
Luckily, We have a fix for that and it's simple. All you need to do is open the VMDL in the ModelDoc. Right-click the your model's mesh from the RenderMeshList. Click Add RenderMeshMarkup. And check Use Expensive Tangents. Repeat for every meshes in the RenderMeshList if your model has bodygroups. Compile your model again (Press F9) and it'll be fixed.
Outlines having gaps
This is a common issue with inverted hull outlines. But, you won't notice or occur most of the time unless your model has a lot of hard edges.
Hard edges usually have duplicated vertices with different normals. When the outline pass pushes those vertices outward along their normals, each copy moves in a slightly different direction. That separation creates visible gaps at sharp edges. Smooth edges do not usually have this problem because they share averaged normals, so the extrusion stays continuous. That's what we'll solve with vertex colors sooner.
We'll add a way to use vertex colors for outlines sooner with a baking tool sooner!
Model flickering black while in ragdoll
This issue can be seen on Flatgrass. We don't see the issue anywhere except Flatgrass map. According to the Facepunch graphics programmer, this is caused by the map itself and its poor lighting probe placement in Flatgrass.
We can't magically fix that issue as it's the map itself. You can also easily see that issue while playing normally with default characters that the game gives you.
That's all the issues we can find. If you find more issues and want to report. Feel free to open an issue in our shader's Github Repo. Or, you can contribute our shader with what it needs too by opening a pull request.