SafeChest

插件

· 作者 SicklySurgeon

再也不用丢失物品了!SafeChest 会在你死亡时自动将你的背包物品保存到一个受保护的箱子中。通过简单的命令传送或取回即可。

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

最新 0.0.6.1 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? SafeChest v0.0.5 — 终极玩家安全与服务器管理系统

厌倦了死亡后失去一切? SafeChest 会在你死亡时,自动将你的全部物品栏、护甲和副手物品保存到你死亡地点的箱子中。轻松取回——再也不必因为掉进岩浆而愤怒退游!

v0.0.5 是一次革命性的更新。 我们添加了专业的管理工具、音效、动态全息投影、PlaceholderAPI 集成、分页功能、实时 GUI 更新,并修复了关键的性能漏洞。这不仅仅是一个死亡箱子插件——它是为你的玩家和管理员提供的终极安全网和服务器管理套件。


✨ 主要特性 — v0.0.5 版本

?️ 自动保护与反破坏
只有你(或管理员)可以打开或破坏你的箱子。可配置以防止实体/方块爆炸造成的损坏。现在,破坏你自己的箱子会立即恢复你的物品栏——再也不用担心误点了!

⏳ 实时多行动画全息计时器
浮动显示展示你的名字、物品数量和实时倒计时。支持服务器重启后保留。
✨ 新增: 当时间即将耗尽时,全息投影会以红/黄色闪烁(阈值和颜色均可配置)。
✨ 新增: 可选择仅让 {time} 占位符闪烁,以实现更微妙、优雅的通知效果。

? /sctp — 传送至箱子(支持索引)
一键回到你死亡的地点。使用 /sctp 2 可从列表中传送到特定的箱子。如果未找到安全位置,可配置“强制传送”。
? 新增: 传送时播放可配置的音效。

? /scfetch — 将箱子带到身边
完美适用于在虚空、岩浆或洞穴中死亡的情况。箱子(及其全息投影)会跟随你移动。
? 新增: 抓取箱子时播放可配置的音效。

?️ /scpreview — 实时预览内容(自动刷新与关闭按钮)
无需移动即可查看箱子内容——安全且只读。GUI 完全可自定义。
✨ 新增: GUI 每 5 秒从数据库自动刷新一次。如果你在查看过程中箱子过期,GUI 会自动关闭。
✨ 新增: 在第 44 格槽位添加了专用的 BARRIER 关闭按钮,用于显式关闭界面。

? /sclist — 所有活跃箱子列表(带分页功能!)
点击式列出你所有的箱子。可即时传送到任意一个。按时间排序、按世界过滤、显示 UUID。
✨ 新增: 结果现已分页显示(每页 5 个),并带有可点击的 [Previous](上一页)和 [Next](下一页)按钮。使用 /sclist 3 可直接跳转到第 3 页。

? Vault 经济支持(含日志记录)
对玩家使用 /sctp 或 /scfetch 收费——可按组配置。支付时在动作栏提供反馈。
? 新增: 所有支付和箱子交互操作现在都会记录到服务器控制台,以便审计和调试。

? 基于组的配置(支持自定义箱子材质!)
为 default(默认)、vip、admin 定义自定义规则——不同的持续时间、限制、价格,甚至箱子材质(例如:VIP 获得木桶,管理员获得潜影盒)。

? 玩家会被分配到他们拥有权限的第一个组。

? 交互式死亡消息(含动态费用与时间)
死亡后,你会收到可点击的按钮:[TP]、[FETCH]、[PREVIEW]。每个按钮都可单独配置。
✨ 新增: 按钮的悬停文本现在显示动态占位符,如 {cost} 和 {time}。示例:"Cost: 50 coins. Expires in: 2m 30s."(费用:50 金币。剩余时间:2 分 30 秒。)

? 持久化与自动恢复
支持 SQLite 或 MySQL 存储。服务器启动时会恢复箱子和全息投影。
⚠️ 重要提示: 表名已从 angelchests 更改为 safechests —— 升级时需进行手动迁移。

⚙️ 高度可配置
控制一切:粒子类型、动作栏消息、GUI 标题、按钮可见性、世界限制、爆炸保护、音效、全息动画等更多设置——所有设置均可在 config.yml 中编辑。

? /safechestreload
无需重启服务器即可重新加载配置——对于在线管理员至关重要。比 /reload 更安全。

? 视觉与音频反馈
❤️ 创建箱子时可配置的粒子效果。✨ 取回箱子时可配置的粒子效果。可选的动作栏消息。
? 新增: 在创建、恢复、传送和过期时播放可配置的音效。

? 多世界支持
可在特定世界中启用或禁用该插件。过滤 /sclist 以仅显示当前世界的箱子。
✨ 改进: 配置现在使用 behavior.disabled-worlds(黑名单)以实现更清晰的逻辑。

