Shadows / Blender

Here are described the settings and best practices to setup beautiful real-time shadows in Verge3D for Blender.


This section is written for Blender 2.81 (or higher). The shadow settings for older Blender versions are slightly different.

Preparing Blender Viewport

It's recommended to set up Blender's viewport as described in this section to make configuring shadows easier.

Verge3D aims to resemble Blender's Eevee renderer. Follow these instructions to enable it:

It's also worth noting that Verge3D doesn't support soft shadows the same way Blender supports them. Blender's Soft Shadows option enables gradual shadow rendering, but Verge3D relies on more real-time techniques. Given the above, it might be better to disable the Soft Shadows option. Also, in order to achieve soft shadows in Verge3D one can try different shadow filtering methods and adjust the shadow blur radius setting.

Shadow Filtering Types

Shadows in Verge3D look very differently depending on what shadow map filtering algorithm is in use. The Shadow Map Filtering property located on the Render Properties tab is used to specify the algorithm.


Disable filtering, render shadow map as is. This is the fastest method to render shadows.


Use bilinear filtering to smooth adjacent shadow map pixels.


Stands for Percentage Closer Filtering. Uses multiple shadow map lookups for smoothed shadow rendering. Average quality and performance.

PCF (Bilinear)

Similar to PCF but uses bilinear interpolation for each shadow map lookup. Gives smoothed shadows at the expense of more computation power.

PCF (Poisson Disk)

Uses pseudorandom Poisson Disk Sampling to eliminate shadow pixelation for PCF shadows. This was made the default setting because it corresponds the most to what you see in the 3D editor viewport. The performance is comparable to PCF (Bilinear) algorithm or better.


Stands for Exponential Shadow Maps. Shadows are smoothest but light leaks are possible. Use ESM Bias setting on lights to remove light leaks artefacts. The performance is comparable to PCF (Bilinear) algorithm. ESM shadows can be particularly tricky to set up, therefore see ESM-related issues in the Troubleshooting section.

Which filtering type to choose?

It's recommended to try the default PCF (Poisson Disk) shadows first, because they offer good quality and performance. If you need faster but less quality shadows then try Basic or Bilinear. Try ESM if you want more quality, soft shadows, but the drawback is that they can be tricky to set up (artefact-wise) for a particular scene.

Global Settings

The rendering of the shadows is tuned using the Shadows and Verge3D Settings panels located on the Render tab in Blender.

Cube Size
shadow map size for shadows casted from Point and Spot lights. The higher values gives better quality but reduces performance.
Cascade Size
shadow map size for shadows casted from Sun lights. The higher values gives better quality but reduce performance.
Light Threshold
light intensity threshold used to calculate shadow volume distance.
Enable Shadows
enable/disable shadows in Verge3D.
Shadow Map Filtering
shadow map filtering algorithm. See above.
Shadow Map Side
denotes which side of polygons is rendered during the shadow pass. Tweak this value to eliminate self-shadowing artefacts or if you render the plain models (such as leaves or papers).
ESM Distance Scale
ESM shadows scaling factor. Since the ESM filtering algorithm uses absolute distance values, decrease the scale value if you're working on a scene which is much bigger than the default cube, and increase it if your scene is much smaller. Default value is 1. Works only for ESM shadows.

Per-light Settings

Shadows can be enabled/disabled/tweaked for each individual light using the Shadow and Verge3D Settings panels.

Clip Start
near clipping distance, higher values may slightly improve shadow quality.
main parameter you should tweak to get rid of self-shadow artefacts and/or the "peter-panning" effect.
Blur Radius
specify value higher 1 to make your shadows smoother (increase shadow blurriness). This parameter works only for PCF, PCF (Bilinear), PCF (Poisson Disk) and ESM shadows.
ESM Bias
bias to reduce ESM light leaking artefacts. Works only for ESM shadows.

Per-object/material Settings

Shadow casting can be enabled/disabled for each individual material through the Settings panel.

Shadow Mode
shadow casting mode for the material. Only None and Opaque are currently supported.

Shadow receiving can be enabled/disabled for each individual object through the Verge3D Settings panel.

Receive Shadows
render shadows on the given object or not.

Configuring Sun Shadows

Since Verge3D does not support cascaded shadow maps yet, you must follow these steps to configure sun shadows:

  1. Set the cascades Count to 1.
  2. Go to active camera view using the View->Cameras->Active Camera menu or Numpad 0 key.
  3. Tweak Max Distance parameter.


Shadows in Verge3D and in the Blender viewport look different

Shadows look too pixelated

Shadows are visible in the Blender viewport but not in Verge3D

Shadows have artefacts

Shadows have no/small penumbra

ESM shadows look faded

ESM shadows look too sharp or have no penumbra

ESM Shadows have artefacts

Got Questions?

Feel free to ask on the forums!