NegiLib

插件

· 作者 mituba4154

Minecraft UI 运行时 API 插件

0 本站下载 0 关注 更新于 1 周前

需要前置:间歇泉

最新 1.20-v · 26.3 · Velocity

一键开服(送7天)

NegiLib

一款适用于 Minecraft 服务器的现代化跨平台 UI 库。

NegiLib 是一款专为 Minecraft 插件开发者设计的强大 UI 框架。它提供统一的 API,用于在 Java 版和基岩版之间创建交互式菜单,并支持 Paper、Purpur、Folia 以及 GeyserMC。

NegiLib 最初作为 EasyMenu v7 的基础开发而成,同时也作为独立库供其他插件使用。

一次构建,支持多种 UI 系统,让 NegiLib 处理渲染工作。

✨ 功能特性

?️ 多种 UI 后端

  • Inventory GUI: 兼容旧版 Minecraft 的传统基于箱子的菜单。
  • Java Native Dialog: 使用 Minecraft 原生 Dialog API 的现代交互式菜单。
  • Bedrock Rich UI: 由基岩版 JSON UI 和资源包驱动的多列自定义菜单。
  • 自动回退: 当首选渲染器不可用时,会自动回退到兼容的 UI 后端。

? 丰富的 UI 与自定义选项

  • 多列按钮布局。
  • 自定义物品图标和纹理。
  • 彩色文本、描述和工具提示。
  • 可滚动的基岩版菜单。
  • 支持不同的屏幕尺寸和输入方式。
  • 资源包的生成与管理。

⚡ 对开发者友好的架构

  • 跨支持平台的统一 Java API。
  • 可扩展的渲染系统,支持自定义渲染器。
  • 内置 UI 会话和交互管理。
  • 感知平台的调度机制,包括 Folia 兼容性。
  • 异步资源准备。
  • 自动检测 UI 功能。
  • 旨在最大限度地减少特定版本的依赖。

? GeyserMC 集成

NegiLib 通过 GeyserMC 支持基岩版玩家。

NegiLib 不仅限于标准的垂直基岩版表单,还可以使用 JSON UI 显示自定义的网格界面。

Rich UI 功能包括自定义布局、物品图标、工具提示和滚动,并在 Rich UI 不可用时提供支持回退。

无需额外的客户端模组。

? 安装

Paper / Purpur / Folia

  1. 下载最新的 NegiLib JAR 文件。
  2. 将其放入服务器的 plugins/ 目录中。
  3. 重启服务器。
  4. 安装一个使用 NegiLib 的兼容插件,例如 EasyMenu 7。

如果仅需支持 Java 版,NegiLib 可以在没有 GeyserMC 的情况下运行。

基岩版支持 — Paper 上的 Geyser

如果您的 Paper 兼容服务器上直接安装了 GeyserMC:

  1. 在服务器上安装 NegiLib。
  2. 安装 Geyser-Spigot。
  3. 重启服务器。
  4. 使用基岩版客户端连接。

此设置不需要 Velocity 配套插件。

基岩版支持 — Velocity 上的 Geyser

如果您的 GeyserMC 运行在 Velocity 代理上,您必须安装单独的 NegiLib Geyser Velocity 配套插件。

Velocity 代理:

  1. 安装 Geyser-Velocity。
  2. 将 NegiLib Geyser Velocity 安装到代理的 plugins/ 目录中。

后端服务器(Paper / Purpur / Folia):

  1. 在每个使用 NegiLib 的后端服务器上安装常规的 NegiLib 插件。
  2. 根据需要安装 EasyMenu 或其他基于 NegiLib 的插件。
  3. 重启代理和后端服务器。

重要提示: Velocity 配套插件不能替代常规的 NegiLib 插件。在使用 NegiLib 配合 Geyser-Velocity 时,两个组件都是必需的。

Velocity 配套插件负责处理基岩版 UI 通信和资源包分发,而后端 NegiLib 插件则管理菜单、渲染请求和交互。

?️ 兼容性

  • 服务器软件: Paper, Purpur, Folia
  • Minecraft Java Edition: 1.20.1+
  • 原生对话框 (Native Dialog): 在支持的较新版本 Minecraft 中可用
  • 基岩版 (Bedrock Edition): 通过 GeyserMC
  • 代理集成: 配合 NegiLib Geyser Velocity 配套插件的 Velocity
  • Java: Java 17+ 字节码兼容性;较新的 Minecraft 服务器版本可能需要更新的 Java 运行时环境

与新发布的 Minecraft 版本的兼容性可能需要额外验证。

不支持 Spigot。

?‍? 给开发者

NegiLib 的设计初衷是使其不仅仅局限于 EasyMenu,具有更高的复用性。

其公开 API 提供了针对 UI 文档、交互元素、渲染器选择、会话管理和玩家交互的抽象。

开发者可以基于 NegiLib 实现自己的菜单系统,而无需关心平台特定的渲染和兼容性细节。

? API 文档

API 参考文档正在准备中。

NegiLib 的公开 API 已可用,但完整的开发者文档、集成指南和代码示例尚未发布。

请密切关注官方 API 参考!


NegiLib —— 一套 UI 框架,多平台支持。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源