UIcore

插件

· 作者 kekaop

为 Minecraft 服务器使用 YAML 和 Java API 创建交互式世界空间菜单。功能包括自定义按钮、动态元素、物品显示、蓝图预览等。无需资源包。

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

需要前置:PacketEvents

最新 1.1.0 · 1.21.11 · Folia / Paper

一键开服(送7天)

适用于 Minecraft 服务器的世界空间 UI 框架。

YAML 配置 · 公开 Java API · 无需资源包 · 支持 Paper 和 Folia


🚀 重新构想 Minecraft 服务器界面

当菜单可以成为游戏世界的一部分时,为什么还要将服务器的界面局限于传统的箱子库存呢?

UIcore 是一款专为 Minecraft 服务器设计的世界空间用户界面框架。与打开常规的库存屏幕不同,UIcore 将交互式菜单元素放置在玩家相机周围,创造出一种融入 Minecraft 环境的界面体验。

文本标签、按钮、物品预览、玩家头像、切换开关和输入框都可以成为统一交互场景的一部分。

玩家使用视觉光标与这些元素进行交互,允许他们在菜单中导航、悬停在按钮上、触发操作、在屏幕之间切换,并通过 Minecraft 的聊天系统输入文本。

UIcore 为服务器所有者和插件开发者在设计界面时提供了更大的灵活性,使得创建超越传统基于库存菜单的体验成为可能。

✨ 主要亮点

  • 世界空间界面: 直接在 Minecraft 世界中显示菜单元素。
  • 交互式控件: 按钮、工具提示、悬停反馈、点击动画等。
  • 基于 YAML 的配置: 无需开发单独的 Java 插件即可创建菜单。
  • 公开 Java API: 通过自定义逻辑和组件扩展框架。
  • 动态元素: 根据单个玩家的状态更改文本、材质和可见性。 结构预览: 在不修改真实方块的情况下显示玩家特定的结构。
  • 可选集成: 在需要时将 UIcore 与其他服务器插件连接。
  • 无强制资源包: 捆绑的示例使用原版 Minecraft 物品。

无论您是在构建简单的导航菜单还是更复杂的界面系统,UIcore 都提供了直接在 Minecraft 内部创建交互体验所需的工具。


🧩 功能特性

🖱️ 1. 交互式屏幕与导航

使用围绕玩家相机定位的交互元素创建完整的菜单屏幕。

UIcore 支持:

  • 文本标签: 将信息显示为界面的一部分。
  • 交互按钮: 让玩家通过菜单元素触发操作。
  • 视觉光标导航: 使用游戏内光标在交互元素之间移动。
  • 悬停反馈: 当玩家指向某个元素时做出反应。
  • 光标样式: 通过支持的样式自定义光标的行为和外观。
  • 工具提示: 提供关于菜单元素的附加信息。
  • 点击动画: 在与元素交互时给予玩家视觉反馈。
  • 点击冷却: 控制操作触发的频率。
  • 屏幕过渡: 在不同菜单和屏幕之间导航。

这些功能允许开发者构建感觉更像专用游戏界面而非传统库存菜单的交互布局。

🔄 2. 动态内容、输入与玩家状态

UIcore 不仅限于静态菜单布局。

其状态和条件系统允许界面元素对玩家动作和服务器端逻辑做出反应。

可用功能包括:

  • 基于聊天的文本输入: 通过 Minecraft 聊天接收用户输入。
  • 切换控件: 构建具有多个可选状态的元素。
  • 权限检查: 基于玩家权限限制操作。
  • 点击要求: 定义在执行操作之前必须满足的条件。
  • 每位玩家的元素状态: 为不同玩家维护独立的界面状态。
  • 动态文本: 根据元素状态更改显示的标签。
  • 动态材质: 更新元素显示的物品或材质。
  • 条件可见性: 根据其状态显示或隐藏元素。

例如,设置屏幕可以为单个玩家显示不同的切换状态,而不可用的选项可以根据配置的条件被隐藏或以不同方式呈现。

这使得 UIcore 适用于需要反映玩家特定信息和服务器行为的界面。

🎒 3. 物品展示、玩家头像与画廊

Minecraft 物品可用作自定义界面内的视觉组件。

UIcore 提供了以下功能:

  • 显示 Minecraft 物品。
  • 展示玩家头像。
  • 创建物品画廊。
  • 使用可重用的元素模板。
  • 构建具有可选内容的槽位。

这些功能可用于设计物品选择器、视觉目录、个人资料屏幕、收藏集以及其他视觉内容起重要作用的界面。

开发者可以不完全依赖库存槽位,而是将物品组织为自定义世界空间布局的一部分。

