ChatItem - Display items in chat! - ChatItem - 聊天物品展示插件

ChatItem 是一款轻量级插件，允许玩家在聊天中展示手中持有的物品，便于交易或分享。它兼容所有聊天格式插件，并支持显示物品的详细信息，如同在背包中悬停查看一样。

💡核心特性

• 广泛兼容：支持 Essentials、Factions、DeluxeChat 等所有主流聊天格式插件。
• 版本支持：全面支持 Minecraft 1.8 至 1.21 版本。
• 跨版本支持：适配使用 ViaVersion 或 ProtocolSupport 的服务器。
• 高度可定制：可自定义物品名称和数量的显示格式、全部消息文本，并提供多种占位符。
• 多语言：支持所有 Mojang 官方翻译。
• 权限系统：完整的权限节点控制。
• 管理命令：提供重载配置、管理选项等命令。

🎮命令列表

• /cireload - 重载插件配置。
• /chatitem - 查看帮助信息。
• /chatitem select - 帮助调整插件配置。
• /chatitem admin - 打开管理界面，设置 ChatItem 选项。
• /chatitem show - 向自己展示手中的物品。
• /chatitem broadcast - 向所有在线玩家广播展示手中的物品。

🔧使用方式

• 手持你想要展示的物品。
• 在聊天栏输入你的消息，并加入配置好的占位符（例如 [item]）。
• 发送消息，物品就会以可交互的格式展示在聊天中。
• 如果聊天显示异常，可以尝试使用 /chatitem select 命令进行调整。

✨权限节点

• chatitem.reload - 允许重载插件配置。
• chatitem.use - 允许玩家的消息被插件解析并展示物品。
• chatitem.ignore-cooldown - 允许绕过消息冷却（如果已启用）。

❓依赖与兼容

• 必需依赖：无。
• 支持插件：LanguageUtils, ViaVersion, ProtocolSupport, ProtocolLib。

⭐配置与开发

• 默认配置文件可在此查看：[here](here)。
• 对于开发者：如需在项目中使用 ChatItem 作为依赖，可通过 JitPack 仓库引入。

jitpack.io 
https://jitpack.io 
com.github.dadus33-plugins 
ChatItem 
v2 

• JavaDocs 在使用 Maven 时通常会自动加载，也可从仓库手动下载 Javadoc jar 包添加。

💡注意事项与已知问题

• 翻译功能：在较新的 Minecraft 版本中，物品翻译功能可能无法完全正常工作。这是由于大量数据值在 1.13 更新中被物品元数据取代。预计在插件版本 1.3.7 中，将提供适配 1.13+ 的、功能完整的翻译系统及回退机制。
• 问题反馈：如发现任何漏洞或问题，请勿在评论区内发布。请通过 GitHub 或 Discord 频道进行反馈，以便开发者及时处理。

🔧工作原理简述

插件通过拦截服务器发出的数据包（因此需要 ProtocolLib），并扫描其中的特定占位符。随后，利用自定义的 JSON 解析器处理消息，将配置好的物品格式转换为有效的 JSON 格式，并添加使物品能够悬停查看的组件。由于插件直接操作外发的 JSON 聊天数据包，因此能 100% 保证不与任何聊天插件的格式发生冲突。

• 获取帮助：欢迎在 Discord 频道中交流。
• 开源贡献：项目仓库已托管于 GitHub，欢迎 Fork 与贡献。