Build Tips

Common Mistakes

Make sure Beautify Render Feature is added to all URP assets in Project Settings / Quality. There can be a different URP asset per quality level.
Effects that rely on depth information such as “Depth of Field” or options like Bloom Depth Attenuation require “Depth Texture” set to true in the URP asset.

Reducing build size

Tips to improve build times select the Beautify Render Feature and disable any effect or option that you won’t use in your game. You can also access the Beautify Render Feature from the Beautify inspector, clicking on the “Configure Build Settings” button.

  • Click “Autoselect Unused Beautify Features” to automatically strip any effect/option that’s not used in the volume of the current scene. Please note that these stripping options affect the entire build, so if you use different volumes or scenes, make sure you only strip those options that are not used in any of your volumes or scenes. The automatic button is convenient but only takes into account the current scene and first volume using Beautify in the scene.

  • Strip all opions under “Uniy Post Processing Stripping” section to remove most shader variants from Unity post processing (if you are using only Beautify, this option is very useful).

Manually setting shader keywords/features

Edit BeautifyCore.shader file and search any line starting with #pragma multi_compile_local. For example:

#pragma multi_compile_local __ BEAUTIFY_TONEMAP_ACES

This line will generate 2 variants of the shader. One that use the ACES tonemapper and other that doesn’t.

A way to reduce shader variants involves setting manually the shader keyword:

  1. If your game uses the ACES feature, you can just replace that line with:

#define BEAUTIFY_TONEMAP_ACES 1

  1. If your game does not use the ACES feature at all, you can just remove completely that line (or keyword if there’re more keywords in the same line).

List of keywords used:

BEAUTIFY_TONEMAP_ACES Uses the custom ACES tonemapper
BEAUTIFY_LUT Uses LUT (color look-up texture) option
BEAUTIFY_NIGHT_VISION Night vision effect
BEAUTIFY_BLOOM Bloom effect
BEAUTIFY_BLOOM_USE_DEPTH Used to attenuate bloom with depth
BEAUTIFY_BLOOM_USE_LAYER Used by the option to apply bloom only to specific layers
BEAUTIFY_ANAMORPHIC_FLARES_USE_DEPTH Used by the option to apply anamorphic flares only to specific layers
BEAUTIFY_DIRT Lens dirt effect
BEAUTIFY_DEPTH_OF_FIELD Depth of field effect
BEAUTIFY_DOF_TRANSPARENT Special treatment to transparent objects with depth of field
BEAUTIFY_CHROMATIC_ABERRATION Chromatic aberration effect
BEAUTIFY_PURKINJE Purkinje effect
BEAUTIFY_VIGNETTING Vigenette effect
BEAUTIFY_VIGNETTING_MASK Texture-mask vignette
BEAUTIFY_EYE_ADAPTATION Eye adaptation effect
BEAUTIFY_OUTLINE Outline effect
BEAUTIFY_COLOR_TWEAKS Color adjustments listed under Tonemapping and Color Grading section in the inspector
BEAUTIFY_TURBO Uses faster shader code
BEAUTIFY_DITHER Dithering effect
BEAUTIFY_SHARPEN Sharpen effect

Important! Please note that:

  1. All these keywords are defined as “local keyword” meaning that they don’t count towards the total of 256 maximum global keywords.

  2. Any modification to BeautifyCore.shader will be lost when updating the asset to a newer version. Remember to apply the same modifications after updating.

Was this page helpful?
Back To Top
Mostrar formularion