? PlaceholderAPI 集成
✨ 全新功能: 在任何支持 PlaceholderAPI 的插件(记分板、聊天、菜单等)中使用占位符,如 %safechest_time_left%、%safechest_item_count%、%safechest_location%。

?️ 管理员命令套件 (/safechestadmin)
✨ 全新功能: 为服务器工作人员提供的强大工具箱:

  • inspect <player>:列出某玩家的所有活跃箱子(点击可传送)。
  • delete <uuid>:通过 UUID 删除特定箱子。
  • purge:手动清除数据库中所有已过期的箱子。
  • stats:显示全服统计信息(总活跃/过期箱子数、拥有箱子的玩家数等)。

⚠️ 关键漏洞修复:

  • ? 已修复:箱子交互/破坏时的死锁问题 —— 点击或破坏箱子时不再导致服务器冻结。操作现在完全异步执行。
  • ? 已修复:重启后全息计时器不工作 —— 服务器重启后,全息投影现在能正确启动倒计时计时器。
  • ? 已修复:经济错误未记录日志 —— 支付失败现在会记录到服务器控制台,便于轻松调试。

? Wiki:如何使用 SafeChest v0.0.5

? 1. 基本用法(适用于玩家)

? 当你死亡时

  • 你的死亡地点会自动生成一个箱子。
  • 你所有的物品(背包、盔甲、副手)都会被存储在其中。
  • 你会收到一条可配置的聊天消息,其中包含可点击的按钮:
    • [TP] → /sctp — 传送至箱子。悬停显示费用和剩余时间。
    • [FETCH] → /scfetch — 将箱子搬运到你身边。悬停显示费用和剩余时间。
    • [PREVIEW] → /scpreview — 在不移动的情况下查看箱子内容。悬停显示剩余时间。

? 取回你的物品

  • 走到箱子旁并右键点击它以恢复你的物品栏。
  • 或者使用 /sctp 传送至箱子。
  • 或者使用 /scfetch 将其搬运到你身边。

? 预览你的箱子(无需移动)

/scpreview
  • 打开一个虚拟物品栏,显示所有已存储的物品。
  • 完全安全——你无法取出或修改任何物品。
  • GUI 每 5 秒实时更新。如果箱子过期,GUI 会自动关闭。
  • 点击底行的**红色 BARRIER(障碍)**手动关闭它。

? 列出你所有活跃的箱子(分页!)

/sclist
  • 以每页 5 个的方式显示你所有活跃的箱子。
  • 可配置:按当前世界过滤、按过期时间排序、悬停显示 UUID。
  • 点击任意条目可直接传送至该箱子(如果你有权限)。
  • 使用 /sclist 2 跳转到第 2 页。

⚙️ 2. 配置(面向服务器管理员)

? 可自定义的文件

  • config.yml — 主要设置:存储、箱子材质、全息文本、粒子类型、死亡消息按钮、GUI 选项、世界限制、爆炸保护、声音、全息动画、日志记录以及更多内容。
  • groups.yml — 定义玩家组(例如 default、vip、admin),包括自定义持续时间、箱子上限、命令价格、以及箱子材质。
  • lang.yml — 翻译或自定义插件中的每条消息,包括用于分页、管理员命令和日志记录的新消息。

? 示例:创建 VIP 组

在 groups.yml 中:

vip:
  safechest-duration: 600      # 10 分钟
  max-allowed-safechests: 10   # 最多可同时拥有 10 个活跃箱子
  price-teleport: 50.0         # 传送费用为 50 金币
  price-fetch: 100.0           # 搬运费用为 100 金币
  material: "BARREL"           # ✅ 新增:VIP 玩家获得木桶而非普通箱子!

然后,给予玩家以下权限:
safechest.group.vip

? 玩家会被分配到他们拥有的第一个权限对应的组。

?️ 自定义全息图与死亡消息

在 config.yml 中:

angelchest:
  hologram-text: "&a&l[SafeChest]&r\n&b{player}\n&7{items} items / {time}"

# ✅ 新增部分:全息动画
hologram-animation:
  enabled: true
  threshold-seconds: 10 # 当剩余时间少于或等于 10 秒时开始闪烁
  color-on: "RED"
  color-off: "YELLOW"
  blink-only-time-placeholder: true # 仅对 {time} 部分进行闪烁

death-message:
  enabled: true
  show-buttons: true
  show-button-tp: true
  show-button-fetch: false # 全局禁用搬运按钮
  show-button-preview: true

占位符(适用于 hologram-text、lang.yml 和死亡消息悬停提示):

  • {player} — 玩家名称。
  • {items} — 箱子内物品总数。
  • {time} — 距离过期的剩余时间。
  • {cost} — 操作的费用(用于死亡消息悬停提示)。

✅ 现在完全支持多行全息图,并在服务器重启后恢复显示。

? 自定义玩家体验

在 config.yml 中:

