Unity Prefab

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Creating or editing prefabs
• Instantiating or applying prefab changes
• Finding instances in scenes
• Creating prefab variants
• 创建或编辑预制体、实例化或应用预制体改动、在场景中查找实例、创建预制体变体

Unity Prefab Skills

BATCH-FIRST: Use prefab_instantiate_batch when spawning 2+ prefab instances.

Operating Mode

Approval 模式下本模块为 Mixed —— 只读 skill prefab_get_overrides / prefab_find_instances（标 ReadOnly = true, Mode = SkillMode.SemiAuto）可直接执行；其余 9 个写类 skill (prefab_create / prefab_instantiate / prefab_instantiate_batch / prefab_apply / prefab_unpack / prefab_revert_overrides / prefab_apply_overrides / prefab_create_variant / prefab_set_property) 为 SkillMode.FullAuto，需用户 grant 单次执行返结果。Auto / Bypass 直接执行。本模块不含 NeverInSemi 高危 skill（无 Delete / PlayMode / Reload）。

DO NOT (common hallucinations):

• prefab_create_from_object does not exist → use prefab_create (takes scene object name/instanceId and savePath)
• prefab_spawn does not exist → use prefab_instantiate
• prefab_edit / prefab_modify do not exist → use prefab_set_property (edit prefab asset directly) or instantiate, modify, then prefab_apply
• prefab_save does not exist → use prefab_apply (applies instance changes to source prefab)

Routing:

• To modify components on a prefab instance in scene → use component module skills, then prefab_apply
• To set a property directly on the prefab asset → prefab_set_property (this module)
• To find all instances of a prefab → prefab_find_instances (this module)

Skills Overview

No batch needed:

• prefab_create - Create prefab from scene object
• prefab_apply - Apply instance changes to prefab
• prefab_unpack - Unpack prefab instance
• prefab_get_overrides - Get instance overrides
• prefab_revert_overrides - Revert to prefab values
• prefab_apply_overrides - Apply overrides to prefab
• prefab_create_variant - Create a prefab variant
• prefab_find_instances - Find all instances of a prefab in scene
• prefab_set_property - Set a property on a component inside a Prefab asset (supports basic types, vectors, colors, and asset references)

Skills

prefab_create

Create a prefab from a scene GameObject.

*At least one source identifier required.

Returns: {success, prefabPath, name, connected}: prefabPath is the saved asset's path, connected whether the scene object is now an instance of it. A save Unity refuses is an error, not a success.

prefab_instantiate

Instantiate a prefab into the scene.

Returns: {success, name, entityId, instanceId, path}

prefab_instantiate_batch

Instantiate multiple prefabs in one call.

Item properties: prefabPath, name, x, y, z (local position, relative to the parent if set), rotX, rotY, rotZ, scaleX, scaleY, scaleZ, parentEntityId, parentName, parentInstanceId, parentPath

Returns: {success, totalItems, successCount, failCount, results: [{success, name, entityId, instanceId, position, localPosition}]}: position is the world position read back, localPosition the local one. All-or-nothing: one failed item removes every instance the call created (rolledBack: true).

unity_skills.call_skill("prefab_instantiate_batch", items=[
    {"prefabPath": "Assets/Prefabs/Enemy.prefab", "x": 0, "z": 0, "name": "Enemy_01"},
    {"prefabPath": "Assets/Prefabs/Enemy.prefab", "x": 2, "z": 0, "name": "Enemy_02"},
    {"prefabPath": "Assets/Prefabs/Enemy.prefab", "x": 4, "z": 0, "name": "Enemy_03"}
])

prefab_apply

Apply instance changes back to the prefab asset.

*At least one identifier required.

Returns: {success, appliedTo} (appliedTo is the prefab asset path)

prefab_unpack

Unpack a prefab instance (break prefab connection).

*At least one identifier required.

Returns: {success, unpacked} (unpacked is the instance's GameObject name)

prefab_get_overrides

Get a summary of property overrides on a prefab instance (counts, not the individual override list).

Returns: {success, prefabPath, propertyOverrides, addedComponents, removedComponents, addedGameObjects, hasOverrides} — propertyOverrides/addedComponents/removedComponents/addedGameObjects are counts (int), not arrays; hasOverrides is true when any of those counts is non-zero.

prefab_revert_overrides

Revert all overrides on a prefab instance back to prefab values.

Returns: {success, reverted} (reverted is the prefab root's GameObject name)

prefab_apply_overrides

Apply all overrides from instance to source prefab asset.

Returns: {success, appliedTo} (appliedTo is the prefab asset path)

prefab_create_variant

Create a prefab variant from an existing prefab.

Returns: { success, sourcePath, variantPath, name, isVariant }: variantPath is the saved asset's path (.prefab appended when missing), isVariant whether Unity stored it as a variant of the source.