SoulKeep
Paper 1.21+ 的持久化坟墓
坟墓、自动寻墓罗盘、熔岩/虚空安全放置 —— 无需数据库,无外部依赖。
概览
SoulKeep 会在玩家死亡时创建一座坟墓,并在拾取时可靠地恢复物品。
它专为持久性(服务器重启 / 区块重载)和安全的物品 retrieval 而设计。
特性
-
死亡地点生成坟墓
在(或靠近)死亡位置放置玩家头颅 + 全息图。
-
寻墓罗盘(重生后)
可选的罗盘,指向坟墓的位置。成功拾取后移除。
-
熔岩/虚空安全放置
坟墓会生成在最近的可用安全方块上(支持按世界单独配置)。
-
拾取规则
可选:允许队友拾取你的坟墓。
-
自动过期
默认:15 分钟(可配置),包含过期后的处理动作(掉落/销毁)。
-
每人限制
默认:最多 3 座坟墓。超出限制时,最旧的坟墓将按配置规则处理。
-
槽位感知恢复
背包/快捷栏/护甲/副手的物品将按优先级恢复,并尽可能放回原始槽位。
防刷机制设计
重要提示: SoulKeep 通过锁定和原子式拾取来减少刷物品漏洞的边缘情况。
- 锁定机制: 同一座坟墓在同一时间只能由一名玩家处理(双击无效)。
- 原子式拾取: 给予物品 → 移除坟墓 → 立即持久化数据。
- 背包已满: 溢出物品将在坟墓处掉落(不会静默丢失,也不会导致刷物品)。
- 数据持久化: 坟墓数据可保存至重启,且在需要时于区块加载时重新生成坟墓。
环境要求
- Paper 1.21+
- 零依赖(无需 Vault、无需 PlaceholderAPI、无需外部数据库)
安装方法
- 将
SoulKeep-<version>.jar 放入 plugins/ 文件夹
- 启动服务器
- 可选:编辑
plugins/SoulKeep/config.yml
- 修改配置后运行
/soulkeep reload(或重启服务器)
指令与权限
| 指令 |
描述 |
权限 |
/soulkeep |
列出你当前的活跃坟墓(含坐标) |
– |
/soulkeep reload |
重载配置文件 |
soulkeep.admin |
/soulkeep clean (/sk clean) |
移除你的坟墓并掉落物品;管理员/控制台可执行全局清理 |
管理员: soulkeep.admin |
| 权限节点 |
默认分配 |
描述 |
soulkeep.admin |
OP |
管理功能(重载/清理/全局操作) |
soulkeep.lavavoidproof |
所有人 |
启用熔岩/虚空安全放置(若需权限限制则生效) |
配置节选
# 熔岩/虚空保护
lava-void-proof: true
lava-void-proof-worlds: {} # 例如 world_nether: false -> 仅主世界有效
# 寻墓罗盘
compass-tracking: true
# 数量限制
max-graves: 3
# 过期设置
grave-expire-hours: 0.25 # 小时数 (0 = 永不过期)
expire-action: DROP # DROP (掉落) 或 DESTROY (销毁)
SoulKeep
Persistent graves for Paper 1.21+
Graves, auto grave compass, lava/void-safe placement — no database, no dependencies.
Overview
SoulKeep creates a grave when a player dies and restores items reliably on pickup.
It is designed for persistence (restarts / chunk reloads) and safe item retrieval.
Features
-
Graves at death location
Player head + hologram at (or near) the death spot.
-
Grave Compass (on respawn)
Optional compass that points to the grave. Removed after successful pickup.
-
Lava/Void-safe placement
Graves spawn at the nearest safe block (configurable per world).
-
Pickup rules
Optional: allow teammates to pick up your grave.
-
Auto-expire
Default: 15 minutes (configurable), including expire action (drop/destroy).
-
Per-player limits
Default: max 3 graves. When exceeded, the oldest grave is handled by the configured rule.
-
Slot-aware restoration
Inventory/Hotbar/Armor/Offhand are restored with priority and, when possible, returned to their original slots.
Dupe-resistant design
Important: SoulKeep reduces dupe edge cases via locking and atomic retrieval.
- Locking: a grave can only be processed by one player at a time (double-click ignored).
- Atomic retrieval: give items → remove grave → persist immediately.
- Inventory full: overflow drops at the grave (no silent loss, no dupe).
- Persistence: grave data survives restarts and graves respawn on chunk load when needed.
Requirements
- Paper 1.21+
- Zero dependencies (no Vault, no PlaceholderAPI, no external database)
Installation
- Put
SoulKeep-<version>.jar into plugins/
- Start the server
- Optional: edit
plugins/SoulKeep/config.yml
- Run
/soulkeep reload (or restart) after config changes
Commands & Permissions
| Command |
Description |
Permission |
/soulkeep |
Lists your active graves (with coordinates) |
– |
/soulkeep reload |
Reloads the config |
soulkeep.admin |
/soulkeep clean (/sk clean) |
Removes your graves and drops items; Admin/Console can clean globally |
Admin: soulkeep.admin |
| Permission |
Default |
Description |
soulkeep.admin |
OP |
Administrative functions (reload/clean/global) |
soulkeep.lavavoidproof |
Everyone |
Enables lava/void-safe placement (if permission-gated) |
Configuration (excerpt)
# Lava/Void protection
lava-void-proof: true
lava-void-proof-worlds: {} # e.g. world_nether: false -> Overworld only
# Grave Compass
compass-tracking: true
# Limits
max-graves: 3
# Expiration
grave-expire-hours: 0.25 # hours (0 = never)
expire-action: DROP # DROP or DESTROY
评论 0
登录后参与评分
还没有评论,来抢沙发吧