DivineDrop - AWESOME DROP MANAGEMENT - DivineDrop - 掉落物管理

DivineDrop 是一款功能强大的物品显示与清理插件，它可以在掉落物上显示物品名称、堆叠数量以及清理倒计时（如果启用了清理功能）。插件还提供了诸如潜行拾取等高级选项，帮助您更好地管理服务器中的掉落物。

💡功能特性

• 在掉落物上方显示自定义信息，包括物品名称和堆叠数量。
• 可启用自动清理功能，为掉落物添加可视化的删除倒计时。
• 支持通过潜行（Shift键）来拾取物品，防止误捡。
• 高度可配置的显示格式与计时器，支持按物品材质和自定义名称进行不同设置。
• 兼容多语言，并支持忽略其他插件的“不可拾取”物品标签。
• 支持从 Minecraft 1.8.8 到 1.21 的服务器版本。

🎮命令与权限

以下是插件提供的命令及其对应权限

主命令

• /divinedrop 或 /dd

- 显示插件的基本信息。

- 所需权限：`divinedrop.info`

• /divinedrop reload 或 /dd reload

- 重新加载插件的配置文件。

- 所需权限：`divinedrop.reload`

实用命令

• /divinedrop getname 或 /dd getname

- 获取您手中物品的内部名称（Material）。

- 所需权限：`divinedrop.getname`

- 此命令可用于在配置自定义计时器时，快速查询物品的准确材质名。

🔧配置说明

以下是核心配置选项的详解。您可以在 config.yml 文件中进行修改。

基础设置

check-updates: true
pickup-items-on-sneak: false
ignore-no-pickup-items: true
lang: "en_CA"

• check-updates: 是否在聊天栏和后台为管理员显示更新通知。
• pickup-items-on-sneak: 设为 true 时，玩家必须按住 Shift 键才能拾取物品。
• ignore-no-pickup-items: 设为 true 时，插件会忽略其他插件标记为“不可拾取”的物品，以增强兼容性。
• lang: 设置语言文件。可用的语言代码列表见下文。

物品显示格式

format: "&f%name% &7(x%size%)"

• 此格式用于当清理器未启用，或物品没有倒计时时。
• 可用占位符：%name% (物品名), %size% (堆叠数量)。
• 注意：此处 %countdown% 占位符无效。

消息文本

您可以自定义插件发送的各种消息的前缀和内容。

掉落物清理器

drop-cleaner:
  enabled: false
  format: "&c[&4%countdown%&c] &f%name% &7(x%size%)"
  timer: 10
  timer-for-loaded-items: true
  save-player-dropped-items: false
  enable-custom-countdowns: false

• enabled: 总开关，设为 true 以启用自动清理功能。
• format: 启用清理器后物品的显示格式。可用占位符：%countdown%, %name%, %size%。
• timer: 全局默认的清理倒计时（秒）。
• timer-for-loaded-items: 区块加载时已有的物品是否也应用计时器。
• save-player-dropped-items: 设为 true 时，玩家丢弃的物品将不会被自动清理。
• enable-custom-countdowns: 是否启用针对特定物品的自定义计时规则。

自定义计时器

当 enable-custom-countdowns 启用后，您可以在此部分为特定物品设置独立的倒计时和显示格式。

custom-countdowns:
  DIAMOND_SWORD:
    name-filter: "*"
    timer: 20
    format: "&c%name% &7(x%size%)"

• 键名必须是物品的材质名（Material）。请参考官方文档：Material 列表。
• name-filter: 物品的自定义名称过滤。

- `"*"`：匹配任何名称（包括默认名称）。

- `""`（空字符串）：仅匹配没有自定义名称的物品（即默认名称）。

- `"特定名字"`：仅匹配完全符合该自定义名称的物品。

• timer: 该物品的专属倒计时（秒）。设置为 -1 可使该物品永不消失。
• format: 该物品的专属显示格式（可选，不设置则使用全局格式）。

✨支持的语言

插件内置了丰富的语言支持，您可以通过修改配置中的 lang 选项来切换。以下为部分可用语言代码示例：

• zh_cn (简体中文)
• en_us (美式英语)
• ja_jp (日语)
• ru_ru (俄语)
• es_es (西班牙语)
• fr_fr (法语)
• de_de (德语)

完整列表包含数十种语言，如 uk_ua, vi_vn, pt_br, ko_kr 等，您可以在插件发布页或语言文件夹中查看全部选项。

❓帮助与支持

• 在报告任何错误之前，请确保您使用的是插件的最新版本。
• 所有的功能改进建议或问题反馈，请提交到插件的 讨论区（Discussion section） 或 GitHub Issues 页面。
• 感谢您使用 DivineDrop！