BanChest

插件

· 作者 kaiiak

将被封禁玩家的物品栏重新分配至散布于主世界中的、带有标签和萤石标记的箱子中。

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

最新 1.0.1 · 26.2 · Paper / Purpur

一键开服(送7天)

BanChest

将封禁变成一场寻宝游戏。

当永久封禁一名玩家时,他们的物品栏和末影箱不应消失于虚空——尤其是在世界尺寸有限的服务器上。BanChest 会收集他们携带的所有物品,并将它们分散放置在世界主维度中标有标签的箱子中,供其他玩家发现。


功能

  • 一条命令 — /banchest <player> 处理所有操作
  • 支持在线和离线玩家(对离线玩家直接读取 .dat 文件)
  • 重新分配物品栏 + 末影箱,包括盔甲、副手和快捷栏
  • 在每个箱子下方放置萤石基座,使其在世界中显眼突出
  • 为每个箱子附加签名标签,标明归属者及其战利品
  • 潜影盒感知 — 可选择将装满物品的潜影盒拆开,放入各自独立的箱子中 防止一次幸运发现就让人拿走一整盒钻石
  • 可配置的世界边界形状 — 圆形或方形
  • 当玩家战利品超过 27 格时,支持多个箱子,并提供可配置的放置方式(散布在全图或彼此靠近聚集)
  • 兼容 LuckPerms 权限节点
  • 支持游戏中重载命令 — 配置文件更改后无需重启服务器
  • 记录每个箱子的精确坐标到控制台,让你随时知道战利品落在哪里

依赖

  • Paper 1.21.1(或与 Paper 1.21.1 兼容的分支)
  • Java 21

安装

  1. 将 banchest-(version).jar 放入服务器的 plugins/ 文件夹
  2. 重启服务器 — 将生成 plugins/BanChest/config.yml
  3. 编辑配置文件以匹配你的世界边界,然后运行 /banchest reload

命令与权限

命令 描述 权限 默认值
/banchest <player> 将玩家的物品重新分配到主维度箱子中 banchest.use 仅限 OP
/banchest reload 无需重启即可重载 config.yml banchest.use 仅限 OP

LuckPerms 示例

/lp group admin permission set banchest.use true

配置

# 世界边界的半径(以方块为单位)。
# 对于 'circle':圆的半径。
# 对于 'square':半边长(箱子落在两个轴上的 [-radius, +radius] 范围内)。
world-radius: 3000

# 世界边界的形状:'circle' 或 'square'。
world-shape: circle

# 当此项为 true 时,玩家物品栏中的每个装满物品的潜影盒都会被打开,
# 其内容会在各自的随机位置生成为一组独立的箱子。
# 空的潜影盒外壳则保留在常规战利品池中。
# 防止一次宝箱发现就让人拿走一整盒稀有资源。
treat-shulkers-independently: true

# 当玩家的总战利品超过 27 格时,每个溢出箱子是否应放置在完全不同的随机位置?
#   true  – 每个箱子都落在世界不同的地方(最大分散)。
#   false – 溢出箱子彼此靠近聚集。
separate-locations-per-chest: true

工作原理

逐步说明

  1. 你运行 /banchest <playername>(通常是在通过你偏好的方法封禁他们之后)

  2. BanChest 读取玩家的完整物品栏(快捷栏、主槽位、盔甲、副手) 以及末影箱

  3. 如果启用了 treat-shulkers-independently,每个装满物品的潜影盒都会被提取 — 其内容成为自己独立的箱子组,位于单独的位置,而 空的潜影盒外壳则留在常规战利品中

  4. 总物品池被分成每组 27 格(每组一个箱子)

  5. 对于每组,在你的配置的世界边界内选择一个随机地表位置,避开水域、岩浆、悬浮位置和受阻区域

  6. 在地面上放置一个萤石块,在其上方放置一个箱子,并 附着一个橡木墙式告示牌,上面写着:

    Banchest of
    PlayerName
    feel free to take
    
  7. 玩家的物品栏和末影箱中的数据被清除 — 物品现在仅存在于世界中

  8. 每个箱子的精确坐标会打印到服务器控制台

安全性

  • 如果在 60 次尝试后仍无法找到箱子位置,会记录警告并跳过该箱子组(在人口密集的地图中极罕见)
  • 只有在箱子成功放置后才会清除玩家数据 — 如果出现问题,玩家数据保持不变,并在控制台中记录错误
  • 该命令不会封禁玩家 — 封禁处理完全独立

常见问题

这对当前离线的玩家有效吗?
是的。BanChest 直接读取玩家的 .dat 文件,因此它对任何曾经登录过服务器的玩家都有效,无论其当前是否在线。

如果玩家拥有超过 27 件物品怎么办?
会生成多个箱子。在 separate-locations-per-chest: true(默认)的情况下,每个箱子都会落在世界中完全不同的随机位置。

潜影盒会发生什么?
在 treat-shulkers-independently: true(默认)的情况下,每个装满物品的潜影盒的内容会被提取,并在世界其他地方生成为其自己的箱子。空的潜影盒外壳保留在主战利品箱中。如果禁用此选项,潜影盒会以原样放入箱子中,不打开。

我能看到箱子放在哪里吗?
可以 — 每次放置箱子都会在服务器控制台中记录,包含精确的 X/Y/Z 坐标和世界名称。

运行该命令也会封禁玩家吗?
不会。BanChest 仅处理物品重新分配。请使用你现有的封禁工作流程(/ban、LiteBans、AdvancedBan 等)来单独处理实际的封禁。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源