keijiro/unity-skills/unity-asset-transformer-toolkit

Before you start: check the package version

This skill needs Asset Transformer Toolkit 4.0.0 or later (com.unity.industry.toolkit). Earlier versions don't have the ATTAssistantUtilities API every workflow below relies on.

1. Read the resolved version of com.unity.industry.toolkit from Packages/packages-lock.json (fall back to Packages/manifest.json).
2. Not installed: tell the user this workflow needs Asset Transformer Toolkit 4.0 or later, which is an entitled Unity package they may need access to through their Unity plan, and stop. Don't add it to the manifest yourself.
3. Installed below 4.0.0: tell the user which version you found and that 4.0 or later is required, and ask before upgrading. Don't fall back to older APIs, raw C# against internal types, or reflection.
4. 4.0.0 or later: continue.

API Reference

Tool functions are provided by Unity.Pixyz.Plugin4Unity.Editor.AI.ATTAssistantUtilities. They are documented inline in each reference file below alongside the classes they operate on.

Technical Notes

Pixyz Plugin is the former name of Asset Transformer Toolkit. Prefer using the term 'Asset Transformer Toolkit' when addressing the user, unless the user is using the term 'Pixyz' Most classes and code are in the Unity.Pixyz.Plugin4Unity.Editor assembly. Asset Transformer Toolkit is NOT the same thing as Asset Transformer Studio/Pixyz Studio. NEVER rely on information about Asset Transformer Studio.

Importers

Asset Transformer Toolkit can import 3D file from outside the project. When modifying Importers, NEVER assume it should be immediately followed by a reimport. The import process can be very long, so it must only be launched when the user requests it. Modify fields in Importers using the ScriptableObject API. NEVER use reflection to access or modify Importer fields — reflection is not available. To create a Pixyz/Asset Transformer Toolkit Importer for importing a file, or to reimport a model using an existing ImporterScriptableObject, read references/create-importer

RuleSets and Actions

Read references/rulesets-and-actions Read references/ruleset-api when the RuleSet API is needed. Read references/rule-api when the Rule API is needed. Read references/ruleblock-api when the RuleBlock API is needed, including ActionBase.Id for constructing RuleBlock instances.

Levels of Detail

Read references/lods