Item2Chat - 物品展示

Item2Chat 是一款允许玩家在聊天中展示手持物品详情的插件。当玩家在聊天中输入预设的关键词（默认为 [item]）时，其他玩家将鼠标悬停在该词上即可查看物品的详细信息。本插件无需依赖特定服务端版本，并支持 RGB 颜色和物品栏展示等新功能。

💡功能特性

• 在聊天中通过关键词展示手持物品。
• 支持 RGB 颜色代码。
• 支持展示物品栏中的物品。
• 可配置多个触发关键词。
• 支持异步聊天数据包发送，以兼容其他聊天插件。
• 可配置冷却时间与权限节点。
• 支持 PlaceholderAPI 占位符（需额外安装）。

🎮命令与权限

命令

• /item2chat help – 显示帮助菜单。
• /item2chat reload – 重载配置文件 config.yml。
• /item2chat debug <true|false> – 开启或关闭调试模式。

权限

• item2chat.use – 允许使用注册的关键词（如 [item]）来展示手持物品。
• item2chat.reload – 允许使用重载命令 /item2chat reload。
• item2chat.cooldown_bypass – 允许绕过冷却时间限制。
• item2chat.debug – 允许使用调试命令 /item2chat debug。

🔧安装与依赖

要求

• 服务端：Bukkit/Spigot/Paper 1.17 及以上版本。
• 必需前置插件：ProtocolLib。
• 可选前置插件：如需在物品前缀中使用 PlaceholderAPI 占位符，请安装 PlaceholderAPI。

安装步骤

• 确保已安装 ProtocolLib。
• 将 Item2Chat.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。

⭐配置说明

以下是 config.yml 文件的主要内容与说明。注意：请勿在配置中使用 Tab 制表符。

# 消息配置
Messages:
  ErrorMsg: "&c[Item2Chat] : Some error occured."
  NoItem: "&c[Item2Chat] : You must have something in your hand to use Item2Chat!"
  NoPermission: "&c[Item2Chat] : You don't have a permission."
  CoolDown: "&c[Item2Chat] You have to wait for &b%remaining% &aseconds."

# 帮助消息
HelpMessages:
  banner:
    msg: "=== &e[&aItem2Chat Commands List (%version%)&e] &r==="
  help:
    msg: "&a/item2chat help : displays this help menu."
  reload:
    msg: "&a/item2chat reload : reloads config file."
    permission: "item2chat.reload"
  debug:
    msg: "&a/item2chat debug <true|false> : turn on / off the debug mode."
    permission: "item2chat.debug"

# 是否以异步方式发送聊天数据包，若与其他聊天插件冲突可尝试调整此项
AsynchronousMode: true

# 事件优先级设置，若与其他插件的事件处理冲突可在此调整
EventPriorityMap:
  AsyncPlayerChatEvent: "LOWEST"

# 冷却时间（秒）
Cooldown: 10

# 关键词是否区分大小写
CaseSensitive: false

# 触发关键词列表
Keyword:
  - "[item]"
  - "{item}"
  - "{i}"

# 物品在聊天中的行内显示格式
InlineFormat: "&r&f[%name%%INLINE_AMOUNT%&r&f]"
InlineAmountFormat: " (x%amount%)"

❓注意事项与支持

• 确保正确安装 ProtocolLib，否则插件无法运行。
• 若遇到聊天显示问题，可尝试调整 AsynchronousMode 或 EventPriorityMap 设置。
• 插件从 v6.3.0 开始支持 1.17 版本。
• 开发者接受捐赠以持续提供插件更新与支持。