Unity Importer

Unity Importer Skills

BATCH-FIRST: Use *_batch skills when configuring 2+ assets.

Guardrails

Mode: Full-Auto required

DO NOT (common hallucinations):

• importer_import does not exist → use asset_import (asset module) to import files; this module configures import settings
• importer_set_format does not exist → use specific skills: importer_set_texture, importer_set_audio, importer_set_model
• importer_get_settings does not exist → use specific skills: importer_get_texture, importer_get_audio, etc.
• After changing import settings, Unity may need asset_reimport to apply changes

Routing:

• For file import (copy into project) → use asset module's asset_import
• For texture/model/audio settings → use specific importer skills in this module

Skills Overview

Alternative Skills:

• texture_set_import_settings - Set texture import settings (alternative API)
• model_set_import_settings - Set model import settings (alternative API)

Query Skills (no batch needed):

• texture_get_settings - Get texture import settings
• audio_get_settings - Get audio import settings
• model_get_settings - Get model import settings

Texture Skills

texture_get_settings

Get texture import settings.

texture_set_settings

Set texture import settings.

texture_set_settings_batch

Set texture import settings for multiple textures.

Returns: {success, totalItems, successCount, failCount, results: [{success, assetPath}]}

texture_set_import_settings

Set texture import settings (alternative API).

# Single - convert to sprite
unity_skills.call_skill("texture_set_settings",
    assetPath="Assets/Textures/ui_button.png",
    textureType="Sprite",
    spritePixelsPerUnit=100,
    filterMode="Bilinear"
)

# Batch - convert multiple to sprites
unity_skills.call_skill("texture_set_settings_batch", items=[
    {"assetPath": "Assets/Textures/icon1.png", "textureType": "Sprite"},
    {"assetPath": "Assets/Textures/icon2.png", "textureType": "Sprite"},
    {"assetPath": "Assets/Textures/icon3.png", "textureType": "Sprite"}
])

Audio Skills

audio_get_settings

Get audio import settings.

audio_set_settings

Set audio import settings.

audio_set_settings_batch

Set audio import settings for multiple audio files.

Returns: {success, totalItems, successCount, failCount, results: [{success, assetPath}]}

# BGM - use streaming for memory efficiency
unity_skills.call_skill("audio_set_settings",
    assetPath="Assets/Audio/bgm.mp3",
    loadType="Streaming",
    compressionFormat="Vorbis",
    quality=0.7
)

# SFX - decompress for low latency
unity_skills.call_skill("audio_set_settings",
    assetPath="Assets/Audio/sfx_hit.wav",
    loadType="DecompressOnLoad",
    forceToMono=True
)

# Batch
unity_skills.call_skill("audio_set_settings_batch", items=[
    {"assetPath": "Assets/Audio/sfx1.wav", "loadType": "DecompressOnLoad"},
    {"assetPath": "Assets/Audio/sfx2.wav", "loadType": "DecompressOnLoad"}
])

Model Skills

model_get_settings

Get model import settings.

model_set_settings

Set model import settings.

model_set_settings_batch

Set model import settings for multiple models.

Returns: {success, totalItems, successCount, failCount, results: [{success, assetPath}]}

model_set_import_settings

Set model import settings (alternative API).

# Character with humanoid animation
unity_skills.call_skill("model_set_settings",
    assetPath="Assets/Models/character.fbx",
    animationType="Humanoid",
    meshCompression="Medium",
    generateSecondaryUV=True
)

# Static prop - optimize
unity_skills.call_skill("model_set_settings",
    assetPath="Assets/Models/prop_barrel.fbx",
    animationType="None",
    importAnimation=False,
    importCameras=False,
    importLights=False,
    meshCompression="High"
)

# Batch
unity_skills.call_skill("model_set_settings_batch", items=[
    {"assetPath": "Assets/Models/prop1.fbx", "animationType": "None", "meshCompression": "High"},
    {"assetPath": "Assets/Models/prop2.fbx", "animationType": "None", "meshCompression": "High"}
])

Example: Efficient Asset Configuration

import unity_skills

# BAD: 5 API calls
unity_skills.call_skill("texture_set_settings", assetPath="Assets/UI/btn1.png", textureType="Sprite")
unity_skills.call_skill("texture_set_settings", assetPath="Assets/UI/btn2.png", textureType="Sprite")
unity_skills.call_skill("texture_set_settings", assetPath="Assets/UI/btn3.png", textureType="Sprite")
unity_skills.call_skill("texture_set_settings", assetPath="Assets/UI/btn4.png", textureType="Sprite")
unity_skills.call_skill("texture_set_settings", assetPath="Assets/UI/btn5.png", textureType="Sprite")

# GOOD: 1 API call
unity_skills.call_skill("texture_set_settings_batch", items=[
    {"assetPath": f"Assets/UI/btn{i}.png", "textureType": "Sprite", "mipmapEnabled": False}
    for i in range(1, 6)
])

Best Practices

Textures

