DeathCoordinates - 死亡坐标传送

简介

DeathCoordinates 是一款轻量级插件，允许服务器玩家在聊天栏点击消息，传送回自己的死亡地点。通过权限控制，你可以决定哪些玩家能使用此功能。插件支持自定义消息、指定生效世界等配置，兼容 1.8 及以上版本，仅适用于 Spigot 服务端。

💡核心功能

• ✓ 可配置的死亡消息（支持点击事件）
• ✓ 可在特定世界禁用插件
• ✓ 设置传送最大时限
• ✓ 设置传送冷却时间
• ✓ 传送后无敌时间
• ✓ 熔岩与虚空保护
• ✓ 支持 PlaceholderAPI 变量
• ✓ 可配置的传送所需金额
• ✓ 支持 1.8+ 版本，仅限 Spigot

🎮使用教程

准备工作

首先，你需要一个权限管理插件（如 LuckPerms）。为需要使用此功能的玩家组添加以下权限：

• deathcoordinates.teleport：允许玩家传送至死亡地点。
• deathcoordinates.message：允许玩家在死亡后看到并点击坐标消息。

基本流程

• 拥有权限的玩家死亡后，聊天栏会显示一条可点击的死亡坐标消息。
• 玩家点击该消息，即可被传送回死亡地点。

🔧配置文件详解

以下是配置文件 config.yml 的主要内容与说明：

# --------------------------------------------------
# DeathCoordinates by Ajneb97
# 反馈问题请访问：
# https://www.spigotmc.org/resources/deathcoordinates-1-8-1-12.43318/
# --------------------------------------------------
Config:
  new-version-reminder: true
  lava_protection: true
  void_protection: true
  invulnerability_on_teleport:
    enabled: true
    time: 10
  teleport-maxtime:
    enabled: true
    time: 300
  teleport-cooldown: 15
  enabled-worlds:
    - world
    - world_nether
    - world_the_end
  teleport_money_required: 0
  console_notification:
    enabled: false
    message: "&cPlayer &e%player% &cjust died in: &8(&7%coord-x% %coord-y% %coord-z%&8, &cWorld: &7%world%&8)"
  world_alias:
    world: "Main World"
    minigames: "MiniGames World"
Messages:
  death-message:
    - "&cYou died! Your &4death coordinates &care:"
    - "&8(&7%coord-x% %coord-y% %coord-z%&8, &cWorld: &7%world%&8)"
  death-message-extra: "&cClick on this message to teleport you to your death position"
  no-died-recently: "&7You haven't died recently."
  incorrect-world: "&7You can't do that on this world"
  prefix: "&4[&cDeathCoordinates&4]"
  plugin-reload: "&aConfig Reloaded"
  console-command: "&7You need to be a player to use that command"
  nopermissions: "&7You don't have permissions to do that"
  wrongcommand: "&7That command doesn't exists"
  error-lava: "&7You can't go back to your death location because there is lava nearby"
  error-void: "&7You can't go back to your death location because you will fall in the void"
  error-money: "&7You need &a$%money% &7to teleport you to your death position"
  teleporting-message: "&7Teleporting..."

关键配置项说明

• teleport-maxtime：玩家死亡后，只有在此设定时间（秒）内才能传送回死亡地点。超时将无法传送。
• teleport-cooldown：玩家每次传送后，需要等待的冷却时间（秒）。
• invulnerability_on_teleport：玩家传送后获得短暂的无敌时间。
• enabled-worlds：插件仅在此列表中的世界生效。玩家只有在这些世界中死亡才会收到消息。
• teleport_money_required：传送所需的金额。设为 0 则禁用此功能。需要安装 Vault 经济插件。
• world_alias：为世界名称设置别名，用于在消息变量 %world% 中显示自定义名称。

✨PlaceholderAPI 变量

插件支持以下 PlaceholderAPI 变量，可用于其他插件或聊天栏：

• %deathcoordinates_coord_x%
• %deathcoordinates_coord_y%
• %deathcoordinates_coord_z%
• %deathcoordinates_world%
• %deathcoordinates_has_death_location%（返回 true 或 false）

⭐命令列表

• /dc teleport <player>：传送至指定玩家记录的死亡坐标。
• /dc show：重新显示你当前的死亡坐标消息。
• /dc info：显示插件信息。
• /dc reload：重载插件配置。
• /dc tp：传送你至自己的死亡地点（别名：/deathcoordinates）。

❓权限节点

• deathcoordinates.teleport：允许传送至死亡地点。
• deathcoordinates.message：允许查看死亡坐标消息。
• deathcoordinates.bypasstime：忽略配置中的传送最大时限。
• deathcoordinates.bypassmoney：忽略配置中的传送所需金额。
• deathcoordinates.admin：允许使用所有插件命令。

🔧注意事项与依赖

• 本插件仅支持 Spigot 服务端。
• 经济功能：如需使用 teleport_money_required 选项，必须安装 Vault 及配套的经济插件。
• 权限管理：需要配合权限插件（如 LuckPerms、GroupManager）使用。
• 如有任何新功能建议，欢迎向作者反馈。