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时,未安装客户端模组的玩家也可以加入服务器。
安装
- 将构建好的 UltraBorder 服务器插件 JAR 文件放入服务器的
plugins目录。 - (可选)在每个客户端上安装匹配的 UltraBorder 客户端模组 JAR、Fabric Loader 和 Fabric API。
- 启动或重启服务器。
默认情况下,客户端模组为可选安装。
客户端模组要求
该要求在 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
UltraBorder
UltraBorder is a server plugin with an optional Fabric client mod. It supports circular or square world borders and freely aligned, two-sided walls.
Features
- One custom border per world:
circleorsquare, with a configurable center and radius. - Any number of named straight or diagonal walls per world.
- Finite or infinite width and finite or full-world height.
- Two-sided collision for movement and teleports.
- Bypass permission:
ultraborder.bypass. - With the client mod: GPU-rendered surfaces using Minecraft's animated vanilla world-border texture and rendering pipeline.
- Rendering up to the client's effective render distance, independent of entity distance and particles.
- Without the client mod: the plugin remains usable and displays particles as a fallback. Square borders still use Minecraft's native world border.
- The client mod can be optional or required by the server administrator.
- Configuration is stored in
plugins/UltraBorder/config.yml. - Command tab completion is included.
Compatibility
- Server: designed for Paper and based only on Bukkit API classes. Spigot should also be compatible, but has not yet been runtime-tested.
- Client mod: requires Fabric Loader and Fabric API versions compatible with the Minecraft version used by the server.
- Players without the client mod may join when
client-mod.requiredis set tofalse.
Installation
- Place the built UltraBorder server-plugin JAR in the server's
pluginsdirectory. - Optionally install the matching UltraBorder client-mod JAR, Fabric Loader, and Fabric API on each client.
- Start or restart the server.
By default, the client mod is optional.
Client Mod Requirement
The requirement can be configured permanently in plugins/UltraBorder/config.yml:
client-mod:
required: false
handshake-timeout-ticks: 100
kick-message: "§cThe UltraBorder client mod is required on this server."
disable-particles-for-modded-players: true
required: false: players with and without the client mod may join.required: true: players without a compatible client mod are disconnected after the handshake timeout.handshake-timeout-ticks: time allowed for the client mod handshake. Twenty ticks equal approximately one second.disable-particles-for-modded-players: disables the fallback particles for players using the client mod.
The setting can also be changed while the server is running:
/ub modrequired <true|false>
This command saves the new value to the configuration file.
Commands
/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
Running /ub pos1 or /ub pos2 without coordinates uses the player's current position. For walls with finite height, the two Y coordinates define the lower and upper edges.
Permissions
ultraborder.admin
ultraborder.bypass
ultraborder.admin: grants access to UltraBorder administration commands. It is assigned to server operators by default.ultraborder.bypass: allows a player to cross all configured borders and walls.
Rendering
The unmodified Minecraft client can natively display only one axis-aligned square world border. Circular borders, diagonal walls, and multiple independent walls cannot be transmitted as native world borders through the vanilla protocol.
The optional Fabric client mod therefore builds circles and walls as world geometry. It uses Minecraft's built-in forcefield texture and world-border rendering pipeline. No particles or entities are used for the modded rendering, so entity distance does not affect its visibility.
Players without the mod receive the server-side particle fallback for circular borders and walls. Collision remains enforced by the server in both cases.
Building
Build and test the server plugin:
mvn test package
Build the Fabric client mod on Windows:
cd client-mod
gradlew.bat build
On Linux or macOS:
cd client-mod
./gradlew build
The build output contains a server-plugin JAR and a client-mod JAR. Their exact names and locations may vary between versions and build configurations.
Example
Create a circular border centered at 0, 0 with a radius of 1,000 blocks:
/ub border create circle 1000 0 0
Create an infinitely wide and infinitely high wall using the player's current positions:
/ub pos1
/ub pos2
/ub wall create middle true true
下载 Ultraborder
下载 Ultraborder
下载 Ultraborder
下载 Ultraborder
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Ultraborder
下载 Ultraborder
下载 Ultraborder
下载 Ultraborder
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Ultraborder
下载 Ultraborder
- 将 Fabric 客户端版本与 UltraBorder 1.2.8 服务器的 portal-protection 发布版本同步。
- 无需进行任何客户端渲染或网络协议的更改。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
使床在所有维度中爆炸的模组
插件
为 Armor Poser 模组添加兼容性
插件
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
评论 0
登录后参与评分
还没有评论,来抢沙发吧