Skip to content

v1.6.3

Choose a tag to compare

View all tags
@Besty0728 Besty0728 released this 15 Mar 11:04
· 442 commits to main since this release
v1.6.3
33daf65

v1.6.3 — ProBuilder 3D 建模 & UGUI/UIToolkit 全面扩展

⭐ Highlight

  • ProBuilder 3D 网格建模（22 skills） — 全新 ProBuilderSkills.cs 模块，通过条件编译 #if PROBUILDER 支持可选包 com.unity.probuilder（5.x–7.x），未安装时所有 skill 返回友好错误提示。覆盖参数化形状创建、面拉伸/删除/合并/分离、边倒角/拉伸/桥接、顶点移动/焊接、UV 盒形投影、网格合并/细分/法线修正、批量创建等完整 3D 建模工作流，附带场景设计 Advisory 文档（空间规划、家具装配模式、人体工学数值参考）
  • UGUI 高级组件（+10 skills，16 → 26） — 基于 UGUI 源码实现完整控件层级结构：Dropdown（含 Template/ScrollRect/Viewport/Content/Item 五层子级）、ScrollView、ScrollBar、RawImage、Image 高级属性、LayoutElement 布局约束、CanvasGroup、Mask/RectMask2D、Shadow/Outline 视觉效果、Selectable 四态颜色与导航配置，TextMeshPro 智能检测优先使用
  • UI Toolkit 自动化（+10 skills + 4 模板，15 → 25） — UXML 元素增删改克隆、USS 规则操作与 CSS 变量提取、EditorWindow/Runtime UI 脚手架生成、UIDocument 实时层级检查，新增 tab-view/toolbar/card/notification 四种模板

