Leiv的GUI引擎

Leiv的GUI引擎

Leiv的GUI引擎是一个轻量级、高性能的UI框架,为我的所有模组提供现代、无缝且统一的菜单和实时HUD覆盖层。

🎨 Leiv 的 GUI 引擎

Leiv 的 GUI 引擎是 Leiv 生态套件中负责视觉渲染的框架和界面库。

当 Leiv 的 API 处理逻辑,Leiv 的翻译 API 管理文本时,这个库负责驱动你在屏幕上看到的所有内容。它是一个高度优化、跨加载器的系统,用于渲染动态 HUD、交互式配置菜单和响应式提示框。它确保像 Keybind Profiles 和 ItemCuller 这样的模组在所有模组加载器上都能拥有美观、高度可定制且一致的用户界面。

⚠️ 玩家注意事项: 这是 Leiv 生态系统中界面和 HUD 驱动模组的必需核心依赖。它不会向游戏添加独立的内容,但必须与我的任何实用模组一起安装,才能正确显示它们的覆盖层和菜单!

✨ 主要特性

  • 🎨 模块化 HUD 系统: 具有动态 HUD 锚点系统,允许模组覆盖层轻松地开启/关闭,并吸附到屏幕的任何角落(左上、右下等)。
  • ✨ 一致的视觉风格: 确保生态系统中的所有模组共享同样精致、高性能的 UI 设计。
  • 🚀 无延迟渲染: 高度优化的绘制调用确保复杂的屏幕覆盖层和菜单绝不会影响你的帧率(FPS)。
  • 🧩 交互式提示框: 与 Leiv 的翻译 API 无缝集成,在鼠标悬停在设置上时即时显示动态、数据驱动的提示框。

🛠️ 技术亮点(面向开发者 & 整合包作者)

Leiv 的 GUI 引擎将复杂的、特定于加载器的屏幕绘制例程抽象为一个对开发者友好的流程:

  • 🖥️ HudAnchor 抽象: 一个集中式定位工具,可根据 Window/ScaledResolution 大小和用户配置自动计算动态的 X/Y 坐标。
  • ⚙️ 规则驱动的菜单: 自动将来自 Leiv 的 API 的 ValueRule<T> 配置对象转换为完全交互式的按钮、滑块和开关,而无需手动编写 UI 代码。
  • 📦 跨加载器 UI: 提供统一的渲染管线,完全抽象了 Forge、NeoForge 和 Fabric 的 GUI 屏幕之间的差异。

  • 🪟 安全的屏幕注入: 安全地挂钩到游戏的原生渲染线程,以干净、兼容的方式注入自定义 HUD 覆盖层和配置界面。

🔗 依赖项

这个库让生态系统的底层逻辑在你的屏幕上呈现出来:

  • 需要: Leiv 的 Lib、Leiv 的 API 和 Leiv 的翻译 API (请确保它们已安装!)
  • 被以下模组使用: Leiv 的配置菜单、Keybind Profiles、ItemCuller、EnderStash、Sneak Auto Crop,以及所有其他启用 GUI 的 Leiv 生态模组。

💬 社区与支持

有问题、有反馈或需要报告错误?加入社区吧!

  • 👥 Discord: 加入 Leiv 的社区
  • 🐛 问题追踪器: 通过官方 Discord 工单系统或我们的 GitHub Issues 页面报告错误。