Asset Tools¶

# Find materials in folder
mats = await asset("find", type="Material", folder="Assets/UI", labels="hud,animated")

# Get asset info
info = await asset("get_info", path="Assets/Models/Player.fbx")

# Create new folder
await asset("create", type="Folder", path="Assets/Materials")

# Move asset
await asset("move", source="Assets/Old/Player.mat", dest="Assets/Materials/Player.mat")

# Delete temp file
await asset("delete", path="Assets/Temp.prefab")

# Get forward dependencies
deps = await asset("get_dependencies", path="Assets/Scenes/Level1.unity", include_deps=True)

# Find reverse dependencies (who references this asset)
dependents = await asset("find_dependents", path="Assets/Materials/Shared.mat")

# Export package
await asset("export_package", path="Assets/MyFeature", output="/tmp/feature.unitypackage", include_deps=True)

# Import package
await asset("import_package", path="/tmp/feature.unitypackage")

# Read text file
config = await asset("read_text", path="Assets/Config.txt")

# Write text file
await asset("write_text", path="Assets/Config.txt", content="gameVersion=1.0\nmaxPlayers=16")

# Re-import asset (forces AssetDatabase refresh)
await asset("reimport", path="Assets/Models/Player.fbx")

# Create material
await material("create", path="Assets/RedMat.mat", shader="Standard")

# Read properties
props = await material("get", path="Assets/RedMat.mat")

# Set color
await material("set", path="Assets/RedMat.mat", prop="_Color", value="#FF0000")

# Set texture
await material("set", path="Assets/Mat.mat", prop="_MainTexture", value="Assets/Textures/Wood.png")

# Copy material to scene objects
await material("copy", source="Assets/BaseMat.mat", targets="Player,Enemy,Boss")

# List all properties
props = await material("list_properties", path="Assets/Mat.mat")

# Modify material on scene object
await material("set", object_path="Player", prop="_Metallic", value="0.8")

# List material slots on scene object
slots = await material("list_slots", object_path="Player")

# Set multiple properties at once
await material("set_fields", path="Assets/Mat.mat", value="_Color=1,0,0,1\n_Metallic=0.8\n_Smoothness=0.5")

# List available shaders (with optional filter)
shaders = await material("list_shaders", filter="URP")

# Check shader errors
errors = await material("get_errors", path="Assets/Shaders/Custom.shader")

# Use specific material slot
await material("set", object_path="Player", prop="_Color", value="#FF0000", slot=1)

# Modify instance material (not shared)
await material("set", object_path="Player", prop="_Color", value="#FF0000", target="instance")

# 1. Design in scene
await create_object("Player")
await manage_component(path="Player", type="Health", action="add")
await set_property("Player", "Health", "maxHp", "100")

# 2. Save as prefab
await prefab("save", path="Player", asset_path="Assets/Prefabs/Player.prefab")

# Modify prefab asset without unpacking
await prefab("edit", 
  asset_path="Assets/Prefabs/Player.prefab",
  component="Health",
  prop="MaxHP",
  value="200"
)

# Add component to prefab
await prefab("edit",
  asset_path="Assets/Prefabs/Player.prefab",
  add_component="Rigidbody"
)

# Remove component
await prefab("edit",
  asset_path="Assets/Prefabs/Player.prefab",
  remove_component="AudioSource"
)

# Create variant (inherits from base)
await prefab("create_variant",
  base_path="Assets/Prefabs/Enemy.prefab",
  variant_path="Assets/Prefabs/Variants/EnemyFast.prefab"
)

# Modify variant (doesn't affect base)
await prefab("edit",
  asset_path="Assets/Prefabs/Variants/EnemyFast.prefab",
  component="Health",
  prop="maxHp",
  value="50"
)

# Create new ScriptableObject
await scriptable_object("create", 
  path="Assets/GameConfig.asset",
  type="GameSettings"
)

# Create with initial fields
await scriptable_object("create",
  path="Assets/GameConfig.asset",
  type="GameSettings",
  fields="maxLevel=50\nstartGold=100"
)

# Read configuration
config = await scriptable_object("get", path="Assets/GameConfig.asset")

# Read specific fields only
config = await scriptable_object("get", path="Assets/GameConfig.asset", filter="maxLevel,startGold")

# Modify property
await scriptable_object("set",
  path="Assets/GameConfig.asset",
  prop="maxLevel",
  value="100"
)