🏗️ 4. 玩家专属结构预览

直接在菜单中预览结构,而不改变实际的 Minecraft 世界。

UIcore 支持使用 Sponge .schem 格式(v2 和 v3 版本)最多四个玩家专属结构预览。

关键特性:

  • 在菜单中显示最多四个结构预览。
  • 仅向相关玩家发送预览数据。
  • 保持实际世界方块不变。
  • 将预览用作建筑选择器、目录或其他自定义界面的一部分。

这允许玩家在不需要将其物理放置在世界中的情况下直观地检查结构。

当前限制: 结构预览显示方块状态,但不复制容器或其他方块实体内容、实体或生物群系。

👁️ 5. 玩家可见性、隐私与伤害设置

不同的界面可能需要与周围游戏世界不同程度的隔离。

UIcore 提供每菜单设置,控制玩家和界面如何与其他玩家互动。

您可以配置:

  • 其他玩家能否看到菜单的显示元素。
  • 打开菜单的玩家对其他玩家是否隐藏。
  • 菜单使用者对其他玩家是否隐藏。
  • 在菜单开启期间,是否允许或阻止来自其他玩家的伤害。

这些设置在设计服务器大厅、游戏模式选择以及其他需要控制玩家与周围世界交互的场景中非常有用。


🛠️ 两种构建方式:YAML 和 Java API

UIcore 专为服务器管理员和 Java 插件开发者设计。

您可以使用 YAML 配置菜单,或通过其公共 API 扩展框架。

📝 YAML 菜单配置

通过 YAML 配置文件创建和管理界面。

这种方法允许服务器所有者无需为每个界面编写单独的 Java 插件即可定义菜单。

YAML 适用于以下场景:

  • 服务器导航菜单。
  • 玩家个人资料屏幕。
  • 设置界面。
  • 游戏模式选择器。
  • 物品画廊。
  • 其他可配置的菜单系统。

菜单文件存储在:

plugins/UIcore/menu/

添加或修改菜单后,请使用以下命令重新加载配置:

/uicore reload

有关配置结构、支持的元素、操作和示例,请参阅 菜单制作指南。

UIcore — 在 Minecraft 世界中构建交互式菜单

☕ 公共 Java API

对于更高级的开发,UIcore 提供了公共 Java API。

开发者可以通过注册以下内容来扩展框架:

  • 自定义动作: 定义玩家在与元素交互时的额外行为。
  • 数据提供者: 从外部系统或您自己的插件提供信息。
  • 条件: 添加自定义要求和交互逻辑。
  • 自定义组件: 扩展可用的界面元素。

这使得 UIcore 不仅作为可配置的菜单插件有用,还作为其他 Minecraft 服务器系统的界面基础。

API 允许开发者将 UIcore 接口连接到他们自己的插件功能,而不是构建一个完全独立的 UI 系统。


🎮 您可以使用 UIcore 构建什么?

UIcore 可以作为许多不同 Minecraft 服务器功能的接口层。

🏠 服务器大厅和导航

构建一个中央导航界面,让玩家能够访问服务器的不同部分。

使用按钮、标签、物品显示和屏幕过渡来组织导航。

👤 玩家资料

创建包含玩家头像、信息、物品和交互动作的资料界面。

可以使用动态状态和数据提供者将界面连接到特定于玩家的信息。

⚙️ 设置菜单

使用开关、条件和单独的玩家状态构建可配置的设置屏幕。

元素可以根据所选状态更新其外观或可见性。

🛒 商店和物品目录

使用物品显示和画廊创建可用物品的视觉目录。

将菜单操作连接到您自己的购买或交易逻辑。

🌍 游戏模式选择

为不同的游戏模式或服务器目的地设计选择屏幕。

结合视觉元素、导航按钮和特定于玩家的条件。

🏰 建筑和结构画廊

让玩家在选择之前预览蓝图结构。

支持 Sponge 蓝图的预览显示,而无需修改真实世界的方块。

🔌 自定义插件界面

使用 Java API 为您的插件创建界面,包括自定义动作、数据源、条件和组件。

注意: 这些是使用 UIcore 功能可以构建的系统示例。特定于应用程序的逻辑,如支付处理、持久化或游戏模式管理,必须由相关的服务器插件实现或提供。


🔗 集成

UIcore 支持与其它 Minecraft 服务器插件集成。

内置可选集成

  • Vault
  • LuckPerms

其他可选集成

  • PlaceholderAPI
  • FancyNpcs
  • SkinsRestorer
  • CraftEngine

所有列出的集成都是可选的。

即使未安装这些插件,UIcore 也可以启动。然而,依赖于特定集成的功能需要相应的插件存在。

