Asset Transformer Toolkit

作者 unity-technologiescb1dccb8f5ad无许可证1K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

Imports 3D models and point clouds with Asset Transformer Toolkit (formerly Pixyz), and creates, edits, and runs RuleSets, Actions, and LODs. Use for Pixyz or Asset Transformer imports, RuleSets, or ImporterScriptableObjects. Requires toolkit 4.0+.

AI 生成的概览

指导在 Unity 中使用 Asset Transformer Toolkit 导入 3D 模型与点云,并创建、编辑和运行 RuleSet、Action 与 LOD。

功能
这是一个仅含说明的技能,介绍如何在 Unity 项目中使用 Asset Transformer Toolkit(原 Pixyz)。内容包括检查 com.unity.industry.toolkit 包是否为 4.0.0 或更高版本、创建或复用 ImporterScriptableObject 导入 3D 文件,以及通过 ATTAssistantUtilities API 编写 RuleSet、Action、RuleBlock 和细节层级(LOD)。技能附带 RuleSet、Rule、RuleBlock、导入器和 LOD 的参考文档与 API 文档。
适用场景
适用于需要在 Unity 项目中用 Asset Transformer Toolkit 导入外部 3D 模型或点云,或创建、编辑、运行 RuleSet、Action、LOD 的场景。也适用于处理以 Pixyz 命名的导入器或 ImporterScriptableObject 的情况。
运行要求
需要一个已获得授权的 Unity 项目,并安装 com.unity.industry.toolkit 4.0.0 或更高版本;技能会读取 Packages/packages-lock.json 或 Packages/manifest.json 来确认版本。技能不含脚本,只有 Markdown 参考与 API 文档,并依赖 Unity.Pixyz.Plugin4Unity.Editor 程序集。

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 [blocked]

RuleSets and Actions

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

Levels of Detail

Read references/lods [blocked]

来源与署名

来源:unity-technologies/skills位于skills/asset-transformer-toolkit提交cb1dccb

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架