# Set multiple fields at once
await scriptable_object("set",
  path="Assets/GameConfig.asset",
  fields="maxLevel=100\nstartGold=500"
)

# List available ScriptableObject types
types = await scriptable_object("list_types", filter="Config")

# Find all instances of a type
configs = await scriptable_object("find", type="GameSettings")

# Read physics settings
physics = await project_settings("get", target="physics")

# Set gravity
await project_settings("set", target="physics", prop="gravity", value="0,-15,0")

# Read time settings
time = await project_settings("get", target="time")

# Read tags
tags = await project_settings("get", target="tags")

# Add a tag
await project_settings("set", target="tags", prop="Enemy")

# Remove a tag
await project_settings("set", target="tags", prop="remove", value="Obsolete")

# Set a layer by index (0-5 reserved, use 6+)
await project_settings("set", target="layers", index=8, value="EnemyLayer")

# Switch quality level
await project_settings("set", target="quality", prop="currentLevel", value="2")

# Set scripting backend (requires build_target)
await project_settings("set", target="player", prop="ScriptingBackend", value="IL2CPP", build_target="Standalone")

# Read graphics settings
graphics = await project_settings("get", target="graphics")

# Set color space to linear
await project_settings("set", target="graphics", prop="colorSpace", value="Linear")

# Read audio settings (read-only)
audio = await project_settings("get", target="audio")

# Read input axes (read-only)
input_axes = await project_settings("get", target="input")

# Build for active target (Standalone)
result = await build("build")

# Build for iOS with custom path
result = await build("build", target="iOS", path="Builds/iOS", scenes="Assets/Scenes/Menu.unity,Assets/Scenes/Main.unity")

# Development build (logging + profiler enabled)
result = await build("build", target="Android", dev=True, path="Builds/Android/dev")

# List installed packages
packages = await package("list")

# Search for UI packages
results = await package("search", query="UI")

# Add a package (latest version)
await package("add", name="com.unity.textmeshpro")

# Add specific version
await package("add", name="com.unity.textmeshpro", version="3.0.6")

# Remove package
await package("remove", name="com.unity.textmeshpro")

# Start async lighting bake (fire-and-forget)
await bake("lighting")

# Poll lighting status
status = await bake("lighting", action="status")
# Returns: "status:baking\nprogress:0.45" or "status:idle"

# Get lighting bake settings
settings = await bake("lighting", action="settings")

# Cancel if needed
await bake("lighting", action="cancel")

# Synchronous occlusion bake (waits until complete)
result = await bake("occlusion")

# Check occlusion status
status = await bake("occlusion", action="status")
# Returns: status (running|idle), baked (true|false), bytes (data size)

# Clear occlusion data
await bake("occlusion", action="clear")

# Quick rendering stats (draw calls, batches, triangles)
stats = await render_analyze("stats")

# Audit materials in scene
materials = await render_analyze("materials", detail="brief")

# Full shader analysis
shaders = await render_analyze("shaders", detail="full")

# Check light count and shadow settings
lights = await render_analyze("lights")

# Analyze batching efficiency (SRP Batcher, instancing)
batching = await render_analyze("batching")

# Detect overdraw problem areas
overdraw = await render_analyze("overdraw")

# Full rendering health check
audit = await render_analyze("audit", detail="full")

# Per-draw-call frame debug (pauses rendering)
frame_data = await render_analyze("frame_debug", max_events=50)

# Shadow map usage
shadow_info = await render_analyze("shadow_audit")

# Light probe coverage (in a specific area)
probes = await render_analyze("probe_audit", path="Player/CameraArea")

# Get optimization recommendations
recommendations = await render_analyze("light_optimize")

# Analyze subtree rendering
subtree_stats = await render_analyze("stats", path="UI/HUD")

# Quick overview
summary = await material_audit()

# Check for duplicate materials
dupes = await material_audit("duplicates")

# Platform-specific compression audit
issues = await material_audit("compression", platform="Android")

# Get optimization recommendations
recs = await material_audit("recommendations")

# Outgoing references from a prefab
refs = await references("get", path="Assets/Prefabs/Player.prefab")

# Who references this material?
users = await references("find_to", path="Assets/Materials/Shared.mat")

# Remap a reference
await references("remap", path="Assets/Scene.unity", source="Assets/Old.mat", target="Assets/New.mat")

# Deep scan with children
refs = await references("get", path="Assets/Prefabs/Player.prefab", children=True, depth=3)