原生UGUI

本地化UGUI - 《邪恶不再安息》UI库

总结/描述
Native UGUI 是一款可复用的UI辅助库 恶人无休 modders 基于 Unity 原生 UGUI 系统进行开发。

本项目的目标十分明确：大幅简化游戏模组菜单的构建流程，避免每次都得与原生Unity界面死磕。它为常用控件、布局工具、窗口、覆盖层及交互模式提供了更高级的开发者API，并附带了演示工程，清晰展示各模块的正确用法。

这理应既是 实用图书馆 和一个 学习资源 给其他模组作者使用的。

本模组包含内容

• 原生UGUI 用于构建游戏内界面的库
• UGUI演示 示例模组，展示更丰富的功能集与更高级的控件用法
• 简单演示 小巧的新手示例，展示基础窗口、常见控件，以及MelonLoader偏好设置的保存/加载功能
• 用于常见UI模式的可复用辅助工具，无需从头手动构建。
• 代码中各处的开发者注释，帮助模组制作者学习系统运作方式。
• mod重建或研究项目所需的文档、依赖说明及源文件（供模组制作者参考）
  

特色

• 可拖拽窗口
• 可调整窗口大小
• 按钮
• 标签与换行文本
• 输入字段
• 复选框
• 单选按钮
• 滑块
• 双柄范围滑块
• 下拉/组合式选择列表
• 标签页与标签栏
• 折叠页/树状节点/层级结构
• 上下文菜单
• 模态对话框
• 表格布局辅助工具
• 主题/风格选项辅助
• 【安全拖拽窗口，自动吸附屏幕边缘】
• 改进了对换行文本和可变高度内容的布局处理
  

我为何制作这个
很多Unity模组的UI工作往往重复、冗长且难以维护。原生UGUI正是为了减少这些麻烦，让Wicked模组作者能以更简洁的起点来创建设置菜单、调试工具及其他游戏内界面。

这个库提供了可复用的构建模块，可直接嵌入其他模组中，无需在每个项目里重复解决相同的布局和组件问题。

目标受众
此模组主要适用于：

• 模组开发者
• 学习如何为Wicked模组制作UI界面
• 想要可复用的游戏菜单框架，而非从零开始编写的开发者
  

若您并非模组制作者，这些演示内容或许仍有观赏价值，但本版本发布的核心目的实为： 开发者资源.

演示版内容
随附的示例演示了如何创建并组织以下内容：

• 基本控件
• 高级输入控件
• 标签式分页
• 树状结构
• 上下文菜单
• 模态提示
• 表格样式布局
• 主题/自定义图案
• 通过 MelonLoader 偏好设置持久保存的设定
  

UGUIDemo 旨在提供更完整的参考实现，而 SimpleDemo 更适合新模组作者作为入门起点。

Github / 源码
源代码、文档、依赖项说明及发布资源同样可在 GitHub 上获取：

GitHub 仓库
最新 GitHub 发布版本

如果你想研究代码、重新编译项目，或者在制作自己的模组时参考示例，GitHub 仓库是最好的起点。

笔记

• 该项目围绕 Unity UGUI在Il2Cpp模组环境中的实现
• 该库会尽可能承担繁重的工作，让模组作者能专注于打造自己想要的界面。
• API与演示仍在不断完善中，将陆续增加更多实用组件并优化细节
  

安装

• 安装模组所需前置 恶人无休
• 将提供的DLL文件放入 模组 文件夹
• 启动游戏
• 如需探索示例，请使用内置的演示快捷键
  

要求

• 恶人无安眠
• MelonLoader： 窗口 / Linux / macOS
• 发布包所需的其他依赖项
  

已知限制
该项目专注于实现实用、可复用的模组界面，而非完整复刻 Dear ImGui 的每个功能。部分高密度数据工具仍比真正的 ImGui 对应实现更为简化，但该库已能覆盖大量实际模组菜单的使用场景。

权限/使用
欢迎其他Mod作者研究本代码、从中学习，并用于自己的项目。若能注明出处，不胜感激。

制作人员

• 《恶意不息》由月亮工作室制作
• 底层UGUI框架使用Unity
• 尊敬的ImGui，感谢您在实用控件模式和开发者工作流设计上的启发