Gravestones - 墓碑插件

💡Gravestones

Gravestones 是一款为生存/Factions服务器设计的插件，旨在让玩家有机会重新获取死亡掉落的物品，而无需担心物品消失。当玩家死亡时，会在其死亡地点生成一个墓碑。右键点击墓碑可以查看死亡信息，包括玩家、死亡原因（基于服务器的死亡消息系统）以及死亡时间。如果玩家在寻找墓碑的过程中再次死亡，其之前的墓碑将被摧毁，物品会掉落出来。服务器重启时，所有活跃的墓碑会被序列化保存，并在玩家重新加入时恢复。

---

⭐核心特性

• 物品保护：死亡时自动生成墓碑，保护物品不会消失。
• 信息显示：右键点击墓碑可查看死亡玩家、死亡原因和死亡时间。
• 坐标提示：玩家死亡时会收到墓碑生成地点的坐标。
• 墓碑管理：玩家再次死亡时，旧的墓碑会被自动摧毁并掉落物品。
• 数据持久化：服务器关闭时，所有墓碑数据会被保存，重启后自动恢复。
• API支持：为开发者提供API，方便集成与扩展。

---

🎮命令与权限

插件主要功能为自动触发，暂无需要玩家直接执行的公开命令。所有功能通过事件和API管理。

---

🔧开发者API

插件提供了 GravestoneManager 类供开发者调用。你可以在主类 Main 中获取其实例。

获取 GravestoneManager 实例

GravestoneManager manager = Main.getGravestoneManager();

GravestoneManager 类方法摘要

• boolean hasGraveStone(Player player)

检查指定玩家是否已存在一个墓碑。

• Gravestone getGraveStone(Player player)

获取指定玩家的墓碑对象。

• Gravestone getGraveStone(Location loc)

获取指定位置的墓碑对象。

• int graveStoneCount()

获取当前存在的墓碑总数。

• Set getGravestones()

获取所有墓碑的不可修改集合。

• void addGravestone(Gravestone gravestone)

手动添加一个墓碑。

• void removeGravestone(Gravestone gravestone)

移除一个墓碑。

• Gravestone createGravestone(Location loc, Player player, String deathMessage, List contents)

在指定位置为玩家创建一个墓碑，包含死亡信息和物品列表。如果该玩家已有墓碑，旧的将被删除。

• void deleteGravestone(Gravestone gravestone)

删除指定墓碑，并向在线玩家发送提示消息、掉落物品并恢复原方块。

使用示例

以下是一个创建自定义墓碑的命令示例

package com.prophaze.gravestones.storage;
import com.prophaze.gravestones.Main;
import org.bukkit.command.Command;
import org.bukkit.command.CommandExecutor;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.inventory.ItemStack;
import java.util.List;
public class GravestoneCommand implements CommandExecutor {
public boolean onCommand(CommandSender sender, Command cmd, String label, String[] args) {
if (sender instanceof Player) {
Player player = (Player) sender;
Main.getGravestoneManager().createGravestone(player.getLocation(), player, "N/A", List. of());
}
return false;
}
}

---

❓注意事项与兼容性

• 服务器版本：已知在 NoNonsense (1.16.1) 服务器上运行。
• 数据安全：墓碑数据通过YML文件序列化保存，服务器重启或崩溃后数据不丢失。
• 物品掉落：当墓碑被系统或API删除时，其中保护的物品会正常掉落。
• 方块恢复：墓碑被移除后，其所在位置的方块会恢复为生成前的状态。