UltimateGraves

插件

· 作者 geturplugins

终极墓穴插件,支持多种游戏模式、金库集成等众多功能....

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

最新 1.0.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

** ? UltimateGraves - 完整插件概览


? 描述

UltimateGraves 是一款专为运行在 Paper 上的 Minecraft 1.21.1+ 服务器打造的付费、功能丰富的坟墓管理系统。当玩家死亡时,系统会在其死亡地点生成一个坟墓,安全地存储所有物品栏内容、盔甲和经验值,从而避免物品丢失。

基于现代 Java 21 和最新的 Paper API 构建,UltimateGraves 提供了无与伦比的性能、灵活性和可定制性。无论您运营的是生存服务器、RPG 领域还是硬核 PvP 竞技场,UltimateGraves 都能凭借其智能保护系统、智能位置检测以及广泛的配置选项,完美适应您的需求。

不再因物品丢失而愤怒退服。不再有无意义的岩浆或虚空死亡。只需安心游戏。


? 核心概念

当玩家死亡时:

  1. ? 智能位置检测 - 寻找安全位置(处理虚空、岩浆、墙壁内等情况)
  2. ? 物品保全 - 存储所有物品栏、副手及盔甲物品
  3. ⚰️ 坟墓生成 - 放置视觉标记(玩家头颅、全息投影、粒子效果)
  4. ? 受保护 - 可配置的保护模式(私有、公共、限时、PvP、令牌制)
  5. ? 导航 - 玩家获得指向坟墓的指南针
  6. ⏰ 过期机制 - 可配置的计时器,在此之后坟墓变为公开或过期
  7. ? 经济系统 - 可选的传送与拾取费用(支持 Vault 集成)

✨ 关键功能摘要

类别 功能
?️ 保护 5种保护模式、限时访问、PvP 检测、令牌系统、守护生物
? 视觉效果 玩家头颅坟墓、原生全息投影、粒子效果、信标光束、发光效果
?️ 存储 SQLite 与 MySQL 支持、异步操作、HikariCP 连接池、NBT 保留
? 智能逻辑 安全位置查找器、虚空/岩浆处理、灵魂绑定物品、溢出管理
? 经济系统 Vault 集成、传送费用、拾取费用、物品退款
? 交互 交互式 GUI、快速拾取、智能装备、指南针追踪、多点击操作
⚙️ 配置 580+ 行配置项、每项功能均可独立开关、热重载、按世界设置
? 集成 PlaceholderAPI、WorldGuard、Vault、开发者 API、自定义事件

? 详细功能分解

?️ 保护系统(策略模式)

5种保护模式:

  1. PRIVATE(私有)模式 ?

    • 仅坟墓所有者可访问
    • 拥有 bypass 权限的管理员可打开
    • 适合 PvE 服务器
  2. PUBLIC(公共)模式 ?

    • 任何人都可以拾取该坟墓
    • 先到先得
    • 适合硬核/无政府状态服务器
  3. TIMED(限时)模式 ⏰

    • 私有 X 秒(可配置)
    • 计时器结束后变为公共
    • 平衡公平性与风险
  4. PVP_PVE(玩家对战/环境)模式 ⚔️

    • 智能检测:
      • 被玩家击杀 → 公共坟墓(PvP 掉落物)
      • 被怪物/环境击杀 → 私有坟墓
    • 适合阵营/战争服务器
  5. TOKEN(令牌)模式 ?

    • 需要自定义物品(坟墓钥匙)才能打开
    • 钥匙可出售、奖励或制作
    • 创造独特的经济机会

? 视觉系统(原生 1.21 API)

坟墓方块:

  • 玩家头颅,显示所有者皮肤(默认)
  • 或可配置的材料(下界合金块、箱子、末影箱等)
  • 发光效果,颜色可自定义
  • 防爆且抗活塞推动

全息投影(TextDisplay 实体 - 无需额外插件):

