LsEnderChest

插件

· 作者 lopikss

⭐ 50多个服务器信赖使用 • 高级末影箱存储,支持1–6行,具备恢复功能、溢出保护、管理工具、反重复物品安全机制及MySQL/SQLite数据库支持。

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

最新 2.0.1 · 26.3 · Paper / Purpur

一键开服(送7天)

LsEnderChest

✨ 一款专为 Paper 26.3 打造的现代、轻量且注重安全性的末影箱插件。

LsEnderChest 使用基于权限的虚拟存储替代原版末影箱,可为每位玩家提供 1–6 行的存储空间,底层支持 SQLite 或 MySQL。

版本 2.0.0 是一次重大重写,引入了实时共享储物箱会话、自动溢出保护、GUI 恢复历史、按玩家审计日志以及内置的原版末影箱转换器。


功能

  • ?️ 高级反刷物品保护
  • ?️ GUI 末影箱恢复
  • ? 1–6 行末影箱
  • ? 自动溢出保护
  • ? 强大的管理工具
  • ? 内置原版转换功能
  • ? 详细的按玩家审计日志
  • ? 高级物品拦截
  • ? 支持 SQLite 与 MySQL
  • ⚡ 异步存储
  • ? 在线与离线 UUID 支持
  • ? 管理员更新通知

LsEnderChest Preview


2.0.0 新增内容

实时共享末影箱会话

LsEnderChest 现在为每个储物箱拥有者保持一个实时库存会话。如果拥有者已经打开了他们的储物箱,而管理员运行:

/ec <player>

双方用户将看到并编辑同一个实时库存。当拥有者在使用时,管理员不再被阻止访问,同时也避免了产生分离的陈旧可写副本。

只读模式的工作人员仍然可以查看其他玩家的储物箱,但无法对其进行修改。


自动溢出储物箱

失去等级或行数权限后,超出新储物箱容量的物品也不会再消失。

示例:玩家从 4 行降级到 1 行。

  • 槽位 1–8 保持原位不变
  • 第 9 个槽位变为溢出储物箱
  • 从第 9 号槽位开始的所有物品都会被安全地移入其中

该规则同样适用于所有降级情况:新储物箱大小的最后一个槽位将成为溢出储物箱。

溢出储物箱是带有受保护的 LsEnderChest 元数据的普通 CHEST 物品。它们不可放置或用作可重复使用的存储;其实际内容保留在服务器端。令牌经过签名处理,绑定到其拥有者,并由唯一的存储 ID 支持,而不是依赖lore(描述文本)或可见元数据。

右键点击溢出储物箱会消耗它,并在玩家所在位置掉落所有存储的物品。 它无法被打开或填充,因此永远不会成为便携式的额外存储空间,其描述文本也会明确警告声称它是单次操作。

如果在后续的降级中捕获到未声明的溢出储物箱,其内容将被扁平化合并到新的溢出储物箱中,而不是嵌套存放。

权限变更会自动监控,并且下次打开时,离线玩家的存储状态也会被检查。


GUI 恢复系统

管理员可以通过以下命令打开玩家的恢复历史记录:

/ec restore <player>

GUI 显示了带时间戳的恢复点,工作人员可以在其中:

  1. 浏览之前的会话
  2. 预览确切的历史储物箱内容
  3. 选择恢复点
  4. 在第二个 GUI 中进行确认

一次正常的玩家会话变成一个恢复会话:

打开储物箱 → 进行任意次数的更改 → 关闭最后一个查看器 → 生成一个恢复点

单个物品的移动仍会单独记录以便审计。

在进行任何恢复之前,LsEnderChest 会创建一个恢复前备份,使得意外的恢复可以从同一 GUI 中撤销。

历史溢出储物箱也包含在内。当恢复旧的快照时,其溢出数据会在新的受保护 ID 下重新创建,而不是重用陈旧的令牌。

恢复功能仅对管理员开放。旧的库存状态可能会重现之前已移除的物品,因此此权限应仅授予可信的工作人员。


按玩家审计日志

旧的全球性 simple.log 和 detailed.log 系统已被替换为每个末影箱拥有者对应一个日志文件:

plugins/LsEnderChest/logs/players/<uuid>.log

日志记录了诸如以下信息:

  • 储物箱的打开和关闭
  • 确切的物品添加/移除
  • 每次更改的责任人
  • 管理员的打开和编辑
  • 拦截物品的尝试
  • 只读编辑尝试
  • 溢出创建与一次性声明
  • 行数降级
  • 原版转换活动
  • 恢复操作
  • 机器可读的恢复快照

