InventoryFull - 背包满提示

💡InventoryFull 插件简介

InventoryFull 是一款轻量级插件，当玩家背包已满时，它会以多种方式发出提醒。只需在配置文件中启用任意一种提醒方式，并使用 /invfull reload 重载配置即可。启用后，一旦玩家背包空间不足，便会收到相应提示。

🎮提醒方式

InventoryFull 支持以下五种提醒方式，您可以根据需求在配置文件中启用或组合使用。

聊天信息

• 在聊天栏中向玩家发送背包已满的提示信息。

动作栏信息 (需要 ActionAnnouncer)

• 在玩家的动作栏（屏幕下方）显示背包已满的提示信息。

标题与副标题 (需要 TitleManager)

• 在屏幕中央以标题和副标题的形式显示背包已满的提示信息。

全息图 (需要 HolographicDisplays)

• 在玩家位置生成一个临时的全息文字，提示背包已满。

音效

• 当玩家背包已满时，播放一个自定义音效。

🔧命令与权限

所有命令都需要玩家拥有 inventoryfull.admin 权限才能使用。

可用命令

• /invfull
• 查看插件版本信息。
• /invfull reload
• 重新加载 config.yml 配置文件。

权限节点

• inventoryfull.admin
• 描述：允许使用 /invfull 和 /invfull reload 命令。
• 默认：仅限管理员 (op)。
• inventoryfull.alert
• 描述：当玩家背包已满且破坏方块无法拾取时，接收提醒。
• 默认：true (所有玩家)。

✨API 与开发者

插件提供了一个 API 事件，允许其他开发者监听玩家因背包已满而无法拾取物品的情况。

事件监听示例

@EventHandler
public void onFull(InventoryFullEvent e) {
    // 获取背包已满的玩家
    Player p = e.getPlayer();
    // 获取无法放入背包的物品
    ItemStack i = e.getItem();
}

⭐配置文件详解

以下是配置文件 config.yml 的默认内容与说明。

# InventoryFull version 1.5.2
# Created by: extended_clip
# 可用占位符：
# %block% - 显示掉落物品的类型
# %player% - 显示玩家名称
#
# 有效的音效列表，请访问：http://jd.bukkit.org/rb/apidocs/org/bukkit/Sound.html

# 冷却时间设置（单位：秒）
cooldown_time: 1
# 触发冷却前的最大提醒次数
max_alerts_until_cooldown: 10000

# 音效提醒
sound_when_full:
  enabled: true
  sound: NOTE_PLING
  volume: 10
  pitch: 1

# 聊天信息提醒
chat_message:
  use_chat_message: false
  message:
  - '&cYour inventory is full!'

# 动作栏提醒 (需 ActionAnnouncer)
actionannouncer:
  use_actionbar: true
  display_time: 5
  message:
  - '&cYour inventory is full!'
  - '&4Your inventory is full!'
  - '&eYour inventory is full!'
  - '&6Your inventory is full!'

# 标题提醒 (需 TitleManager)
titlemanager:
  use_title: false
  title: ''
  subtitle: '&cYour inventory is full!'
  fade_in: 12
  fade_out: 12
  duration: 20
  use_actionbar: false
  actionbar_message: '&cYou don''t have room in your inventory'

# 全息图提醒 (需 HolographicDisplays)
holographicdisplays:
  use_hologram: false
  message:
  - '&cYour inventory'
  - '&cis full!'
  display_time: 5

❓注意事项与支持

• 部分提醒方式（动作栏、标题、全息图）需要安装对应的前置插件。
• 修改配置文件后，请务必使用 /invfull reload 命令使更改生效。
• 音效名称请参考 Bukkit 官方文档，确保使用有效的枚举值。

如果本插件对您的服务器有所帮助，并希望支持开发者，请点击此处进行捐赠。