⚰ 坟墓 ⚰
所有者: Steve
时间: 14分 32秒
死因: 坠入岩浆
物品数: 47
  • 实时倒计时
  • 完全可定制的文本行
  • MiniMessage 色彩支持(渐变、RGB、十六进制色码)
  • 每秒自动更新

粒子效果:

  • 上升的灵魂之火(类型可配置)
  • 可自定义数量、速度和扩散范围
  • 支持 20+ 种粒子类型
  • 可调整生成间隔

信标光束:

  • 仅对坟墓所有者可见
  • 从远处指向坟墓
  • 可配置颜色(RGB)
  • 可调整可见范围(默认 64 格)

? 智能位置算法

问题: 玩家在岩浆、虚空、墙壁内死亡 → 坟墓无法正常生成

解决方案:

if (在 VOID 中死亡) {
    → 扫描 10 格半径内的实心地面
    → 如果未找到:在 Y=5 处创建玻璃平台
}

if (在 LAVA 中死亡) {
    → 将岩浆替换为下界合金块
    → 清除周围岩浆(半径可配置)
}

if (在 WALL 中死亡) {
    → 射线投射寻找最近的空气区域
    → 在安全位置生成坟墓
}

可配置选项:

  • 搜索半径(水平和垂直方向)
  • 虚空平台高度
  • 岩浆替换方块
  • 不安全方块列表
  • 平台创建开关

? 独特的“高级”功能

  1. 坟墓守护系统 ?
  • 随机生成几率(默认 15%)
  • 僵尸/骷髅装备有玩家的盔甲和武器
  • 坟墓在守护生物被击杀前处于锁定状态
  • 可自定义:
    • 生物类型(僵尸、骷髅、凋零骷髅、猪灵蛮兵)
    • 生命倍率(默认 2x)
    • 伤害倍率(默认 1.5x)
    • 速度加成
    • 使用玩家占位符的自定义名称
    • 发光效果

示例:

玩家死亡 → 15% 几率生成 "Steve 的幽灵"
守护生物穿着 Steve 的钻石盔甲 + 下界合金剑
Steve 必须击败守护生物才能访问他的坟墓
  1. 灵魂绑定物品系统 ?
  • 通过 lore/NBT 标签标记物品
  • 这些物品在死亡时保留在物品栏中
  • 可配置标识符:
    - "<gold><bold>SOULBOUND</bold></gold>"
    - "§6§lSOULBOUND"
    - NBT 标签: "soulbound:true"
    
  • 非常适合任务物品、排名奖励等
  1. 溢出管理 ?
  • 拾取坟墓时玩家背包已满?
  • 选项:
    • LEAVE_IN_GRAVE(留在坟墓中) - 物品保留供下次访问
    • DROP_AT_FEET(掉落在脚边) - 物品以实体形式掉落
    • PREVENT_LOOT(阻止拾取) - 直到有空位才允许打开
  1. 智能装备 ?
  • 拾取坟墓时自动装备盔甲
  • 仅填充空的盔甲槽位
  • 优先装备最佳装备
  • 可按玩家单独切换
  1. 经验值保留 ⭐
  • 可配置保存的百分比(默认 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% 概率生成守护者

极限生存服务端 ?

  • 问题: 如果物品始终受到保护,难度太低
  • 解决方案: 短倒计时 + 守护者怪物
  • 配置: TIMED 2 分钟,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+(用于区域保护)

安装方法:

  1. 下载 UltimateGraves.jar
  2. 放入 plugins/ 文件夹
  3. 重启服务器(不要使用 reload)
  4. 配置 plugins/UltimateGraves/config.yml
  5. 编辑 plugins/UltimateGraves/messages.yml(可选)
  6. 使用 /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 都能满足。

无冗余功能。无依赖项。只有纯粹、优化的墓碑管理。


? 快速开始

  1. 下载最新版本
  2. 放入 plugins/ 文件夹
  3. 按需配置
  4. 享受高级墓碑保护!

版本: 1.0.0
作者: geturplugins
支持: Discord (geturplugins)


基于 Paper API、Java 21 以及现代 Minecraft 开发实践,用 ❤️ 构建。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源