mcpField
A
asset-transformer-toolkit

asset-transformer-toolkit

github.com/unity-technologies创意与媒体1.2k2.1k 次安装1 天前更新
代码仓库

关于 asset-transformer-toolkit

面向使用 Asset Transformer Toolkit 4.0.0 或更高版本的 Unity 项目,指导 Agent 按文档 API 处理导入器、RuleSet、动作和细节层级,并先检查版本、避免不支持的访问方式。

主要功能

  1. 01开始前检查工具包版本
  2. 02使用文档化的 ATTAssistantUtilities API
  3. 03创建导入器及重新导入指南
  4. 04RuleSet、动作和细节层级参考

适用场景

  1. 01确认 Unity 项目是否满足版本要求
  2. 02使用工具包导入器创建或重新导入模型
  3. 03处理 RuleSet、动作或细节层级

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/unity-technologies/skills --skill asset-transformer-toolkit

安装后在 Claude Code 中输入/asset-transformer-toolkit确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

SECURITY.md
api-docs/
rule-api.md
ruleblock-api.md
ruleset-api.md
references/
create-importer.md
lods.md
rulesets-and-actions.md

详细介绍

开始之前:检查软件包版本

此技能需要 Asset Transformer Toolkit 4.0.0 或更高版本(com.unity.industry.toolkit)。更早的版本没有以下每个工作流都依赖的 ATTAssistantUtilities API。

  1. 从 Packages/packages-lock.json 中读取 com.unity.industry.toolkit 的解析版本(如果没有,则查看 Packages/manifest.json)。
  2. 未安装: 告知用户此工作流需要 Asset Transformer Toolkit 4.0 或更高版本。这是一个需要授权的 Unity 软件包,用户可能需要通过其 Unity 方案获取访问权限,然后停止。不要自行将其添加到清单中。
  3. 已安装但低于 4.0.0: 告知用户找到的版本以及所需的 4.0 或更高版本,并在升级前征求同意。不要回退到较旧的 API,不要使用针对内部类型的原始 C#,也不要使用反射。
  4. 4.0.0 或更高版本: 继续。
API 参考

工具函数由 Unity.Pixyz.Plugin4Unity.Editor.AI.ATTAssistantUtilities 提供。每个参考文件中都附有内联文档,介绍这些函数及其操作的类。

技术说明

Pixyz Plugin 是 Asset Transformer Toolkit 以前使用的名称。除非用户使用“Pixyz”一词,否则优先使用“Asset Transformer Toolkit”来称呼它。 大多数类和代码都位于 Unity.Pixyz.Plugin4Unity.Editor 程序集中。 Asset Transformer Toolkit 与 Asset Transformer Studio/Pixyz Studio 并非同一产品。切勿依赖有关 Asset Transformer Studio 的信息。

导入器

Asset Transformer Toolkit 可以从项目外部导入 3D 文件。 修改导入器时,切勿假设修改后应立即重新导入。导入过程可能很漫长,因此只有在用户提出请求时才能启动。 使用 ScriptableObject API 修改导入器中的字段。切勿使用反射访问或修改导入器字段——此处无法使用反射。 要创建用于导入文件的 Pixyz/Asset Transformer Toolkit 导入器,或使用现有的 ImporterScriptableObject 重新导入模型,请阅读 references/create-importer

规则集和操作

阅读 references/rulesets-and-actions 需要 RuleSet API 时,请阅读 api-docs/ruleset-api。 需要 Rule API 时,请阅读 api-docs/rule-api。 需要 RuleBlock API 时(包括在构造 RuleBlock 实例时使用 ActionBase.Id),请阅读 api-docs/ruleblock-api。

细节层次

阅读 references/lods

评论

支持 Markdown