旧的 simple.log / detailed.log 文件归档至 logs/legacy/ 目录下而非删除,从而在升级期间保留现有的审计历史。


内置原版末影箱转换器

独立的 LsEnderChestConverter 不再需要。安全的原版迁移现在直接内置于 2.0.0 中:

  • 加入时可选的自动一次性转换
  • /ec convert <player> 用于转换单个在线玩家
  • /ec convert all 用于转换所有在线玩家
  • 仅在自定义存储成功保存后才清除原版储物箱内容
  • 在清除前再次验证原版储物箱
  • 如果迁移过程中内容发生变化,转换将回滚
  • 绝不会盲目覆盖现有的不同 LsEnderChest 内容
  • 可以检测并安全清理来自旧转换器的精确重复数据

为了安全起见,/ec convert all 不会立即启动。它会显示警告并要求:

/ec confirm

在配置的确认超时内执行。在此之前,不会进行任何转换。

如果旧转换器仍然安装,LsEnderChest 将禁用它并警告你移除旧的 JAR 文件。


命令

命令 描述
/ec 打开你的末影箱
/ec <player> 打开其他玩家的末影箱
/ec restore <player> 打开管理员恢复历史 GUI
/ec convert <player> 安全迁移单个在线玩家的原版末影箱
/ec convert all 为所有在线玩家准备批量转换
/ec confirm 确认待处理的危险批量操作
/ec reload 重载可重载的配置

/lsec 和 /enderchest 支持完全相同的子命令。

EssentialsX

/ec 和 /enderchest 被注册为完整的 Paper 根命令,而非别名。LsEnderChest 在 EssentialsX 之后加载,并有意接管裸 /ec 和 /enderchest 标签。如果需要,EssentialsX 的命名空间命令仍然可用。


权限

权限 描述 默认值
enderchest.use 打开自己的 LsEnderChest true
enderchest.admin 编辑其他玩家的箱子,使用恢复和重载 op
enderchest.view.other 只读查看其他玩家的箱子 false
enderchest.convert 使用内置的原版转换器 op
enderchest.bypass 改用原版末影箱 false
enderchest.blocked.bypass 绕过物品限制 op
enderchest.rows.1 提供 1 行 false
enderchest.rows.2 提供 2 行 false
enderchest.rows.3 提供 3 行 false
enderchest.rows.4 提供 4 行 false
enderchest.rows.5 提供 5 行 false
enderchest.rows.6 提供 6 行 false

系统会使用玩家拥有的最高行数权限。如果没有任何相关权限,则使用 settings.default-rows。


存储与安全

LsEnderChest 支持 SQLite 和 MySQL。

2.0.0 版本的存储/会话重写包括:

  • 每个所有者共享一个实时箱子状态
  • 专用工作线程上的有序数据库操作
  • 针对临时故障的保存重试机制
  • 具有更强同步持久性的 SQLite WAL(预写式日志)
  • 恢复写入前的备份行为
  • 带有服务端后备数据的签名一次性溢出箱子令牌
  • 安全的溢出扁平化处理,而非嵌套
  • 保存 → 验证 → 清除原版转换流程
  • 转换验证失败时回滚
  • 在箱子持久化之前进行最终的禁止物品清理

没有任何库存插件能保证抵御所有可能的服务器崩溃、文件系统故障、数据库故障或恶意第三方插件,但 2.0.0 旨在避免常见的陈旧副本、调整大小以及迁移过程中的数据重复/丢失路径。


物品屏蔽

blocked-items.yml 可以通过材质和支持的物品元数据/组件来限制物品。限制会在库存交互期间检查,并在最后一位观察者关闭箱子前再次检查。


兼容性

  • Paper 26.3
  • Java 25
  • 兼容 Paper 的分叉版本可能可以使用,但 Paper 是主要支持的平台

安装 / 升级

  1. 停止服务器
  2. 在主版本升级前,备份服务器和 plugins/LsEnderChest 文件夹
  3. 如果存在旧的独立 LsEnderChestConverter.jar,请将其移除
  4. 将 LsEnderChest-2.0.0.jar 放入 plugins 文件夹
  5. 启动服务器
  6. 检查生成的 config.yml 和 blocked-items.yml

现有的 LsEnderChest 库存数据仍受支持。旧版审计日志会被归档而不是删除。


如果你喜欢这个插件,欢迎捐赠 :D

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源