ue57-artclaw-highlight

ArtClaw Actor 高亮与定位

在 UE 编辑器中高亮、选中、聚焦指定 Actor，快速定位场景中的对象。

覆盖原 MCP 工具: highlight_actors（仅 UE）

⚠️ 仅适用于 Unreal Engine — Maya/Max 没有等效的视口高亮 API

调用方式

通过 MCP 工具 run_ue_python 执行 Python 代码实现 Actor 的选中与聚焦。

---

基础操作

按名称查找并选中 Actor

import unreal

target_name = "BP_Enemy_01"

all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
found = [a for a in all_actors if a.get_name() == target_name]

if found:
    unreal.EditorLevelLibrary.set_selected_level_actors(found)
    print(f"已选中: {target_name}")
else:
    print(f"未找到: {target_name}")

选中并聚焦（视口飞向目标）

import unreal

target_name = "BP_Enemy_01"

all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
found = [a for a in all_actors if a.get_name() == target_name]

if found:
    actor = found[0]
    # 选中
    unreal.EditorLevelLibrary.set_selected_level_actors([actor])
    # 聚焦视口到该 Actor（等效于编辑器中按 F 键）
    unreal.EditorLevelUtils.pilot_level_actor(actor)
    print(f"已聚焦到: {target_name}")

模糊搜索并高亮

import unreal

keyword = "Enemy"

all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
matched = [a for a in all_actors if keyword.lower() in a.get_name().lower()]

if matched:
    unreal.EditorLevelLibrary.set_selected_level_actors(matched)
    print(f"找到并选中 {len(matched)} 个包含 '{keyword}' 的 Actor:")
    for a in matched:
        print(f"  - {a.get_name()}")
else:
    print(f"未找到包含 '{keyword}' 的 Actor")

---

高级操作

按类型查找并高亮

import unreal

# 选中所有 StaticMeshActor
all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
static_meshes = [a for a in all_actors if a.get_class().get_name() == "StaticMeshActor"]

unreal.EditorLevelLibrary.set_selected_level_actors(static_meshes)
print(f"已选中 {len(static_meshes)} 个 StaticMeshActor")

按标签查找

import unreal

tag = "Interactive"

all_actors = unreal.EditorLevelLibrary.get_all_level_actors()
tagged = [a for a in all_actors if tag in [str(t) for t in a.tags]]

if tagged:
    unreal.EditorLevelLibrary.set_selected_level_actors(tagged)
    print(f"已选中 {len(tagged)} 个带有 '{tag}' 标签的 Actor")