docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Installation

    Prerequisites

    • A compatible version of Unity Editor must be installed - see Compatibility.
    • The Asset Transformer Toolkit package is exclusively part of the Unity Industry subscription, as an entitled package (or entitlement). A Unity Industry seat must be assigned to you and activated in order to install and use Asset Transformer Toolkit on your computer:
      Warning
      • Asset Transformer Toolkit is not compatible with the “Serial-based licensing” model, as this licensing model is not compatible with extra entitlements.
      • When using the "Floating licensing" model, the License Server must be up-to-date in order to contain the entitlement for Asset Transformer Toolkit. Follow the instructions here to update the License Server.

    Package installation

    To install this package com.unity.industry.toolkit, open the Package Manager and search "Asset Transformer Toolkit" (or "Pixyz") in the Unity Registry (detailed instructions in the Package Manager documentation).

    Note
    • You must have a Unity Industry seat assigned to you to be able to find the Asset Transformer Toolkit package in the Package Manager. In the case of a Floating license, you must also be added to the Organization that owns the license.

    • When installing the package, two supporting packages are also installed, com.unity.pixyz.unity-sdk and com.unity.pixyz.sdk-plus, which must not be used (see their respective License file).

    • If you're in a closed network environment (offline) without access to Unity Package Manager, you can install Asset Transformer Toolkit using tarballs. Download tarballs from here and install them locally in this order:

      1. com.unity.pixyz.sdk-plus
      2. com.unity.pixyz.unity-sdk
      3. com.unity.industry.toolkit

      This order is for a first installation. To update an existing installation, see Package update.

    Package update

    All installations

    Unity Editor does not unload the native libraries of Asset Transformer Toolkit while it is running, so the libraries of the previous version stay loaded until you restart the Editor. From Asset Transformer Toolkit 4.1.0, the package detects this after an update:

    • When the update finishes, Asset Transformer Toolkit asks you to restart the Editor. Save your work and select Restart Editor.
    • If you select Not now, Asset Transformer Toolkit stays unavailable and reports an error in the Console until you restart the Editor.
    Warning

    Versions of Asset Transformer Toolkit before 4.1.0 cannot detect this situation. If the Editor is running with one of those versions, updating the package while the Editor is open can crash it. Close the Editor before you update from those versions.

    Offline (tarball) installations only

    This part applies only if you install from tarballs. When you update from the Package Manager, the three packages are resolved together automatically.

    • Update com.unity.industry.toolkit, com.unity.pixyz.unity-sdk and com.unity.pixyz.sdk-plus together. If you install them one at a time while an earlier version of Asset Transformer Toolkit is running, the Editor can crash.
    • The safest way to update from tarballs is to close the Editor, edit Packages/manifest.json so that the three packages point at the new tarballs, then open the project again.

    Package removal

    To remove this package (for example, to uninstall a previous version before installing the latest version), follow the instructions in the Package Manager documentation.

    Troubleshooting

    For troubleshooting, visit the Unity Support page for Asset Transformer products or contact Unity Support.

    Asset Transformer Toolkit asks for a restart when no update happened

    From version 4.1.0, the package checks after an update whether a native library from a previous version is still loaded in the Editor, and asks for a restart if so. If this message appears when you have not updated the package, and restarting the Editor does not clear it, you can turn the check off. Set the environment variable ATT_DISABLE_NATIVE_LIBRARY_GUARD to 1 before you start Unity Editor:

    • Windows: set the variable in the system or user environment variables, then restart Unity Hub and the Editor. For a single session, run set ATT_DISABLE_NATIVE_LIBRARY_GUARD=1 in a command prompt, then start the Editor from that prompt.
    • macOS: start the Editor from Terminal, with the variable set in front of the command: ATT_DISABLE_NATIVE_LIBRARY_GUARD=1 /Applications/Unity/Hub/Editor/<version>/Unity.app/Contents/MacOS/Unity, replacing <version> with your Editor version.
    Warning

    With the check turned off, updating the package while the Editor is open can crash the Editor. Use this only as a last resort, close the Editor before you update the package, and contact Unity Support so that the cause can be fixed.

    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)