MellosWidget · Documentation / 文档中心 · 其他语言： MellosWidget · User Guide

用自己的游戏数据，组合可编辑面板、列表和天赋图；用风格资产统一管理外观与动效。

维护方： mellos game · 首发目标： UE 5.8 / Win64

文档版本： 1.0.0 准备版 · 更新日期： 2026-09-10

技术支持： [email protected]

<aside> 💡

第一次使用？ 按第 2–3 章完成一个数据面板，再用第 9 章的「验证资源」检查配置。换肤看第 6 章，科技跳字看第 7 章，多语言看第 8 章。

</aside>

本文对应当前开发实现。首发仍在准备中，具体发行包的已验证能力以随包记录为准。

1. 功能与职责

MellosWidget 根据 UObject 的类型与成员生成界面。蓝图和 C++ 共用数据契约，可以构建属性编辑器、设置面板、物品列表，以及多个父节点共享子节点的天赋图。

模块 负责什么
游戏数据 状态、业务规则、消耗、存档与联网权限
控件册 将精确用途和兼容数据类型映射到控件模板
组合与生成 生成面板、列表和图，管理会话内对象与控件的对应关系
风格 字体、颜色、画刷、材质、语义视觉状态与统一动效
页面 持有数据、转发操作，在数据变化后请求刷新

默认控件册、风格与可复用蓝图模板位于 /MellosWidget/。插件不依赖 MCP、AI 服务或原开发工程。演示项目里的元素战斗、SettingsScreen、角色与场景插画属于项目内容，不能视为通用运行时功能，也不代表每份插件发行包均包含这些资源。

2. 安装与项目准备

  1. Fab 安装： 安装到匹配的 UE 5.8，在 Edit → Plugins 启用 MellosWidget，然后重启编辑器。
  2. 源码安装： 确认描述文件位于 YourProject/Plugins/MellosWidget/MellosWidget.uplugin。生成工程文件，使用 UE 5.8 工具链编译项目的 Development Editor 目标。
  3. 引擎与项目搜索路径中只保留一份插件。在内容浏览器启用 Show Plugin Content。
  4. 将 /MellosWidget/DA_WidgetPalette 与 /MellosWidget/DA_MellosStyle 复制到自己的目录，例如 /Game/MyUI/。修改副本，避免插件升级覆盖项目配置。

首发目标为 UE 5.8 / Win64；其他引擎版本和平台需独立验证。运行时控件操作应在游戏线程执行。

3. 做出第一个数据面板

第一步：定义数据