CustomDeathMessages (CDM) - CustomDeathMessages - 自定义死亡消息

CustomDeathMessages 是一款高度可定制、跨版本的 Minecraft 插件，允许你编辑游戏中的所有死亡消息。它内置了默认消息，你可以轻松修改、删除或添加新内容。安装插件后，一切即可就绪！本插件支持 1.8 及以上所有版本。

💡核心特性

• 编辑游戏中的每一条死亡消息！
• 可开关且可配置的全局死亡消息。
• 可开关的悬停事件，用于显示原始死亡消息。
• 可开关的悬停事件，用于显示物品提示信息。
• 可开关的闪电效果，在玩家被击杀时触发。
• 内置多种占位符。
• 可自定义玩家死亡时掉落头颅的几率，头颅名称也可自定义。
• 提供游戏内命令，可轻松修改任何配置值。
• 支持使用 &#hex 格式的十六进制颜色代码。
• 可开关并单独配置 PvP 死亡时发送给受害者和击杀者的消息。
• 更新检查器会在插件有更新时发送通知。
• 功能广泛且高度可定制的配置文件。

🎮命令与权限

所有命令中的 <path> 参数均支持自动补全，无需手动查找配置文件路径。

命令列表

• /cdm reload
• 重新加载配置文件。
• 所需权限：cdm.reload

• /cdm add <path> [new message]
• 向指定路径的死亡消息列表中添加新消息。
• 所需权限：cdm.modify

• /cdm list <path>
• 列出指定死亡原因的所有消息及其索引号，索引号用于删除特定消息。
• 所需权限：cdm.modify

• /cdm remove <path> <index>
• 从配置中删除指定路径和索引的消息。索引号可通过 /cdm list <path> 获取。
• 所需权限：cdm.modify

• /cdm set flag <path> <true|false>
• 切换配置中某个功能开关（布尔值）。
• 所需权限：cdm.modify

• /cdm set message <path> <message>
• 设置配置中的字符串消息。
• 所需权限：cdm.modify

• /cdm set number <path> <number>
• 设置配置中的数值。
• 所需权限：cdm.modify

更新检查器权限

• cdm.updates
• 拥有此权限的玩家将在插件有可用更新时收到通知。

🔧配置文件概览

以下为 config.yml 文件的核心部分示例。你可以添加、编辑或删除任何消息。

# 启用更新消息
enable-update-messages: true

# PvP 消息设置
enable-pvp-messages: true
killer-message: '&e[ &cDeathMessages&e ] &e你击杀了 &c%victim%'
victim-message: '&e[ &cDeathMessages&e ] &e你被 &c%killer% &e击杀了'

# 闪电效果
enable-lightning: true

# 头颅掉落设置
drop-head-percentage: 0.5 # 掉落几率 (0-1)
head-name: "&c%victim%'s Head" # 掉落头颅的名称

# 消息冷却时间（秒），0 为禁用
message-cooldown: 0

# 全局消息与悬停提示
enable-global-messages: true
enable-original-on-hover: false
enable-item-on-hover: true

# 全局 PvP 死亡消息示例（支持占位符）
global-pvp-death-messages:
  - "&c%victim% &e被 &c%killer% &e击杀了"
  - "&c%victim% &e惨遭 &c%killer% &e毒手，凶器是 &7[&b%kill-weapon%&7]"

# 近战死亡消息示例
melee-death-messages:
  - "&c%victim% &e被 &c%killer% &e扇了一巴掌"
  - "&c%victim% &e被 &c%killer% &eKO了"

# 为有自定义名称的生物启用独立消息
enable-custom-name-entity-messages: true
custom-name-entity-messages:
  - "&c%victim% &e被 %entity-name% &e教训了"

# 各种死亡原因的消息列表（以下仅展示部分类别）
fall-damage-messages:
  - "&c%victim% &e把自己摔成了煎饼"
drowning-messages:
  - "&c%victim% &e发现自己并没有鳃"
creeper-messages:
  - "&c%victim% &e被一只 &a&l苦力怕 &e炸上了天"
unknown-messages:
  - "&c%victim% &e死于未知原因"

# 开发者模式与配置版本（请勿修改）
developer-mode: false
config-version: 2

占位符说明

• PvP/近战消息常用占位符：%victim%, %victim-nick%, %killer%, %killer-nick%, %kill-weapon%, %killer-x%, %killer-y%, %killer-z%, %victim-x%, %victim-y%, %victim-z%
• 生物相关消息常用占位符：%victim%, %victim-nick%, %entity-name%, %victim-x%, %victim-y%, %victim-z%
• 使用 &#hex 格式可在消息中使用十六进制颜色代码。

✨使用须知

• 插件兼容 1.8 及以上所有服务器版本。
• 修改配置文件后，可使用 /cdm reload 重载生效。
• 所有死亡原因的消息均可自由定制，配置文件结构清晰，易于编辑。
• 如果遇到未覆盖的死亡原因，将使用 unknown-messages 列表中的消息。
• 建议保持 config-version 不变，除非插件作者明确要求修改。