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.
- Read the resolved version of
com.unity.industry.toolkitfromPackages/packages-lock.json(fall back toPackages/manifest.json). - 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.
- 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.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 api-docs/ruleset-api when the RuleSet API is needed.
Read api-docs/rule-api when the Rule API is needed.
Read api-docs/ruleblock-api when the RuleBlock API is needed, including ActionBase.Id for constructing RuleBlock instances.
Levels of Detail
Read references/lods