PlotRand

插件

· 作者 LucasTHCR

从图形用户界面中选择地块的边界样式——每种样式对应一个权限。

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

最新 1.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

Built with Java 21 Available for Paper

Chat with us on Discord Available on Codeberg

PlotRand

/rand 打开一个 GUI,地块所有者可以在其中为自己的 PlotSquared 地块选择边界样式。每种样式都受其各自的权限控制(plotrand.style.<id>),因此等级/捐赠者系统可以按组解锁更多样式,而无需修改插件本身。

尚未在正式服务器上测试——请参阅下方的已知限制。

要求

  • Paper 1.21.x
  • PlotSquared 7.x(硬性依赖项,缺少此插件时本插件拒绝启用)

命令

命令 描述
/rand 打开你所在地块的边界 GUI(必须是你拥有的地块)
/rand set <style> 直接设置样式,无需使用 GUI
/rand remove 移除边界并恢复原始方块
/rand info 显示当前应用的样式
/rand admin reload 重新加载 config.yml
/rand admin set <style> 强制为管理员所站立的地块设置边界,绕过所有权和冷却时间

在 GUI 中,左键点击应用样式,右键点击预览它:圆环会沿着地块边缘出现 preview-seconds(默认为 10 秒),仅对你可见。世界中没有任何变化,因此预览不消耗冷却时间,被锁定的样式也可以进行预览。

权限

  • plotrand.use(默认:true)- 允许打开 /rand
  • plotrand.admin(默认:op)- 管理员子命令
  • plotrand.style.<id> - 对应 config.yml 中的每种样式,默认值请参见 plugin.yml

配置

所有样式、GUI 布局、冷却时间和边界高度偏移量都位于 config.yml 中。通过复制 styles: 下的区块来添加新样式,然后在 plugin.yml 中也声明其权限,以便权限插件能够列出它。

样式会在配置加载时进行验证。如果样式的材料无法作为方块放置、没有用于在 GUI 中显示的物品形式、占据的 GUI 槽位太小无法显示,或者想要占用另一个样式已使用的槽位,则该样式会被跳过,并在控制台中显示原因——这比在构建中途失败要好。

边界放置原理

圆环遵循地块已认领区域的轮廓。对于合并的地块,这是其区域的并集轮廓,而不是包围盒:L 形合并的包围盒会延伸到所有者未拥有的地块中,在那里建造会修改他人的地块。两个合并子地块相接的接缝处会被排除,以便合并后的地块被视为一个整体形状。

方块在放置时不会触发物理更新,因此由数百个方块组成的圆环不会在地块边缘引发沙子掉落、红石或水流流动。

已知限制

  • 边界高度:圆环放置在玩家站立的 Y 级别(加上 border-height-offset),而不是 PlotSquared 定义的地面高度。这在平坦的地块世界中效果良好;在有起伏的地形上,所有者需要站在他们希望圆环出现的位置。
  • 管理员 set 仅针对管理员物理站立的地块——目前还没有通过地块 ID 查找的功能。
  • 恢复原始方块(/rand remove,或切换样式)会重播在首次应用边界时拍摄的快照。之后在这些确切坐标上通过其他方式放置的方块将被覆盖。如果在 Minecraft 更新后存储的方块类型不再存在,整个还原操作将被拒绝,并保留存储的数据,而不是让边界因原始方块已被删除而孤立无援。
  • applyStyle 在主线程上运行,将强制加载地块边缘沿线的未加载区块。仅遍历轮廓(而非地块内部区域),因此开销与边缘长度成正比,但非常大的地块仍可能导致短暂的卡顿。状态文件以异步方式写入。

构建

mvn clean package

需要访问 repo.papermc.io(Paper)、Maven Central(PlotSquared)和 maven.enginehub.org(WorldEdit, SquirrelID)。生成的 jar 包位于 target/ 中;Paper、PlotSquared 和 WorldEdit 均为 provided 范围,不会被打包进 jar 中。

WorldEdit 锁定在 7.3.19 版本:Plot#getRegions() 返回的是 WorldEdit 类型,而从 7.4.0 开始,WorldEdit 提供了 Java 25 类文件,Java 21 构建环境无法读取。代码故意使用 BlockVector3.getX() 而不是较新的 x(),因为后者仅在 WorldEdit 7.3.0 及以上版本中存在,而运行时版本取决于服务器提供的版本。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源