italink/unrealclientprotocol/unreal-modeling

Claude Code and agent skill by italink/unrealclientprotocol

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

通过 GeometryScript + UCP 进行程序化网格建模。当用户要求创建、修改、修复、简化、UV、布尔、变形或以其他方式处理网格时使用。

Install

npx vskill@latest install italink/unrealclientprotocol/unreal-modeling

SKILL.md

网格建模

建模通过两条路径完成：MeshOperationLibrary（生命周期管理 + 类型桥接）和 GeometryScript 原生库（600+ 函数，通过 UCP 通用 call 直接调用）。

前置条件：UE 编辑器运行中，UCP 插件已启用。传输层规则见 unreal-client-protocol。

MeshOperationLibrary

CDO：/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary

生命周期
函数参数说明
CreateDynamicMesh—创建空的临时 DynamicMesh，返回对象路径
ReleaseDynamicMeshMesh标记 mesh 等待 GC 回收
ReleaseAllDynamicMeshes—释放所有已跟踪的 mesh
ListDynamicMeshes—列出所有已跟踪 mesh 的路径
摘要
函数参数说明
GetMeshSummaryTargetMesh返回 JSON：vertexCount、triangleCount、uvSetCount、bounds、hasNormals、hasVertexColors、hasMaterialIDs、hasPolygroups、isClosed、isDense
资产读写
函数参数说明
CopyFromStaticMeshTargetMesh, SourceStaticMesh将 StaticMesh 加载到 DynamicMesh（默认选项）
CopyToStaticMeshSourceMesh, TargetStaticMesh将 DynamicMesh 写回已有 StaticMesh
CopyToNewStaticMeshAssetSourceMesh, AssetPath创建新 StaticMesh 资产，返回资产路径
Selection 桥接

GeometryScript 的 FGeometryScriptMeshSelection 内部使用不可序列化的 TSharedPtr 存储数据，无法通过 JSON 传递。以下函数从可序列化的输入创建 Selection：

函数参数说明
SelectAllTrianglesTargetMesh选择全部三角形
SelectTrianglesByIDsTargetMesh, TriangleIDs(int 数组)按 ID 选择三角形
SelectVerticesByIDsTargetMesh, VertexIDs(int 数组)按 ID 选择顶点
SelectPolygroupByIDTargetMesh, PolygroupID, GroupLayer按 Polygroup 选择
SelectMaterialByIDTargetMesh, MaterialID按材质 ID 选择
GetSelectionIDsSelection从 Selection 提取 ID 数组
数据类型桥接

GeometryScript 的列表类型（FGeometryScriptIndexList、FGeometryScriptVectorList 等）将数据存储在不可序列化的 TSharedPtr<TArray<...>> 中。用 Make* 从数组创建，用 Get*Array 提取：

Make 函数Get 函数桥接类型
MakeIndexList(Indices, IndexType)GetIndexListArrayFGeometryScriptIndexList
MakeVectorList(Vectors)GetVectorListArrayFGeometryScriptVectorList
MakePolyPath(Points, bClosedLoop)GetPolyPathArrayFGeometryScriptPolyPath
MakeSimplePolygon(Vertices)GetSimplePolygonArrayFGeometryScriptSimplePolygon
MakeColorList(Colors)GetColorListArrayFGeometryScriptColorList
MakeUVList(UVs)GetUVListArrayFGeometryScriptUVList
MakeScalarList(Scalars)GetScalarListArrayFGeometryScriptScalarList
MakeTriangleList(Triangles)GetTriangleListArrayFGeometryScriptTriangleList

直接调用 GeometryScript

GeometryScript 函数是标准的 BlueprintCallable 静态函数，通过 UCP 通用 call + CDO 路径调用。

CDO 路径格式
/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_<类名>

示例：/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshRepairFunctions

参数规则
  • `UDynamicMesh*`：传路径字符串，如 "/Engine/Transient.DynamicMesh_0"
  • `USTRUCT` Options：传 JSON 对象，只写需要覆盖的字段，省略的字段使用默认值
  • `UENUM`：传字符串，即枚举值名，如 "Automatic"、"AttributeAware"
  • `out` 参数（如 Outcome、NumFilledHoles）：输入时省略，结果中自动返回
  • `Debug`：省略（默认 nullptr）
  • `WorldContextObject`：UCP 自动注入
返回值

多数 GeometryScript 函数返回 UDynamicMesh*（同一个对象，原地修改）。响应中包含 mesh 路径和所有 out 参数。

标准工作流

