Gravy - 无延迟墓碑插件

Gravy 是一款便捷的死亡物品回收插件。玩家死亡后，会在其位置生成一个受保护的坟墓（头颅），打破头颅即可取回物品。插件提供了一系列命令来管理坟墓，并包含完整的权限控制。

💡核心特性

• 玩家死亡且背包非空时，会在死亡位置生成一个坟墓（玩家头颅）。
• 坟墓可抵御爆炸和活塞推动，防止意外破坏。
• 打破坟墓头颅即可取回其中存放的物品。
• 若玩家死于水中或岩浆中，坟墓将自动寻找上方的第一个空气方块生成。
• 支持与玩家皮肤兼容。

🎮命令列表

主要命令

• /gravy help：显示所有可用命令。
• /gravy reload：重载插件配置文件。
• /gravy list：显示你自己的坟墓位置列表。
• /gravy list <player>：显示指定玩家的坟墓位置列表。
• /gravy recover：传送至你最近的坟墓（需在同一维度）。
• /gravy recover <player>：传送指定玩家至其最近的坟墓。
• /gravy permission：显示插件所有权限列表。
• /gravy worlds：列出服务器所有世界。
• /gravy enable <world_name>：在指定世界启用坟墓生成。
• /gravy disable <world_name>：在指定世界禁用坟墓生成。
• /gravy give <player> token <amount>：给予玩家指定数量的 Gravy 代币。

世界管理

• 使用 /gravy worlds 查看所有世界。
• 使用 /gravy enable 或 /gravy disable 控制特定世界的坟墓功能。

🔧权限节点

命令权限

• gravy.reload：使用 /gravy reload
• gravy.list：使用 /gravy list
• gravy.list.player：使用 /gravy list <player>
• gravy.recover：使用 /gravy recover
• gravy.recover.player：使用 /gravy recover <player>
• gravy.permission：使用 /gravy permission
• gravy.worlds.list：使用 /gravy worlds
• gravy.worlds.enable：使用 /gravy enable <world_name>
• gravy.worlds.disable：使用 /gravy disable <world_name>
• gravy.token.give：使用 /gravy give <player> token <amount>
• gravy.updater：在聊天中查看更新链接

坟墓交互权限

• gravy.break：允许破坏任何坟墓
• gravy.protected：在线时，拥有 gravy.break 权限的玩家也无法破坏你的坟墓
• gravy.info：右键点击头颅可查看坟墓信息
• gravy.grave：玩家死亡时生成坟墓
• gravy.notimer：坟墓永不消失（无限计时器）

代币系统权限

• gravy.token.use：允许玩家使用代币
• gravy.token.craft：允许玩家合成代币
• gravy.token.drop：允许玩家从生物掉落获得代币

经济系统权限 (需 Vault)

• gravy.money.use：玩家可以花钱生成坟墓
• gravy.money.nocost：免费生成坟墓

✨配置详解

以下为配置文件 (config.yml) 中的关键选项：

基础设置

• debug_mode: false：调试模式，请保持为 false。
• chat_prefix: '&3gravy >>'：聊天信息前缀。
• chat_line_color: '&2'：聊天中分隔线的颜色。
• save_timer: 60：数据保存间隔时间（秒）。
• do_safe_grave_spawn: true：启用安全坟墓生成，防止坟墓出现在意外位置。

坟墓与僵尸

• grave_timer: 1200：坟墓存在时间，超时后消失（秒）。
• enable_timer: true：是否启用坟墓消失计时。
• spawn_zombie_on_not_owner_break: true：当玩家破坏非自己所属的坟墓时生成僵尸。
• spawn_zombie_on_owner_break: false：当玩家破坏自己的坟墓时生成僵尸。
• zombie_hp: 20：生成僵尸的生命值。
• can_zombie_pickup_items: true：生成的僵尸是否会拾取地上的物品。
• drop_items_on_player_kill: false：玩家被其他玩家杀死时，是否直接掉落物品（不生成坟墓）。

命令执行

• execute_command_on_respawn: true：玩家重生时执行命令。
• execute_command_on_grave_break: true：玩家破坏坟墓时执行命令。
• command_: ' '：玩家重生时执行的命令。
• command_on_grave_break: ''：玩家破坏坟墓时执行的命令。
• 命令中可使用以下变量：

- `%%player%%`：玩家名

- `%%xpos%%, %%ypos%%, %%zpos%%`：玩家死亡坐标

代币系统

• enable_token_use: true：启用代币。启用后，玩家死亡时背包需有代币才会生成坟墓。
• enable_token_craft: true：启用代币合成。
• enable_token_drop: true：启用代币生物掉落。
• token_drop_mob: GHAST：掉落代币的生物类型。
• token_drop_amount: 1：每次掉落数量。
• token_drop_chance: 0.05：掉落几率 (0.05 = 5%)。
• token_item: MAGMA_CREAM：代表代币的物品。
• token_craft_recipe: ...：代币的合成配方（详见配置文件）。

其他

• disabled_worlds:：在此列表中的世界将禁用坟墓功能。

❓常见问题与说明

版本与依赖

• 最新版本 仅支持 Minecraft 1.13 及以上。
• 如需旧版本（1.12 及以下），请下载 1.2.9 版本。
• 1.4.6 及以上版本需要 NBTApi 作为依赖，请务必下载。

坟墓保护机制

• 只有拥有 gravy.break 权限的玩家才能破坏坟墓。
• 如果坟墓所有者拥有 gravy.protected 权限且在线，即使有 gravy.break 权限的玩家也无法破坏其坟墓。
• 使用 /gravy recover 传送时，你与目标坟墓必须处于同一维度（例如，不能从主世界传送到下界的坟墓）。

报告错误

插件仍在开发中，可能会存在漏洞。报告错误时，请提供以下信息：

• 服务器核心（如 Spigot、Bukkit）
• 服务器版本（如 1.16.5）
• Gravy 插件版本
• 控制台错误输出
• 详细的错误描述

重要须知

• 禁止反编译插件源代码。
• 禁止重新上传此插件。
• 禁止在你的插件中包含此插件源码。
• 禁止声称此插件为你所有。
• 任何建议或功能请求，欢迎在讨论区提出。

> 最后，感谢您的使用！一个真诚的好评或一句感谢就是对我最大的支持。