这允许服务器所有者在不安装无关依赖项的情况下使用核心框架。


📋 要求和兼容性

在安装 UIcore 之前,请确保您的服务器满足以下要求。

组件 要求
Minecraft 1.21.1 或更高版本
服务器软件 Paper 或兼容的服务器实现
Folia 支持,但存在区域限制
PacketEvents 2.14.0(必需)
Java 运行时 所选 Minecraft 和服务器构建所需的版本
UIcore 插件/API 字节码 Java 17
Vault / LuckPerms 可选
PlaceholderAPI / FancyNpcs / SkinsRestorer / CraftEngine 可选

Folia 兼容性

UIcore 声明支持 Folia。

在 Folia 上运行时,属于菜单场景的所有元素必须保持在摄像机的区域内。

在设计定位世界空间界面时,应考虑此限制。

Java 兼容性

UIcore 的插件和公共 API 使用 Java 17 字节码编译。

但这并不意味着每个受支持的 Minecraft 服务器版本都可以在 Java 17 上运行。

始终使用所选 Minecraft 版本和服务器实现所需的 Java 运行时。

有关经过测试的服务器构建和其他兼容性信息,请参阅 兼容性矩阵。


🚀 快速开始

开始使用 UIcore 只需要几个步骤。

第 1 步 — 安装插件

下载 UIcore 及其必需的依赖项 PacketEvents 2.14.0。

将两个插件文件放入服务器的 plugins/ 目录中。

第二步 — 启动服务器

启动或重启 Minecraft 服务器。

UIcore 会生成其配置文件以及三个内置的示例菜单。

第三步 — 打开演示菜单

运行以下命令:

/uicore run demo_main

这将打开主演示菜单。

要关闭当前打开的菜单,请使用:

/uicore stop

第四步 — 创建您自己的菜单

在以下位置添加或修改 YAML 菜单文件:

plugins/UIcore/menu/

使用现有的示例和菜单制作文档作为参考。

第五步 — 重载配置

完成更改后,执行:

/uicore reload

这将加载更新后的菜单配置。

第六步 — 浏览文档

如需更详细的设置和配置指南,请使用以下资源:


🎥 视频演示

查看 UIcore 界面的实际效果。

内置菜单教程

探索随 UIcore 提供的演示菜单。

▶️ 观看内置菜单教程

自定义服务器菜单

查看使用此框架创建的自定义服务器界面示例。

▶️ 观看自定义服务器菜单演示


⚠️ 当前限制与重要说明

UIcore 为 Minecraft 世界空间界面提供了灵活的基础,但部分功能存在技术限制。

结构预览限制

目前的结构预览仅显示方块状态。

它无法还原以下内容:

  • 容器内的物品。
  • 其他方块实体的内容。
  • 实体。
  • 生物群系信息。

在设计建筑预览系统时应考虑这些限制。

控制台命令限制

从菜单中执行控制台命令的功能默认禁用。

若要启用特定的控制台命令,必须配置明确的允许列表。

这可以防止菜单配置自动获得无限制的控制台命令执行权限。

NoChatReports 兼容性

在某些客户端配置下,NoChatReports 可能会干扰 UIcore 菜单使用的已签名聊天行为及文本输入。

请参阅兼容性文档以了解该问题及其记录的解决方法。

Folia 区域限制

当使用 Folia 时,请确保菜单场景的所有元素都位于摄像机的区域内。

服务器版本兼容性

兼容性可能因所选的 Minecraft 版本、服务器实现方式以及已安装的插件而异。

在生产服务器上部署 UIcore 之前,请咨询已发布的 兼容性矩阵。


plugin roadmap


💻 开源与许可

UIcore 是一个开源项目,根据 GNU Affero 通用公共许可证 v3.0 (AGPL-3.0) 发布。

源代码可根据许可证条款进行审查、修改和进一步开发。

源代码: github.com/kekaop/UIcore

许可证: AGPL-3.0

开发者: Orven

致谢与原项目

UIcore 基于 wuhaoxian123 开发的 CustomScreenMenu。

本项目已获得原作者的许可发布。


🌟 UIcore — 融入您世界的界面

UIcore 提供了一种不同的 Minecraft 服务器界面设计方法。

它没有将玩家局限于传统的库存屏幕,而是使开发人员能够使用熟悉的 Minecraft 元素创建交互式、以摄像机为中心的菜单。

通过 YAML 配置、公开的 Java API、动态状态、结构预览以及可选集成,UIcore 可作为各种自定义服务器界面的基础。

构建感觉像是 Minecraft 一部分的菜单,而不仅仅是一个普通的库存窗口。

在 GitHub 上探索 UIcore

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源