** ? UltimateGraves - 完整插件概览
? 描述
UltimateGraves 是一款专为运行在 Paper 上的 Minecraft 1.21.1+ 服务器打造的付费、功能丰富的坟墓管理系统。当玩家死亡时,系统会在其死亡地点生成一个坟墓,安全地存储所有物品栏内容、盔甲和经验值,从而避免物品丢失。
基于现代 Java 21 和最新的 Paper API 构建,UltimateGraves 提供了无与伦比的性能、灵活性和可定制性。无论您运营的是生存服务器、RPG 领域还是硬核 PvP 竞技场,UltimateGraves 都能凭借其智能保护系统、智能位置检测以及广泛的配置选项,完美适应您的需求。
不再因物品丢失而愤怒退服。不再有无意义的岩浆或虚空死亡。只需安心游戏。
? 核心概念
当玩家死亡时:
- ? 智能位置检测 - 寻找安全位置(处理虚空、岩浆、墙壁内等情况)
- ? 物品保全 - 存储所有物品栏、副手及盔甲物品
- ⚰️ 坟墓生成 - 放置视觉标记(玩家头颅、全息投影、粒子效果)
- ? 受保护 - 可配置的保护模式(私有、公共、限时、PvP、令牌制)
- ? 导航 - 玩家获得指向坟墓的指南针
- ⏰ 过期机制 - 可配置的计时器,在此之后坟墓变为公开或过期
- ? 经济系统 - 可选的传送与拾取费用(支持 Vault 集成)
✨ 关键功能摘要
| 类别 | 功能 |
|---|---|
| ?️ 保护 | 5种保护模式、限时访问、PvP 检测、令牌系统、守护生物 |
| ? 视觉效果 | 玩家头颅坟墓、原生全息投影、粒子效果、信标光束、发光效果 |
| ?️ 存储 | SQLite 与 MySQL 支持、异步操作、HikariCP 连接池、NBT 保留 |
| ? 智能逻辑 | 安全位置查找器、虚空/岩浆处理、灵魂绑定物品、溢出管理 |
| ? 经济系统 | Vault 集成、传送费用、拾取费用、物品退款 |
| ? 交互 | 交互式 GUI、快速拾取、智能装备、指南针追踪、多点击操作 |
| ⚙️ 配置 | 580+ 行配置项、每项功能均可独立开关、热重载、按世界设置 |
| ? 集成 | PlaceholderAPI、WorldGuard、Vault、开发者 API、自定义事件 |
? 详细功能分解
?️ 保护系统(策略模式)
5种保护模式:
-
PRIVATE(私有)模式 ?
- 仅坟墓所有者可访问
- 拥有 bypass 权限的管理员可打开
- 适合 PvE 服务器
-
PUBLIC(公共)模式 ?
- 任何人都可以拾取该坟墓
- 先到先得
- 适合硬核/无政府状态服务器
-
TIMED(限时)模式 ⏰
- 私有 X 秒(可配置)
- 计时器结束后变为公共
- 平衡公平性与风险
-
PVP_PVE(玩家对战/环境)模式 ⚔️
- 智能检测:
- 被玩家击杀 → 公共坟墓(PvP 掉落物)
- 被怪物/环境击杀 → 私有坟墓
- 适合阵营/战争服务器
- 智能检测:
-
TOKEN(令牌)模式 ?
- 需要自定义物品(坟墓钥匙)才能打开
- 钥匙可出售、奖励或制作
- 创造独特的经济机会
? 视觉系统(原生 1.21 API)
坟墓方块:
- 玩家头颅,显示所有者皮肤(默认)
- 或可配置的材料(下界合金块、箱子、末影箱等)
- 发光效果,颜色可自定义
- 防爆且抗活塞推动
全息投影(TextDisplay 实体 - 无需额外插件):
⚰ 坟墓 ⚰
所有者: Steve
时间: 14分 32秒
死因: 坠入岩浆
物品数: 47
- 实时倒计时
- 完全可定制的文本行
- MiniMessage 色彩支持(渐变、RGB、十六进制色码)
- 每秒自动更新
粒子效果:
- 上升的灵魂之火(类型可配置)
- 可自定义数量、速度和扩散范围
- 支持 20+ 种粒子类型
- 可调整生成间隔
信标光束:
- 仅对坟墓所有者可见
- 从远处指向坟墓
- 可配置颜色(RGB)
- 可调整可见范围(默认 64 格)
? 智能位置算法
问题: 玩家在岩浆、虚空、墙壁内死亡 → 坟墓无法正常生成
解决方案:
if (在 VOID 中死亡) {
→ 扫描 10 格半径内的实心地面
→ 如果未找到:在 Y=5 处创建玻璃平台
}
if (在 LAVA 中死亡) {
→ 将岩浆替换为下界合金块
→ 清除周围岩浆(半径可配置)
}
if (在 WALL 中死亡) {
→ 射线投射寻找最近的空气区域
→ 在安全位置生成坟墓
}
可配置选项:
- 搜索半径(水平和垂直方向)
- 虚空平台高度
- 岩浆替换方块
- 不安全方块列表
- 平台创建开关
? 独特的“高级”功能
- 坟墓守护系统 ?
- 随机生成几率(默认 15%)
- 僵尸/骷髅装备有玩家的盔甲和武器
- 坟墓在守护生物被击杀前处于锁定状态
- 可自定义:
- 生物类型(僵尸、骷髅、凋零骷髅、猪灵蛮兵)
- 生命倍率(默认 2x)
- 伤害倍率(默认 1.5x)
- 速度加成
- 使用玩家占位符的自定义名称
- 发光效果
示例:
玩家死亡 → 15% 几率生成 "Steve 的幽灵"
守护生物穿着 Steve 的钻石盔甲 + 下界合金剑
Steve 必须击败守护生物才能访问他的坟墓
- 灵魂绑定物品系统 ?
- 通过 lore/NBT 标签标记物品
- 这些物品在死亡时保留在物品栏中
- 可配置标识符:
- "<gold><bold>SOULBOUND</bold></gold>" - "§6§lSOULBOUND" - NBT 标签: "soulbound:true" - 非常适合任务物品、排名奖励等
- 溢出管理 ?
- 拾取坟墓时玩家背包已满?
- 选项:
- LEAVE_IN_GRAVE(留在坟墓中) - 物品保留供下次访问
- DROP_AT_FEET(掉落在脚边) - 物品以实体形式掉落
- PREVENT_LOOT(阻止拾取) - 直到有空位才允许打开
- 智能装备 ?
- 拾取坟墓时自动装备盔甲
- 仅填充空的盔甲槽位
- 优先装备最佳装备
- 可按玩家单独切换
- 经验值保留 ⭐
- 可配置保存的百分比(默认 75%)
- 拥有权限的玩家保留 100%
- 与物品分开存储
- 在坟墓战利品中返还
?️ 数据库与性能
双数据库支持:
- SQLite - 零配置本地存储(默认)
- MySQL - 用于服务器的远程数据库
HikariCP 连接池:
- 行业标准连接管理
- 可配置池大小(默认 10 个连接)
- 自动连接回收
- 针对高玩家数量优化
异步操作:
- 坟墓生成(防止死亡事件卡顿)
- 数据库保存/加载
- 位置计算
- 所有异步操作均使用 CompletableFuture
数据保留:
- Base64 序列化用于物品
- 保留 NBT/组件数据(模组物品、自定义模型数据)
- 保留 附魔 和 描述
- 保存 药水效果 和 属性
缓存系统:
- 活跃坟墓的内存缓存
- 减少 80% 的数据库查询
- 可配置最大缓存大小(默认 500)
- 每 5 分钟自动同步
? 玩家交互
多种交互类型:
| 动作 | 结果 |
|---|---|
| 左键点击 | 在聊天栏显示坟墓信息 |
| 右键点击 | 打开坟墓 GUI |
| Shift + 右键点击 | 快速拾取(即时获取) |
GUI 系统:
1. 坟墓列表 GUI (/graves)
╔════════════════════════════════════╗
║ YOUR GRAVES ║
╠════════════════════════════════════╣
║ [?] Grave 1 ║
║ World: world (100, 64, -200) ║
║ Died: 5 minutes ago ║
║ Cause: Fell from high place ║
║ Items: 32 ║
║ ║
║ Left-Click: Teleport ($100) ║
║ Right-Click: Preview Items ║
╚════════════════════════════════════╝
2. 坟墓战利品 GUI
- 显示确切的坟墓内容
- 获取前预览
- 点击物品单独拾取
- 或点击“全部拿走”按钮
指南针导航 ?
- 重生时给予(可切换开关)
- 指向最近的坟墓
- 当坟墓变化时更新
- 自定义名称 + 带有坐标的描述
- 当坟墓被拾取后自动移除
? 经济集成 (Vault)
可配置费用:
- 传送至坟墓 - 默认 $100
- 打开坟墓 - 默认 $0(禁用)
- 获取物品 - 默认 $0(禁用)
特色功能:
- 退款系统 - 将过期的坟墓物品转换为金钱
- 绕过权限 -
ultimategraves.teleport.free,ultimategraves.nocost - 余额检查 - 如果资金不足则不会收费
- 详细消息 - 显示确切的费用和余额
用例:
- 为便利性收费(传送)
- “勒索”模式(付费取回物品)
- 作为保险退款(退还 50% 物品价值)
- 创建“坟墓钥匙”经济(TOKEN 模式)
? 集成
PlaceholderAPI 扩展:
%ultimategraves_count% - 活跃坟墓的数量
%ultimategraves_latest_coords% - 上一个坟墓的位置
%ultimategraves_latest_world% - 上一个坟墓的世界
%ultimategraves_latest_time% - 距离上次死亡的时间
%ultimategraves_total_items% - 所有坟墓中的物品数量
WorldGuard 集成:
- 自定义区域标志:
graves-spawn - 在受保护区域阻止坟墓生成
- 可配置的后备行为
- 软依赖(可选)
Vault 集成:
- 用于费用的经济 API
- 权限检查
- 余额管理
? 用例与服务端类型
生存服务端 ?
- 问题: 玩家因意外死亡而丢失物品
- 解决方案: 私人坟墓,15 分钟倒计时
- 配置:
PRIVATE或TIMED模式,特殊物品设为灵魂绑定
PvP/阵营服务端 ⚔️
- 问题: 需要可拾取的坟墓用于击杀,但不适用于意外死亡
- 解决方案: PVP_PVE 模式
- 配置: PvP 即时公开坟墓,PvE 死亡受保护
RPG 服务端 ?️
- 问题: 自定义物品需要特殊保护
- 解决方案: 灵魂绑定 + 守护者系统
- 配置: 将任务物品标记为灵魂绑定,50% 概率生成守护者
极限生存服务端 ?
- 问题: 如果物品始终受到保护,难度太低
- 解决方案: 短倒计时 + 守护者怪物
- 配置:
TIMED2 分钟,30% 守护者概率,无传送功能
无政府服务端 ?
- 问题: 没有规则,完全可拾取
- 解决方案: 公开坟墓,短暂过期时间
- 配置:
PUBLIC模式,5 分钟过期,仅虚空保护
SMP 服务端 ?️
- 问题: 休闲玩家和硬核玩家混合
- 解决方案: 基于权限的模式
- 配置: 不同等级采用不同模式,可选传送费用
? 与其他插件的比较
| 功能 | UltimateGraves | Graves (Basic) | AngelsChest | GriefPrevention Graves |
|---|---|---|---|---|
| 现代 API (1.21) | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 否 |
| 原生全息图 | ✅ TextDisplay | ❌ 盔甲架 | ❌ 外部资源 | ❌ 无 |
| 数据库支持 | ✅ SQLite + MySQL | ❌ 基于文件 | ✅ SQLite | ❌ 无 |
| 异步操作 | ✅ 完整支持 | ❌ 部分支持 | ❌ 无 | ❌ 无 |
| 保护模式 | ✅ 5 种模式 | ❌ 2 种模式 | ❌ 1 种模式 | ❌ 1 种模式 |
| 智能定位 | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 否 |
| 守护者系统 | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 否 |
| 灵魂绑定物品 | ✅ 是 | ❌ 否 | ❌ 否 | ❌ 否 |
| 经济集成 | ✅ 完整支持 | ❌ 部分支持 | ❌ 无 | ❌ 无 |
| 开发者 API | ✅ 是 | ❌ 有限 | ❌ 无 | ❌ 无 |
| GUI 系统 | ✅ 高级 | ❌ 基础 | ❌ 无 | ❌ 无 |
| 配置文件 | ✅ 580+ 行 | ❌ 100 行 | ❌ 150 行 | ❌ 50 行 |
? 安装与设置
要求:
- Minecraft 版本: 1.21.1 - 1.21.x
- 服务端软件: Paper (或 Forks: Purpur, Pufferfish)
- Java 版本: Java 21
- 可选依赖项:
- Vault + 经济插件(用于费用)
- PlaceholderAPI(用于占位符)
- WorldGuard 7.0+(用于区域保护)
安装方法:
- 下载
UltimateGraves.jar - 放入
plugins/文件夹 - 重启服务器(不要使用 reload)
- 配置
plugins/UltimateGraves/config.yml - 编辑
plugins/UltimateGraves/messages.yml(可选) - 使用
/graveadmin reload应用更改
首次设置:
config.yml - 推荐的初始设置
存储(单服务器建议使用 SQLite)
storage:
type: "SQLITE"
基础墓穴设置
graves:
max-graves-per-player: 5
expiration-time: 900 # 15分钟
default-protection-mode: "TIMED"
timed-mode-duration: 300 # 5分钟
启用视觉效果
visuals:
block-material: "PLAYER_HEAD"
glowing: true
hologram:
enabled: true
particles:
enabled: true
启用经济系统(需要 Vault)
economy:
enabled: true
teleport-cost: 100.0
启用守护者(15% 生成概率)
guardian:
enabled: true
spawn-chance: 0.15
? 命令参考
玩家命令:
| 命令 | 描述 | 权限 |
|---|---|---|
/graves |
打开墓穴 GUI | ultimategraves.use |
/graves list |
列出你所有的墓穴 | ultimategraves.use |
/graves tp <> |
传送至墓穴 | ultimategraves.teleport |
/graves info <> |
查看墓穴详情 | ultimategraves.use |
/graves help |
显示帮助信息 | ultimategraves.use |
管理员命令:
| 命令 | 描述 | 权限 |
|---|---|---|
/graveadmin reload |
重载配置 | ultimategraves.admin |
/graveadmin cleanup |
移除过期的墓穴 | ultimategraves.admin |
/graveadmin purge |
删除所有墓穴 | ultimategraves.admin |
/graveadmin list [player] |
列出玩家的墓穴 | ultimategraves.admin |
/graveadmin tp <player> <> |
传送到任意墓穴 | ultimategraves.admin |
/graveadmin remove <player> <> |
移除一个墓穴 | ultimategraves.admin |
? 权限参考
基础权限:
ultimategraves.use 基础墓穴使用权限 (默认: true)
ultimategraves.admin 管理员命令 (默认: op)
ultimategraves.bypass 访问任何墓穴 (默认: op)
ultimategraves.unlimited 无墓穴数量限制 (默认: false)
ultimategraves.teleport 传送至墓穴 (默认: true)
ultimategraves.teleport.free 免费传送 (默认: op)
ultimategraves.compass 获得指南针 (默认: true)
ultimategraves.nocost 免除所有费用 (默认: op)
模式权限:
ultimategraves.mode.private 使用 PRIVATE 模式
ultimategraves.mode.public 使用 PUBLIC 模式
ultimategraves.mode.timed 使用 TIMED 模式
ultimategraves.mode.pvppve 使用 PVP_PVE 模式
ultimategraves.mode.token 使用 TOKEN 模式
特殊权限:
ultimategraves.keepxp 保留 100% 经验值
ultimategraves.soulbound.bypass 所有物品均表现为灵魂绑定
⚙️ 配置亮点
580+ 项配置选项,包括:
- ✅ 数据库设置(类型、MySQL 凭据、连接池大小)
- ✅ 墓穴限制(每玩家最大数量、过期时间)
- ✅ 保护模式(5 种类型及子选项)
- ✅ 视觉自定义(方块类型、发光、粒子、全息图)
- ✅ 安全位置算法(虚空/岩浆处理、搜索半径)
- ✅ 物品栏处理(经验百分比、灵魂绑定、溢出处理)
- ✅ 经济成本(传送费、取回费、退款)
- ✅ 守护者系统(生成概率、生物类型、属性)
- ✅ 交互模式(左键/右键/Shift 点击行为)
- ✅ 重生设置(指南针、标题、消息)
- ✅ 清理自动化(过期墓穴、数据库清理)
- ✅ GUI 自定义(标题、物品、描述)
- ✅ 集成开关(WorldGuard、Vault、PlaceholderAPI)
- ✅ 按世界设置(黑名单、行为覆盖)
- ✅ 调试选项(日志记录、性能监控)
每项功能均可配置:
示例:完全禁用某功能
guardian:
enabled: false
示例:更改行为
inventory:
overflow:
mode: "DROP_AT_FEET" # 改为掉落脚边,而非留在墓穴中
示例:自定义视觉效果
visuals:
block-material: "ENDER_CHEST"
particles:
type: "FLAME"
count: 10
? 消息自定义
350+ 行消息内容,包括:
- ✅ 所有面向玩家显示的文本
- ✅ MiniMessage 格式(渐变、RGB、十六进制颜色)
- ✅ 占位符(
%player%、%x%、%cost%等) - ✅ 聊天、标题、动作栏和全息图消息
- ✅ GUI 物品名称和描述
- ✅ 错误消息
- ✅ 调试消息
自定义示例:
默认设置:
grave-spawned:
chat: "%prefix%<yellow>Your grave has been created..."
自定义(带渐变效果):
grave-spawned:
chat: "%prefix%<gradient:red:gold>? RIP! Your items are safe at %x%, %y%, %z%</gradient>"
? 为什么选择 UltimateGraves?
对于服务器所有者:
✅ 提高玩家留存率 - 避免因物品丢失而愤怒退服
✅ 灵活性强 - 适应任何类型的服务器
✅ 专业品质 - 企业级代码质量
✅ 高性能 - 异步操作,优化的数据库
✅ 现代化 - 使用最新的 Minecraft 特性
✅ 持续支持 - 定期更新以适配新的 MC 版本
对于玩家:
✅ 公平性 - 物品受到保护,避免不公平的死亡损失
✅ 直观易用 - 易于使用的 GUI 和指南针
✅ 视觉效果清晰 - 明确的标记和全息图
✅ 便捷性 - 可传送至墓穴(可选功能)
✅ 透明度高 - 清楚知道墓穴何时过期
? 性能指标
- 死亡事件延迟: < 1ms(异步处理)
- 数据库查询时间: < 10ms(HikariCP 连接池)
- 内存占用: 缓存 500 个墓穴约 ~15MB
- 全息图更新开销: 每个墓穴每秒 < 0.1ms
- 粒子生成开销: 每个墓穴每刻 < 0.05ms
?️ 技术架构
使用的设计模式:
- 策略模式 (Strategy Pattern) - 保护模式
- 仓库模式 (Repository Pattern) - 数据库抽象
- 工厂模式 (Factory Pattern) - 墓穴创建
- 观察者模式 (Observer Pattern) - 事件系统
- 单例模式 (Singleton Pattern) - 管理类
代码质量:
- ✅ SOLID 原则
- ✅ DRY(不要重复自己)
- ✅ 使用注解的空值安全
- ✅ 异常处理
- ✅ 线程安全操作
- ✅ JavaDoc 文档
? 文档与支持
- ? Discord: geturplugins
? 总结
UltimateGraves 是为 Minecraft 1.21.1+ 提供的最全面、可定制且现代化的墓碑插件。拥有 51 个类、580+ 配置选项、350+ 条消息以及 5 种保护模式,专为对品质有高要求的服务器打造。
无论你需要基础物品保护,还是包含守卫生物和令牌访问权限的复杂经济驱动型墓碑系统,UltimateGraves 都能满足。
无冗余功能。无依赖项。只有纯粹、优化的墓碑管理。
? 快速开始
- 下载最新版本
- 放入
plugins/文件夹 - 按需配置
- 享受高级墓碑保护!
版本: 1.0.0
作者: geturplugins
支持: Discord (geturplugins)
基于 Paper API、Java 21 以及现代 Minecraft 开发实践,用 ❤️ 构建。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