ChatItem

Originally created by dadus33.

Ever wanted to allow your players to show their items in chat, just to be sure they really have the item they want to sell to you? Well, this plugin does just that.

It's a lightweight plugin that works with
ALL chat formatting plugins, including Essentials, Factions, DeluxeChat and
ANY OTHER PLUGIN you can think of. It also supports offering in depth info about the item, just like you'd hover your cursor over the real item in your inventory. All you have to do is type your message while having the item you want to show in your hand, and using the configured placeholder.

Chat wrongly showed? Try /chatitem select !

Servers using this:

Spoiler: Show list

• RevivalMC play.revivalmc.fun
• og-network.net
• play.ArcadianMC.com
• LionCraftSB.mygs.co
• Invictus.cubed.pro
• Play.pinoylifecraft.com
• hub.psychocraft.net
• sv.minels.com
• mc.bacher.se
• 1moreblock.com
• play.horum.net
• avroxia.mc.gg
• daylight.fun
• play.ultimamc.tk
• Want your server here? Just tell me (maybe some of them have remove the plugin. It's an old list)

Videos:

By NumeroUno (slightly outdated)

Current features

• Support for all plugins!
• 1.8 to 1.21 minecraft versions are supported!
• Cross-Version support: for servers using ViaVersion or ProtocolSupport
• Permission support
• Custom item name and amount format changeable in config
• Multiple placeholders
• Extensive configuration options
• Reload command
• 100% customizable messages
• All mojang translations !

Dependencies

• No

required dependency

-
Supported plugin: LanguageUtils, ViaVersion, ProtocolSupport & ProtocolLib.

Permissions

• chatitem.reload -- allows you to reload the config
• chatitem.use -- allows your messages to be parsed by the plugin
• chatitem.ignore-cooldown -- allows you to bypass the message cooldown (if enabled)

Commands and config

/cireload - reloads the plugin

/chatitem - See help

/chatitem select - Help you to change how config the plugin

/chatitem admin - Open inventory to manage ChatItem options

/chatitem show - Show your item to yourself

/chatitem broadcast - Show your item to everyone

For default config, it's
here.

Example:

and...

Spoiler: For developers

For the ChatItem dependency, you have to use
jitpack :

Code (Text):

<repositories>

    ...

    <repository>

      <id>jitpack.io</id>

      <url>jitpack.io</url>;

    </repository>

    ...

  </repositories>

Then:

Code (Text):

<dependency>

  <groupId>com.github.dadus33-plugins</groupId>

  <artifactId>ChatItem</artifactId>

  <version>v2</version><!-- v2 is the branch, you can use release -->

</dependency>

Alternatively, if you are not using Maven, you can download the plugin itself and add it to your build path.

The JavaDocs should be automatically read by your IDE when using Maven, but they can also be manually added by downloading the Javadoc jars from the repository.

Spoiler: Issues

• The translations feature doesn't currently work properly in newer versions of Minecraft. That is because a lot of data values have changed and they will be fully replaced in the 1.13 update with item meta data. The next version of the plugin, 1.3.7, will feature a fully working translation feature adapted for 1.13 and a fallback system which should display the name of the item exactly as shown in the client's language.

Other than that, I will look into and hopefully solve any bugs or issues you might find, but only if you DON'T post it in the reviews section

Spoiler: How it works

The idea of the plugin is rather simple, but it's implementation is much more complicated. In short, all it does is that it intercepts outgoing server packets (that's why it needs ProtocolLib) and scans them for the placeholders needed. Then, the messages (in JSON format) are parsed by a nice JSON parser I made, and the replacements for the placeholders (the things for the item format you set in the config) are then added after being translated to valid JSON (using a modified version of
@DarkSeraphim's JsonUtils class), along with the things that make the item actually display when you hover your mouse over it's placeholder. As the plugin is directly editing outgoing JSON chat packets, it's 100% guaranteed that it won't interfere at all with the chat format, leaving you to use whatever chat plugin you need, without any kind of interaction with mine!

[](discord.gg/yng5PPf62h)

Fork the repository on GitHub or get instant help on the Discord channel!