Ultraborder

插件

· 作者 Aleyz

一个 Minecraft 插件,允许你创建自定义的世界边界和墙壁!

0 本站下载 0 关注 更新于 3 个月前

需要前置:Fabric API

最新 1.2.8 · 1.21.11 · Fabric

一键开服(送7天)

UltraBorder

UltraBorder 是一个服务器插件,并附带一个可选的 Fabric 客户端模组。它支持圆形或方形的世界边界,以及自由对齐的双面墙体。

功能

  • 每个世界一个自定义边界:circle(圆形)或 square(方形),可配置中心点和半径。
  • 每个世界任意数量的命名直线或对角线墙体。
  • 宽度可为有限或无限,高度可为有限或覆盖整个世界。
  • 移动和传送时具有双面碰撞检测。
  • 绕过权限:ultraborder.bypass。
  • 使用客户端模组时:利用 Minecraft 的原版动态世界边界纹理和渲染管线进行 GPU 渲染。
  • 渲染距离取决于客户端的有效渲染距离,与实体距离和粒子无关。
  • 未安装客户端模组时:插件仍可正常使用,并以粒子效果作为备用显示方案。方形边界仍使用 Minecraft 原生的世界边界。
  • 客户端模组可由服务器管理员设置为可选或必需。
  • 配置文件存储在 plugins/UltraBorder/config.yml。
  • 包含命令补全功能。

兼容性

  • 服务端:专为 Paper 设计,仅依赖 Bukkit API 类。Spigot 理论上也可兼容,但尚未在运行时进行测试。
  • 客户端模组:需要与服务端所用 Minecraft 版本兼容的 Fabric Loader 和 Fabric API 版本。
  • 当 client-mod.required 设置为 false 时,未安装客户端模组的玩家也可以加入服务器。

安装

  1. 将构建好的 UltraBorder 服务器插件 JAR 文件放入服务器的 plugins 目录。
  2. (可选)在每个客户端上安装匹配的 UltraBorder 客户端模组 JAR、Fabric Loader 和 Fabric API。
  3. 启动或重启服务器。

默认情况下,客户端模组为可选安装。

客户端模组要求

该要求在 plugins/UltraBorder/config.yml 中永久配置:

client-mod:
  required: false
  handshake-timeout-ticks: 100
  kick-message: "§c此服务器要求安装 UltraBorder 客户端模组。"
  disable-particles-for-modded-players: true
  • required: false:安装了和未安装客户端模组的玩家均可加入。
  • required: true:握手超时后,未安装兼容客户端模组的玩家将被断开连接。
  • handshake-timeout-ticks:允许客户端模组握手的时间。20 tick 大约等于一秒。
  • disable-particles-for-modded-players:禁用已安装客户端模组玩家的备用粒子效果。

也可以在服务器运行时更改此设置:

/ub modrequired <true|false>

此命令会将新值保存到配置文件中。

命令

/ub border create <circle|square> <radius> [centerX centerZ]
/ub border center <x> <z>
/ub border radius <radius>
/ub border shape <circle|square>
/ub border info
/ub border delete

/ub pos1 [x y z]
/ub pos2 [x y z]
/ub wall create <name> [infiniteWidth] [infiniteHeight]
/ub wall center <name> <x> <z>
/ub wall infinitewidth <name> <true|false>
/ub wall infiniteheight <name> <true|false>
/ub wall info <name>
/ub wall list
/ub wall delete <name>

/ub modrequired <true|false>
/ub reload

不带坐标运行 /ub pos1 或 /ub pos2 将使用玩家当前位置。对于高度有限的墙体,两个 Y 坐标分别定义下边缘和上边缘。

权限

ultraborder.admin
ultraborder.bypass
  • ultraborder.admin:授予访问 UltraBorder 管理命令的权限。默认分配给服务器操作员。
  • ultraborder.bypass:允许玩家穿越所有配置的边界和墙体。

渲染机制

未经修改的 Minecraft 客户端原生只能显示一个轴对齐的方形世界边界。圆形边界、对角线墙体以及多个独立墙体无法通过原版协议作为原生世界边界传输。

因此,可选的 Fabric 客户端模组将圆形和墙体构建为世界几何体。它使用 Minecraft 内置的 forcefield 纹理和世界边界渲染管线。模组渲染不使用任何粒子或实体,因此实体距离不会影响其可见性。

未安装模组的玩家会收到服务器端的粒子备用效果(用于圆形边界和墙体)。在这两种情况下,碰撞均由服务器强制执行。

构建

构建并测试服务器插件:

mvn test package

在 Windows 上构建 Fabric 客户端模组:

cd client-mod
gradlew.bat build

在 Linux 或 macOS 上:

cd client-mod
./gradlew build

构建输出包含一个服务器插件 JAR 和一个客户端模组 JAR。它们的确切名称和位置可能因版本和构建配置而异。

示例

创建一个以 0, 0 为中心、半径为 1,000 格圆形的边界:

/ub border create circle 1000 0 0

使用玩家当前位置创建一个宽度和高度均无限的墙体:

/ub pos1
/ub pos2
/ub wall create middle true true

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源