Added

  • ProBuilderSkills（22 skills）：新增 ProBuilderSkills.cs 模块，通过条件编译 #if PROBUILDER 支持可选包 com.unity.probuilder（5.x–7.x）。未安装时所有 skill 返回友好错误提示及安装指引。包含：

    • probuilder_create_shape：创建参数化 ProBuilder 形状（Cube/Sphere/Cylinder/Cone/Torus/Prism/Arch/Pipe/Stairs/Door/Plane），支持位置、尺寸、旋转设置，支持 parent 参数指定父对象
    • probuilder_extrude_faces：面拉伸（IndividualFaces/FaceNormal/VertexNormal 三种模式）
    • probuilder_subdivide：细分整个网格或指定面
    • probuilder_bevel_edges：边倒角，支持顶点索引对指定
    • probuilder_delete_faces：按索引删除面
    • probuilder_merge_faces：合并多个面为单个面
    • probuilder_set_face_material：按面设置材质（支持 materialPath 或 submeshIndex）
    • probuilder_flip_normals：翻转面法线方向
    • probuilder_get_info：获取网格完整信息（顶点/面/边/三角形数、形状类型、材质列表、submesh 分布）
    • probuilder_center_pivot：居中枢轴或设置到指定世界坐标
    • probuilder_create_batch：批量创建多个 ProBuilder 形状
    • probuilder_move_vertices：按增量移动顶点（用于斜坡/坡道等造型）
    • probuilder_set_vertices：设置顶点绝对位置
    • probuilder_get_vertices：查询顶点位置信息
    • probuilder_combine_meshes：合并多个 ProBuilder 网格
    • probuilder_set_material：设置整个网格的材质（支持颜色快捷方式）
    • probuilder_detach_faces：分离面为独立对象
    • probuilder_extrude_edges：拉伸边创建墙体/栏杆
    • probuilder_bridge_edges：用新面连接两条边（创建门窗/连接几何结构）
    • probuilder_conform_normals：修正法线方向使其一致指向外侧
    • probuilder_weld_vertices：焊接相邻顶点
    • probuilder_project_uv：盒形投影 UV 坐标（主/光照图/自定义通道）
    • ProBuilder Advisory 模块：新增 skills/probuilder/SKILL.md 文档，包含完整技能参数说明、场景设计工作流指南（空间规划/布局/定位规则/常见模式）、家具与道具多部件装配模式、色彩编码原型制作指南、人体工学数值参考表（人体尺寸、跳跃距离、阶梯参数等）

  • UISkills 新增 10 skills（16 → 26）：基于 UGUI 源码实现完整控件层级结构：

    • ui_create_dropdown：创建 Dropdown（含 Template/ScrollRect/Viewport/Content/Item 完整子层级和 Toggle 选项），支持逗号分隔的选项列表
    • ui_create_scrollview：创建 ScrollRect 滚动视图（含 Viewport + RectMask2D + Content），支持方向和 MovementType 配置
    • ui_create_rawimage：创建 RawImage 元素（用于 Texture2D/RenderTexture 显示）
    • ui_create_scrollbar：创建独立 Scrollbar（含 Sliding Area + Handle），支持四方向和离散步数
    • ui_set_image：设置 Image 高级属性（Type: Simple/Sliced/Tiled/Filled、FillMethod: Radial360/Horizontal/Vertical 等、fillAmount、preserveAspect）
    • ui_add_layout_element：添加/配置 LayoutElement（minWidth/preferredWidth/flexibleWidth 等完整布局约束）
    • ui_add_canvas_group：添加/配置 CanvasGroup（alpha/interactable/blocksRaycasts/ignoreParentGroups）
    • ui_add_mask：添加 Mask（模板缓冲）或 RectMask2D（矩形裁剪）
    • ui_add_outline：添加 Shadow 或 Outline 视觉效果（颜色、距离、graphicAlpha）
    • ui_configure_selectable：配置 Selectable 属性（Transition 模式、ColorBlock 四态颜色、Navigation 模式）

  • UIToolkitSkills 新增 10 skills + 4 模板（15 → 25）：基于 UI Toolkit 源码示例实现 UXML/USS 程序化操作：

    • uitk_add_element：向 UXML 添加元素（Label/Button/Toggle/Slider/TextField 等），支持 name/text/classes/style/binding-path
    • uitk_remove_element：从 UXML 按 name 删除元素
    • uitk_modify_element：修改 UXML 元素属性（text/classes/style/name/binding-path/自定义属性）
    • uitk_clone_element：复制 UXML 元素（含子元素）
    • uitk_add_uss_rule：向 USS 文件添加或更新样式规则（自动检测已有选择器并替换）
    • uitk_remove_uss_rule：从 USS 删除指定选择器的规则
    • uitk_list_uss_variables：提取 USS 中所有 CSS 自定义属性定义和 var() 引用
    • uitk_create_editor_window：生成 EditorWindow C# 脚本模板（CreateGUI + UXML/USS 绑定 + MenuItem）
    • uitk_create_runtime_ui：生成运行时 MonoBehaviour 脚本（UIDocument 查询 + 事件注册/注销模式）
    • uitk_inspect_document：检查场景中 UIDocument 的 VisualElement 实时层级树（类型/名称/类列表/子节点）
    • 新增 4 个 uitk_create_from_template 模板：tab-view（标签页切换）、toolbar（顶部工具栏）、card（卡片组件）、notification（通知/Toast）

  • ui_create_batch 扩展：批量创建支持新增的 dropdown、scrollview、rawimage、scrollbar 类型

  • 本地化完整性：Localization.cs 补全所有 42 个新技能（ProBuilder 22 + UI 10 + UIToolkit 10）的英文/简体中文完整翻译

Changed

  • asmdef 引用扩展：UnitySkills.Editor.asmdef 新增 Unity.ProBuilder + Unity.ProBuilder.Editor 引用及 PROBUILDER versionDefines（[5.0,7.0)），与 Cinemachine 条件编译模式一致
  • REST Skills 总数：448 → 490（+22 ProBuilder + 10 UGUI + 10 UIToolkit）
  • Skills 文件数：38 → 39 个 *Skills.cs 文件
  • Advisory 模块数：13 → 14（+1 ProBuilder advisory）
  • ProBuilder 反射优化：形状尺寸设置通过反射访问 internal ProBuilderShape 属性和方法，兼容 ProBuilder 5.x–7.x 内部 API 变化
  • ProBuilder 材质快捷方式：probuilder_set_material 和 probuilder_set_face_material 支持 r/g/b/a 颜色参数，无需预创建材质即可快速原型制作

Compatibility

  • ✅ Unity 2022.3+：全部 490 个 skills 正常运行
  • ✅ Unity 6 (6000.x)：完整支持
  • ✅ ProBuilder 可选：未安装 com.unity.probuilder 时 22 个 ProBuilder skills 返回友好错误提示，不影响其他模块
  • ✅ 向后兼容：新增 skills 和 advisory 模块为纯增量，不破坏现有客户端

完整更改日志见 https://github.com/Besty0728/Unity-Skills/blob/main/CHANGELOG.md

Assets 2
Loading