Asset Preprocessor

Config-based workflow for Unity's AssetPostprocessor class.

Config Example

Supported Asset Types

Textures
- TexturePreprocessorConfig
Audio Clips
- AudioPreprocessorConfig
Models
- ModelPreprocessorConfig

Supported Unity Versions

Unity 2018.2.x
Unity 2019.1.x

Usage

First, create configs via the Assets menu:

Assets -> Create -> ScriptableObject -> AssetPreprocessor

It is recommended to have multiple TextureProcessorConfigs. You'll probably want at least one config for each texture category (model textures, particle textures, etc).

Asset Path Regex Strings

You can limit the configs to certain assets via the asset path regex strings.

Tweak the asset path regex string lists to ensure that each config only targets the desired assets.

You can use the * character as a wildcard.

Platform Regex Strings

You can limit the configs to certain platforms via the platform regex strings.

The platform regex strings should ideally be perfect matches to actual the platform strings.

Example platform regex strings:

Android
iOS
Standalone (to match OSX, Windows and Linuix standalone builds)
StandaloneOSX (a perfect match platform string for OSX)

To get the string for your current platform, try logging EditorUserBuildSettings.activeBuildTarget.ToString().

Troubleshooting

Why is nothing happening when importing an asset?

Make sure that you actually have a preproccessor config for your asset type created inside of your Assets/ directory.

I have a config for my asset type. Why isn't it used when importing an asset of the same type?

Check your asset path match and ignore regex strings. Ensure that the asset you are importing matches one of the match regex strings, and that it does not match one of the ignore regex strings. And then check that your current platform matches one of the platform regex strings.

Recommended AudioPreprocessorConfig Settings

Check out the "Suggested Settings" tables in this article about audio import settings.

andrelevi / AssetPreprocessor