docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Scriptable Build Pipeline Preferences window reference

    Preferences are saved in a ProjectSettings/ScriptableBuildPipeline.json file and apply to the whole project.

    To access the Preferences for the Scriptable Build Pipeline, go to Edit > Preferences > Scriptable Build Pipeline (macOS: Unity > Settings).

    General Settings

    The General Settings section contains the following settings:

    Property Description
    Threaded Archiving Enables multithreading for the archiving and compressing stage of the build. Disable to run on a single thread.

    Threaded Archiving is enabled by default but is only available if your Unity version supports multithreaded archiving.
    Log Cache Miss Logs a warning when the build cache misses, and points out the problematic asset and dependency. Use Log Cache Miss to understand why incremental builds rebuild content.
    Log Asset Warnings Logs warnings for invalid asset references.

    Log Asset Warnings is enabled by default.
    Slim Write Results Caches the minimum WriteResults data to reduce cache size and improve cache performance.

    Slim Write Results is enabled by default. Disable it only if a custom build task needs the full write results.
    Use Detailed Build Log Writes detailed event information to the build log.
    Use V2 Hasher Uses the same hasher as Asset Database V2, which improves cache performance but invalidates the existing build cache. Triggers a full rebuild for the next build.

    Use V2 Hasher is enabled by default.
    FileID Generator Seed Provides a seed to the hash, which prevents file identifier collisions during build. Avoid changing this value after your project is released.

    The default seed is 0. Generate a random seed with Random.
    Prefab Packed Header Size Specifies the size of the header for PrefabPacked Asset Bundles in bytes to avoid file identifier collisions during build. Objects from the same asset share the same leading bytes and belong to the same AssetBundle. Higher size values reduce collisions between assets and enables more precise grouping of objects by asset. However, this makes it harder to differentiate objects within an asset and increases the risk of file identifier collisions in assets that contain many objects.

    Avoid changing this value after your project is released as it changes file identifiers for all objects in all bundles.

    Build Cache

    The Build Cache section contains the following settings:

    Property Description
    Maximum Cache Size (GB) Keeps the build cache size under this value when possible. The default value is 20 GB.
    Purge Cache Deletes the whole build cache folder.
    Prune Cache Deletes the entries that were the least recently accessed until the cache is under the maximum cache size.

    Additional resources

    • Analyze build logs
    • ScriptableBuildPipeline Scripting API
    • Addressables Preferences reference
    • Unity’s Object base class
    In This Article
    Back to top
    Copyright © 2026 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)