• Use Sprite type for UI images
• Disable mipmaps for UI textures to save memory
• Use Point filter for pixel art
• Set readable=false unless you need CPU access

Audio

• Use Streaming for long BGM tracks
• Use DecompressOnLoad for short SFX
• Use Vorbis compression with quality 0.5-0.7 for good balance

Models

• Use Humanoid animation type for characters with retargeting
• Disable unused imports (cameras, lights) for props
• Enable generateSecondaryUV for static objects using baked lighting

Audio Skills (Extended)

audio_find_clips

Search for AudioClip assets in the project.

Returns: { success, totalFound, showing, clips[] { path, name, length } }

audio_get_clip_info

Get detailed information about an AudioClip asset.

Returns: { success, name, path, length, channels, frequency, samples, loadType, loadState, ambisonic }

audio_add_source

Add an AudioSource component to a GameObject.

Returns: { success, gameObject, instanceId }

audio_get_source_info

Get AudioSource configuration.

Returns: { success, gameObject, clip, volume, pitch, loop, playOnAwake, mute, spatialBlend, minDistance, maxDistance, priority }

audio_set_source_properties

Set AudioSource properties.

Returns: { success, gameObject }

audio_find_sources_in_scene

Find all AudioSource components in the current scene.

Returns: { success, totalFound, showing, sources[] { gameObject, path, clip, volume, loop, enabled } }

audio_create_mixer

Create a new AudioMixer asset.

Returns: { success, path, name }

Model Skills (Extended)

model_find_assets

Search for model assets in the project.

Returns: { success, totalFound, showing, models[] { path, name } }

model_get_mesh_info

Get detailed Mesh information (vertices, triangles, submeshes).

Returns: { success, name, vertexCount, triangles, subMeshCount, bounds { center, size }, hasNormals, hasTangents, hasUV, hasUV2, hasColors, blendShapeCount, isReadable }

model_get_materials_info

Get material mapping for a model asset.

Returns: { success, path, materialCount, materials[] { name, shader }, meshCount, meshes[] { name, vertices, triangles } }

model_get_animations_info

Get animation clip information from a model asset.

Returns: { success, path, importAnimation, clipCount, clips[] { name, length, frameRate, wrapMode, isLooping }, clipDefinitions[] { name, firstFrame, lastFrame, loop } }

model_set_animation_clips

Configure animation clip splitting.

Returns: { success, path, clipCount }

model_get_rig_info

Get rig/skeleton binding information.

Returns: { success, path, animationType, avatarSetup, sourceAvatar, optimizeGameObjects, isHuman }

model_set_rig

Set rig/skeleton binding type.

Returns: { success, path, animationType }

Texture Skills (Extended)

texture_find_assets

Search for texture assets in the project.

Returns: { success, totalFound, showing, textures[] { path, name, width, height } }

texture_get_info

Get detailed texture information (dimensions, format, memory).

Returns: { success, name, path, width, height, format, mipmapCount, isReadable, filterMode, wrapMode, memorySizeKB }

texture_set_type

Set texture type.

Returns: { success, path, textureType }

texture_set_platform_settings

Set platform-specific texture settings.

Returns: { success, path, platform, maxSize, format }

texture_get_platform_settings

Get platform-specific texture settings.

Returns: { success, path, platform, overridden, maxTextureSize, format, compressionQuality }

texture_set_sprite_settings

Configure Sprite-specific settings (pixelsPerUnit, spriteMode).

Returns: { success, path, pixelsPerUnit, spriteMode }

texture_find_by_size

Find textures by dimension range (minSize/maxSize in pixels).

Returns: { success, count, textures[] { path, name, width, height } }

Asset Import Skills

asset_reimport

Force reimport of an asset.

Returns: { success, reimported }

asset_reimport_batch

Reimport multiple assets matching a pattern.

Returns: { success, count, assets[] }

audio_set_import_settings

Set audio clip import settings (alternative API from AssetImportSkills).

Returns: { success, assetPath, forceToMono, loadType, compressionFormat }

sprite_set_import_settings

Set sprite import settings (mode, pivot, packingTag, pixelsPerUnit).

Returns: { success, assetPath, spriteMode, pixelsPerUnit }

texture_get_import_settings

Get current texture import settings (alternative API from AssetImportSkills).

Returns: { success, assetPath, textureType, maxSize, compression, readable, mipmaps, spriteMode, pixelsPerUnit }

model_get_import_settings

Get current model import settings (alternative API from AssetImportSkills).

Returns: { success, assetPath, globalScale, importAnimation, importMaterials, meshCompression, readable, generateColliders }

audio_get_import_settings

Get current audio import settings (alternative API from AssetImportSkills).

Returns: { success, assetPath, forceToMono, loadInBackground, loadType, compressionFormat, quality }

asset_set_labels

Set labels on an asset.

Returns: { success, assetPath, labels[] }

asset_get_labels

Get labels of an asset.

Returns: { success, assetPath, labels[] }