原创 - 开源 - 其他 - [1.20.1-1.21.5] DropItem 物品掉落保护插件

版权类型: 原创

插件中文名称: DropItem

插件英文名称: DropItem

原帖地址: #

支持的核心（服务端）

Spigot

语言支持: 中文（简体）

适配版本（Java）

1.20

DropItem 物品掉落保护插件
一款强大的 Spigot/Paper 物品掉落保护解决方案

简介
DropItem 是一款专为 Minecraft Spigot/Paper 服务器精心设计的物品掉落保护插件。它的核心功能是保护玩家丢弃的物品，防止被其他未经授权的玩家拾取。不仅如此，它还会在受保护物品的上方清晰显示物品名称、所属玩家以及剩余保护时间。更强大的是，DropItem 还全面支持保护由玩家击杀的怪物掉落的物品以及玩家不幸死亡后散落的物品！

功能特点

玩家物品掉落保护：玩家主动丢弃的物品，在保护期内仅限自己拾取，杜绝误拾或恶意拾取。
怪物掉落物保护：玩家辛勤击杀怪物后，其掉落的战利品将受到保护，只有击杀者本人才能拾取。
玩家死亡掉落物保护：玩家意外死亡后，其掉落的物品也将被保护起来，给予玩家重新拾取的机会。
动态物品信息显示：在受保护物品的上方实时显示悬浮信息，内容包括：
- 物品名称（支持中文）
- 所有者/击杀者
- 保护剩余时间
醒目发光效果：所有受保护的物品都会呈现发光效果，使其在环境中更易被玩家识别。
自定义保护时间：管理员可以通过配置文件自由设定物品的保护时长，过期后物品将对所有玩家开放拾取。
智能超时移除：可配置物品在无人拾取的情况下，在超时后自动从世界中移除，保持服务器性能。
友好中文支持：物品名称优先采用中文显示，提升中文玩家的游戏体验。
便捷命令系统：提供简单的 `/di reload` 命令，方便管理员快速重载插件配置，无需重启服务器。

安装指南

下载最新版本的 `DropItem.jar` 文件。
将下载的 `.jar` 文件放入您服务器的 `plugins` 文件夹内。
重启您的 Minecraft 服务器，或使用兼容的插件管理器（如 PlugMan）加载插件。
首次加载后，插件的配置文件将自动在 `plugins/DropItem/` 文件夹中生成。

配置文件详解
插件包含三个主要的配置文件，允许您对各项功能进行细致调整。

config.yml (主要配置)
该文件控制插件的核心行为和各项保护机制的开关与参数。

YAML：

# DropItem 插件配置文件
# 作者: Saga

# 调试模式 (true/false)
debug: false

# 插件设置
settings:
  # 物品保护设置
  item-protection:
    # 是否启用物品保护
    enabled: true
    # 物品保护时间（秒）
    protection-time: 30
    # 是否显示物品信息
    display-info: true
    # 物品信息显示高度
    display-height: 0.5
    # 物品信息更新间隔（刻）
    update-interval: 20
    # 全息显示延迟（刻）
    hologram-display-delay: 10
    # 是否启用物品超时移除
    timeout-removal-enabled: true
    # 物品超时时间（秒）
    timeout-time: 120
    # 是否考虑服务器离线时间（true计算实际时间/false忽略离线时间）
    consider-offline-time: true
    # 是否启用怪物掉落物品保护
    mob-drops-protection: true
    # 怪物掉落物品保护范围（方块）
    mob-drops-protection-range: 2
    # 怪物掉落物品保护延迟（刻）- 用于确保物品已经掉落到世界中
    mob-drops-protection-delay: 5
    # 是否启用怪物掉落物精确匹配（true需匹配物品类型/false只判断距离）
    mob-drops-strict-matching: false
    # 是否启用玩家死亡掉落物品保护
    player-death-protection: true

DropItem 插件消息配置文件

YAML：

# DropItem 插件消息配置文件
# 作者: Saga

# 插件消息
plugin:
  prefix: "&7[&bDropItem&7] "
  reload: "&a插件已重新加载!"
  no-permission: "&c你没有权限执行此命令!"

# 命令消息
command:
  no-permission: "&c你没有权限执行此命令。"
  reload-success: "&a配置文件已重新加载。"
  unknown: "&c未知命令。使用 /di 查看帮助。"

# 物品保护消息
item-protection:
  # 物品信息显示格式（保护期间）
  display-format-protected: "[%item_name%&f][&c主人&a%player_name%&f][&e%time%&f秒]"
  # 物品信息显示格式（保护期过后）
  display-format-unprotected: "[%item_name%&f][&e%time%&f秒]"
  # 物品保护已过期消息
  protection-expired: "&c物品保护已过期"
  # 物品超时移除消息
  timeout-removed: "&c物品已超时移除"
  # 怪物掉落物保护格式（保护期间）
  mob-drops-format-protected: "[&6%item_name%&f][&c击杀者&a%player_name%&f][&e%time%&f秒]"
  # 怪物掉落物保护消息
  mob-drops-protected: "&a怪物掉落的物品将被保护 &e%time% &a秒!"
  # 玩家死亡掉落物保护格式（保护期间）
  death-drops-format-protected: "[&6%item_name%&f][&c死亡玩家&a%player_name%&f][&e%time%&f秒]"
  # 玩家死亡掉落物保护消息
  death-drops-protected: "&a玩家死亡掉落的物品将被保护 &e%time% &a秒!"

# 通用消息
general:
  prefix: "&7[&6物品掉落&7] "
  reload: "&a插件配置已重新加载!"
  no-permission: "&c你没有权限执行这个命令!"
  player-only: "&c只有玩家才能执行这个命令!"
  unknown-command: "&c未知命令,请使用 /di help 查看帮助!"
  help-header: "&6=== DropItem 帮助 ==="
  help-footer: "&6===================="
  help-format: "&7/di %command% &8- &f%description%"
  help-reload: "重新加载插件配置"
  help-version: "显示插件版本信息"
  version: "&6DropItem &7版本 &f%version%"

# 物品保护相关消息
item-protection:
  # 物品显示格式（保护期间）
  # 可用变量: %item_name%, %player_name%, %time%
  display-format-protected: "[&6%item_name%&f][&c主人&a%player_name%&f][&e%time%&f秒]"

  # 物品显示格式（保护期过后）
  # 可用变量: %item_name%, %time%
  display-format-unprotected: "[&6%item_name%&f][&e%time%&f秒]"

  # 提示信息
  pickup-denied: "&c这个物品还处于保护状态，属于 &e%player_name%&c!"
  protection-enabled: "&a物品保护已启用!"
  protection-disabled: "&c物品保护已禁用!"
  item-protected: "&a你掉落的物品将被保护 &e%time% &a秒!"

# 调试信息
debug:
  consider-offline-time: "&a服务器离线时间已计算，物品倒计时正常继续!"
  ignore-offline-time: "&a服务器离线时间已忽略，物品倒计时已重置!"

更新日志
版本 1.0.0 (初始版本)

[] 初始版本正式发布！
[] 实现核心的玩家物品掉落保护功能。
[] 实现动态物品信息显示（自定义名称）及醒目的发光效果。
[] 实现怪物掉落物保护功能，确保击杀者的劳动成果。
[] 实现玩家死亡掉落物品保护功能，给予玩家寻回机会。
[] 实现可配置的物品超时自动移除功能，优化服务器环境。
[] 内置中文物品名称支持，提升本地化体验。
[] 添加 /di reload 命令，方便管理员管理。