Spell Renderer

模组

· 作者 getharlik

一款快速、轻量级的 Minecraft OpenGL 封装库,专为使用简洁流畅的 API 渲染 2D 对象而设计。

0 本站下载 0 关注 更新于 17 小时前

最新 26.5 · 26.2 · Fabric

一键开服(送7天)

✨ Spell Renderer

面向 Fabric 模组的现代化 2D UI 渲染:圆角面板、液态玻璃、清晰文本和可拖拽 HUD,全部来自一个流畅的 API。

预览

在 Minecraft 中构建美观的界面通常意味着要与 GuiGraphics 搏斗,或者自己编写原始 OpenGL。Spell Renderer 为你提供了一个小巧且可链式调用的构建器。你只需描述形状并调用 .submit(),库便会处理着色器、批处理、缩放和裁剪。

📦 这是一个库模组。 单独安装它不会向游戏添加任何内容。如果其他模组需要它,请安装它;或者使用它来构建你自己的 UI。


🎨 你可以绘制的内容

形状 用途
矩形 具有圆角的窗格和按钮,每个角落可以有不同半径,以及渐变色
圆形 圆点、指示器、头像
图像 可选圆角的纹理
文本 任意尺寸下保持清晰的文本,使用 MSDF 字体
图标 来自你自己图标字体的命名图标,例如 Builder.icon("settings")
玻璃 磨砂或液态玻璃面板,支持调整模糊、折射等效果

🧊 新增:液态玻璃

玻璃面板已从底层重新构建。每个面板都有独立的设置:

  • 模糊。 从几乎不可见到重度磨砂,且所有半径的成本相同,因此重度模糊不会拖慢你的 UI 性能。
  • 折射。 边缘像透镜一样弯曲背景,呈现液态玻璃外观。将其设置为 0 可获得平面磨砂玻璃效果。
  • 色散。 边缘处微妙的 RGB 色差条纹。
  • 饱和度。 使玻璃后面的背景更加生动,或将其转为灰度。
  • 高光。 边缘处的一圈细光。
Builder.glass()
        .pos(20, 20)
        .size(200, 120)
        .radius(16)
        .blur(16)
        .refraction(0.9f)
        .chromatic(4)
        .saturation(1.4f)
        .highlight(0.3f)
        .submit();

现在玻璃在任何 UI 缩放比例下看起来都一致,并且玻璃叠加玻璃的效果也如预期般工作。

⚡ 功能特性

  • 🔗 流畅构建器。 在一个可读的链式调用中完成定位、大小、颜色、圆角和淡入淡出。
  • 🖱️ 可拖拽形状。 为形状添加 .draggable("id"),玩家即可用鼠标移动它。其子元素会随其一起移动,无法移出屏幕,且位置可以保存和恢复。
  • 👪 父子关系。 将形状附加到父级上,它们将跟随父级的位置、深度和不透明度。
  • 🚀 批量渲染。 相同类型的形状会在一次绘制调用中一起绘制。
  • 🔤 MSDF 文本。 文本在任何缩放比例和任何 GUI 尺寸下都保持清晰。
  • ✂️ 剪刀(裁剪)。 将绘制区域限制在指定范围内,这对于滚动列表和蒙版面板非常有用。
  • 🔍 缩放。 独立于 Minecraft 的 GUI 缩放比例来缩放整个 UI。
  • 🧭 渲染上下文。 在游戏过程中在 HUD 上绘制,或在每个屏幕之上的 GUI 层上绘制。(世界渲染正在开发中。)

🧑‍💻 代码示例

SpellRenderer.on(RenderContext.HUD, () -> {
    var panel = Builder.rect()
            .pos(20, 20)
            .size(220, 80)
            .radius(12)
            .color(new Color(30, 30, 40))
            .draggable("my-panel");   // 玩家在打开聊天时也可以移动它
    panel.submit();

    Builder.text("Hello, Spell!")
            .pos(12, 12)
            .size(24)
            .parent(panel)            // 随面板一起移动
            .submit();
});

📥 快速开始

从 Modrinth Maven 添加依赖:

repositories {
    maven { url = "https://api.modrinth.com/maven" }
}

dependencies {
    implementation "maven.modrinth:spell-renderer:<version>"
    include "maven.modrinth:spell-renderer:<version>" // 可选:将其打包进你的模组中
}

Maven 配置、字体和图标的添加方法以及完整的 API 请参阅 GitHub 上的文档。

📋 要求

  • Minecraft 26.2
  • Fabric Loader >=0.20.1+
  • Fabric API
  • Java 25

💬 发现 bug 或有想法?

请在 GitHub 上提交 Issue。欢迎提供反馈和贡献!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源