示例 1：加载 → 简化 → 写回
json
// 1. 创建工作 mesh
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"CreateDynamicMesh"}
// 2. 从 StaticMesh 加载
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"CopyFromStaticMesh","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","SourceStaticMesh":"/Game/Meshes/SM_Rock.SM_Rock"}}
// 3. 简化到 5000 三角形
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshSimplifyFunctions","function":"ApplySimplifyToTriangleCount","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","TriangleCount":5000,"Options":{"Method":"AttributeAware"}}}
// 4. 写回
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"CopyToStaticMesh","params":{"SourceMesh":"/Engine/Transient.DynamicMesh_0","TargetStaticMesh":"/Game/Meshes/SM_Rock.SM_Rock"}}
// 5. 释放
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"ReleaseDynamicMesh","params":{"Mesh":"/Engine/Transient.DynamicMesh_0"}}
示例 2：创建图元 → 保存为新资产
json
// 1. 创建 mesh
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"CreateDynamicMesh"}
// 2. 追加 Box 图元
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshPrimitiveFunctions","function":"AppendBox","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","PrimitiveOptions":{},"DimensionX":100,"DimensionY":100,"DimensionZ":100}}
// 3. 自动生成 UV
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshUVFunctions","function":"AutoGenerateXAtlasMeshUVs","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","UVSetIndex":0,"Options":{}}}
// 4. 保存为新资产
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"CopyToNewStaticMeshAsset","params":{"SourceMesh":"/Engine/Transient.DynamicMesh_0","AssetPath":"/Game/Generated/SM_Box"}}
// 5. 释放
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"ReleaseDynamicMesh","params":{"Mesh":"/Engine/Transient.DynamicMesh_0"}}
示例 3：布尔合并
json
// 1-2. 创建两个 mesh 并填充（CreateDynamicMesh + AppendSphere / AppendBox）
// 3. 布尔合并
{"object":"/Script/GeometryScriptingCore.Default__GeometryScriptLibrary_MeshBooleanFunctions","function":"ApplyMeshBoolean","params":{"TargetMesh":"/Engine/Transient.DynamicMesh_0","TargetTransform":{"Rotation":{"X":0,"Y":0,"Z":0,"W":1},"Translation":{"X":0,"Y":0,"Z":0},"Scale3D":{"X":1,"Y":1,"Z":1}},"ToolMesh":"/Engine/Transient.DynamicMesh_1","ToolTransform":{"Rotation":{"X":0,"Y":0,"Z":0,"W":1},"Translation":{"X":50,"Y":0,"Z":0},"Scale3D":{"X":1,"Y":1,"Z":1}},"BooleanOperation":"Union","Options":{}}}
// 4. 释放 mesh B
{"object":"/Script/UnrealClientProtocolEditor.Default__MeshOperationLibrary","function":"ReleaseDynamicMesh","params":{"Mesh":"/Engine/Transient.DynamicMesh_1"}}

GeometryScript 库索引

每个库对应一个域 Skill，包含完整的函数签名、Options 结构体字段、枚举值和 JSON 示例：

域 Skill覆盖的库
unreal-modeling-primitivesMeshPrimitiveFunctions、MeshModelingFunctions、PolyPathFunctions、SimplePolygonFunctions、PolygonListFunctions
unreal-modeling-meshopsMeshRepairFunctions、MeshSimplifyFunctions、RemeshingFunctions、MeshBooleanFunctions、MeshVoxelFunctions、MeshDecompositionFunctions、MeshBasicEditFunctions、MeshSubdivideFunctions、OpenSubdivFunctions
unreal-modeling-uvMeshUVFunctions
unreal-modeling-normalsMeshNormalsFunctions
unreal-modeling-deformMeshDeformFunctions、MeshTransformFunctions
unreal-modeling-queryMeshQueryFunctions、MeshSpatialFunctions、MeshSamplingFunctions、ContainmentFunctions、MeshComparisonFunctions、MeshGeodesicFunctions
unreal-modeling-selectionMeshSelectionFunctions
unreal-modeling-attributesMeshVertexColorFunctions、MeshPolygroupFunctions、MeshMaterialFunctions
unreal-modeling-assetStaticMeshFunctions、CreateNewAssetFunctions、CollisionFunctions、EditorDynamicMeshFunctions

关键规则

  1. 先创建再操作：调用 GeometryScript 前必须有 DynamicMesh（通过 CreateDynamicMesh 或 CopyFromStaticMesh 获取）
  2. 用完即释放：调用 ReleaseDynamicMesh 避免临时对象堆积
  3. 原地修改：多数 GeometryScript 函数原地修改 mesh 并返回同一个 UDynamicMesh*
  4. Options 可选：USTRUCT Options 参数有合理默认值，只传需要覆盖的字段
  5. 不可序列化类型用桥接函数：当 GeometryScript 函数需要 FGeometryScriptMeshSelection、FGeometryScriptIndexList、FGeometryScriptPolyPath 等类型时，用 MeshOperationLibrary 的桥接函数从普通数组创建
  6. 用 `DescribeObject` 探索：对任意 GeometryScript CDO 调用 DescribeObject 可查看完整函数列表和签名

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
114
Repository forks
14
7-day trend score
24

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/italink/unrealclientprotocol/unreal-modeling/badge)](https://verified-skill.com/skills/italink/unrealclientprotocol/unreal-modeling)

Something wrong with this skill or its page? Tell us.