Function asset_prefab

unity_cli/cli/commands/asset.py:28–50

Save a scene GameObject (and its children) as a Prefab asset. Examples: u asset prefab -s Player -p Assets/Prefabs/Player.prefab u asset prefab --source-id 12345 -p Assets/Prefabs/Enemy.prefab

(
    ctx: typer.Context,
    path: Annotated[str, typer.Option("--path", "-p", help="Output path (e.g., Assets/Prefabs/My.prefab)")],
    source: Annotated[str | None, typer.Option("--source", "-s", help="Source GameObject name")] = None,
    source_id: Annotated[int | None, typer.Option("--source-id", help="Source GameObject instance ID")] = None,
)

@asset_app.command("prefab")
@handle_cli_errors
def asset_prefab(
    ctx: typer.Context,
    path: Annotated[str, typer.Option("--path", "-p", help="Output path (e.g., Assets/Prefabs/My.prefab)")],
    source: Annotated[str | None, typer.Option("--source", "-s", help="Source GameObject name")] = None,
    source_id: Annotated[int | None, typer.Option("--source-id", help="Source GameObject instance ID")] = None,
) -> None:
    """Save a scene GameObject (and its children) as a Prefab asset.

    Examples:
        u asset prefab -s Player -p Assets/Prefabs/Player.prefab
        u asset prefab --source-id 12345 -p Assets/Prefabs/Enemy.prefab
    """
    context: CLIContext = ctx.obj

    if not source and source_id is None:
        _exit_usage("--source or --source-id required", "u asset prefab")

    result = context.client.asset.create_prefab(
        path=path,
        source=source,
        source_id=source_id,
    )
    print_success(result.get("message", f"Prefab created: {path}"))


@asset_app.command("scriptable-object")