messages:
  use-action-bar: true # 在行动栏显示“箱子已创建!”而非聊天窗口
  use-particles: true
  particle-on-create: "HEART"
  particle-on-restore: "END_ROD"

# ✅ 新增部分:声音
sounds:
  enabled: true
  on-create: "ENTITY_PLAYER_LEVELUP"
  on-restore: "ENTITY_ENDERMAN_TELEPORT"
  on-teleport: "ENTITY_ENDERMAN_TELEPORT"
  on-expire: "ENTITY_ITEM_BREAK"

commands:
  preview-gui:
    title: "&6My Items - SafeChest" # 更改 GUI 标题
    info-item-material: "BOOK" # 更改信息物品
    force-close-only-with-esc: true # 仅允许通过 ESC 键关闭预览

  aclist:
    show-only-current-world: true # 仅显示玩家当前世界中的箱子
    sort-by-expiration: true # 优先显示即将过期的箱子
    show-uuid-in-hover: false # 隐藏 UUID(若为 true 则有助于调试)

?️ 高级行为控制

在 config.yml 中:

behavior:
  # ✅ 重命名:从 'enabled-worlds' 改为 'disabled-worlds'
  disabled-worlds: ["world_the_end"] # 在末地禁用插件
  protect-from-entity-explosions: true # 防止苦力怕等实体爆炸破坏
  protect-from-block-explosions: false # 允许 TNT 破坏箱子
  force-clear-drops-on-death: true # 修复双重掉落 bug

? 3. 经济系统设置

SafeChest 集成了 Vault。请确保你已安装兼容的经济插件(例如 EssentialsX、CMI)。

? 为命令收费

在 groups.yml 或 config.yml 中设置价格:

price-teleport: 50.0
price-fetch: 100.0

玩家在使用的 /sctp 或 /scfetch 时将自动扣费。

✅ 如果未安装 Vault,这些功能将被静默禁用——不会报错。(softdepend: [Vault])。


? 4. 重载配置

作为管理员,你可以无需重启服务器就重载所有配置:

/safechestreload

所需权限: safechest.reload

此命令会:

  • 重载 config.yml、groups.yml 和 lang.yml。
  • 清除缓存中已过期的箱子。
  • 重新初始化插件容器。
  • 不会破坏活跃的箱子或全息图。

? 警告: 避免在服务器高负载活动期间使用 /reload。/safechestreload 要安全得多。


?️ 5. 权限(已重命名!)

权限 描述 默认值
safechest.use 允许使用死亡箱子系统 true
safechest.protect 允许保护你的箱子不被他人打开 true
safechest.protect.ignore 允许打开其他玩家保护的 SafeChests op
safechest.tp 允许使用 /sctp 命令 true
safechest.fetch 允许使用 /scfetch 命令 true
safechest.group.<name> 将玩家分配到组(例如 safechest.group.vip) —
safechest.reload 允许使用 /safechestreload 命令 op
safechest.admin ✅ 新增: 允许使用 /safechestadmin 命令 op

✅ 使用 LuckPerms、PermissionsEx 或其他任何权限管理器来分配这些权限。


❓ 6. 常见问题与故障排除 — v0.0.5

问:为什么我的物品没有被保存?
答:请确保你拥有 safechest.use 权限。此外,检查世界是否未列入 config.yml 中的 behavior.disabled-worlds 列表。

问:重启后全息显示消失了!
答:已在 v0.0.3 中修复,并在 v0.0.5 中完善! 现在服务器启动时会自动恢复全息显示并重置其计时器。如果仍然缺失,请检查服务器日志中的错误信息。

问:我收到“正在初始化...请稍后再试”的提示。
答:数据库仍在加载中。等待几秒钟后重试。

问:我能把箱子改成木桶或潜影盒吗?
答:可以!在 config.yml 中全局设置:

material: "BARREL"

或在 groups.yml 中按组设置:

vip:
  material: "SHULKER_BOX"

问:如何禁用死亡消息按钮?
答:在 config.yml 中设置 death-message.show-buttons: false,或者禁用单个按钮如 show-button-fetch: false。

问:我的玩家抱怨掉落物重复了怎么办?
答:在 config.yml 中启用 behavior.force-clear-drops-on-death: true 以解决此问题。

问:如何让 /sctp 在没有“安全点”的情况下也能工作?
答:在 config.yml 中设置 commands.teleport-unsafe-behavior: "force"。

问:如何从 v0.0.4 升级?
答:关键步骤: 在启动服务器之前,你必须将数据库表名从 angelchests 重命名为 safechests。同时,将所有权限和命令从 angelchest 更新为 safechest。

问:如何查看服务器统计信息?
答:使用新的管理员命令:/safechestadmin stats。

问:如何删除特定的箱子?
答:使用 /safechestadmin delete <uuid>。你可以通过 /safechestadmin inspect <player> 找到 UUID。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源