VoidRP UI

插件

· 作者 mironoouv

在原版客户端上实现真实界面:面板、图标、实时光标、可滚动列表和文本输入——无需模组,无需安装客户端。页面由 Kotlin 代码构成,布局方式类似网页。

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

最新 0.4.0 · 26.2 · Paper

一键开服(送7天)

在原版 Minecraft 客户端上实现真实界面。无需模组、无需 Forge,玩家无需安装任何东西:他们使用已有的客户端加入服务器,接受资源包后,即可看到带有圆角、透明效果、Inter 字体、物品图标以及跟随鼠标的游标的窗口。

一个适用于 Paper 26.2 及以上版本客户端的插件。开源,采用 MIT 许可证。

The home page on a vanilla client

原版客户端上的主页:玩家自己的皮肤、游戏自带的物品纹理,以及停留在其悬停方块上的光标。

这不是模拟图,也不是渲染图。这是一张真实客户端的截图。上面的每一个矩形、字母和图标都作为一行位于不可见 Boss 栏内的文本传输。

The cursor moving over the page

记录其实际使用情况:玩家转动头部,光标随之移动,其所覆盖的内容会亮起。

为什么

在 Minecraft 中,服务器的界面基本上就是一个装有物品的箱子。任何更丰富的功能都需要客户端模组,而很少有玩家会安装模组。像 LocoUI 这样的付费工具可以在原版客户端上绘制界面,但它们的页面是在可视化编辑器中构建并烘焙到资源包中的:当资源包构建完成后,其中不存在的数据无法显示。

在这里,页面是代码,页面上的所有内容都是在显示时从服务器即时发送的。无需重新构建资源包来添加按钮。

页面可以包含什么

  • 布局:行、列和网格,根据玩家屏幕比例(从 5:4 到 21:9)自动排列
  • 样式:背景、16 级透明度、圆角、边框、柔和阴影和发光效果
  • 文本:Inter 字体,七种大小和三种字重,支持换行、对齐和彩色片段
  • 组件:按钮、标签页、复选框、开关、步进器、滑块、下拉菜单、进度条、芯片、瓦片、通知、对话框
  • 内容:滚动列表、工具提示、玩家头像、您自己的 PNG 图片,以及 788 个原版物品和方块图标
  • 输入:由玩家视线驱动的光标,支持点击、滚轮、数字键、拖动滑块以及在游戏自带对话框中输入文本
  • 主题:Jar 包内含四种主题,您也可以自定义十几种颜色的主题

Buttons, tick boxes, sliders, progress bars, chips Tabs, switches, tiles, notices, dialogs, dropdowns

四种外观,同一个页面

Midnight Daylight
midnight:接近黑色的紫色调,默认主题 daylight:浅色主题
Ember Grove
ember:温暖的深色 grove:深绿色

相同的页面和相同的代码。整体外观由 theme.yml 中的一打颜色决定。

安装

  1. 将 jar 文件放入 plugins/ 目录并重启服务器。
  2. 仅此而已。插件会构建资源包,并通过内置的小型 Web 服务器(端口 8123)自行提供下载。

端口关闭、共享主机或位于 Velocity/BungeeCord 之后? 请将插件安装在游戏服务器上,而不是代理服务器上。将资源包放置在任何 Web 主机上,设置 pack.url,并将 pack.publish-dir 指向该主机的文件夹:插件会在每次启动时将资源包复制过去,并在日志中检查地址是否提供了正确的资源包。

可选: PacketEvents。启用此插件后,光标的反应速度可提前最多 50 毫秒,旧版客户端的玩家会立即获得正确的资源包,并且在打开页面时会隐藏其他插件的 Boss 栏。

在游戏中尝试:输入 /vui open 查看主页,输入 /vui demo 一次性查看所有组件。

客户端兼容性

客户端 资源包
26.2 及更高版本 voidrp-ui.zip
1.21.6 – 26.1.2 voidrp-ui-legacy.zip

Mojang 在 26.2 版本中重命名了文本着色器,因此插件会构建两个资源包,并为每个玩家分配其客户端能够读取的那个。两者都已在真实客户端上测试过,包括通过 ViaVersion 连接的 1.21.6 版本,并且能呈现相同的页面。

对于开发者

页面是一个 Kotlin 类,它回答一个问题:我现在看起来是什么样?

class ShopPage(private val balance: Int) : Page() {
    override fun view(): View = Panel(
        style = Theme.page,
        width = Size.Fixed(600),
        gap = Theme.SPACE_4,
        children = listOf(
            Text("Shop", Theme.TEXT_H2, Theme.INK, Weight.SEMIBOLD),
            Text("Balance: $balance", Theme.TEXT_BODY, Theme.INK_SOFT),
            button("Buy", id = "buy"),
        ),
    )

    override fun onClick(id: String, button: Button) {
        if (id == "buy") { /* ... */ refresh() }
    }
}

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源