mcpField
A
asset-transformer-toolkit

asset-transformer-toolkit

github.com/unity-technologiesCreative & media1.2k2.1k installsUpdated 1d ago
Repository

About asset-transformer-toolkit

A skill for Unity projects that use Asset Transformer Toolkit 4.0.0 or later. It guides an agent through importer, RuleSet, action, and level-of-detail workflows using the package’s documented APIs, with version checks and safeguards against unsupported access.

Key features

  1. 01Checks package version before proceeding
  2. 02Uses documented ATTAssistantUtilities APIs
  3. 03Guidance for importer creation and reimport
  4. 04References for RuleSets, actions, and LODs

Use cases

  1. 01Check whether a Unity project meets the toolkit version requirement
  2. 02Create or reimport a model with a toolkit importer
  3. 03Work with RuleSets, actions, or levels of detail

Install

Copy the command and run it in a terminal.

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

After installing, type/asset-transformer-toolkitin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project README
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 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

Comments

Markdown supported