Did you ever want to show your items and their abilities to other players like you can in big MMORPGs? Or do you have players that are sick of having to throw their items on the ground or buying the wrong ones? Then this plugin is exactly what you need!
With the ShowItem Bukkit plugin you will be able to take full advantage of what Minecraft has to offer while working with items! It even takes it a step further and adds the ability to show an actual icon of the item in the chat!
(Note: You will need to use WolfieMario's Text Icons RP for that!)
This plugin also supports translatable item names so that players will see the name of the showed item in the language of their client!
It works with every Bukkit chat plugin! If you find one that doesn't work, I'll make it work!
Please note that this plugin will only work on Minecraft client versions above 1.8!
(1.8 protocol-hack servers seem to also be working, but the players still need to use 1.8+ clients for the display to work properly!)
Commands/showitem (Alias: /si, /show)
Chat VariableThis plugin includes the ability to show your main hand's item directly in your chat message by adding a variable in your message. This variable can be configured (default is %item%), is case insensitive and has a separate permission node (showitem.chat) which is set to true by default.
This feature should be compatible with the Minecraft chat and alle Bukkit chat plugins. It will not work with BungeeCord or cross server chats!
You set the commands in which the variable should be available (for example /msg) to match you specific server configuration and plugins.
ConfigsThis plugin contains several config and mapping files. The settings and messages of the plugin can be changed in the config.yml:
# This option sets wether we should try to use the Bungee chat api when we detect a spigot server
# It does nothing on a normal craftbukkit
# The default radius for the /showitem (/show, /si) command if no -r(adius) parameter is specified
# Which variable we should replace in the chat with the player's current item
# A list of commands where we should replace the variable with the item info, use * for all commands
# Cooldowns for the radius and the direct show command in seconds.
# 0 to disable cooldowns entirely.
# Exempt permission: showitem.cooldownexempt
# Whether or not we should attempt to send the nickname instead of the username
# This will also include colors/prefixes of the team the player is in!
# The different texts that display the item
# The %icon% variable will only be displayed then texticonrp is set to true
# The %count% variable will be replaced with lang.count if more than 1 item is shown
# The string will be automatically colored but it tries to respect custom codes
# The %type% variable is also usable in the named string for example like this:
# named: "%icon%%type% &anamed %name%
self: "You show the item %item% to everyone!"
target: "%player% shows everyone the item %item%!"
self: "You show the item %item% to everyone in your world!"
target: "%player% shows the item %item% to everyone in his world!"
self: "You hold up the item %item%!%customradius%"
custom: "&8(View distance: %radius%&8 blocks)"
target: "%player% holds up the item %item%!"
self: "You show %player% the item %item%"
target: "%player% shows you the item %item%"
noitem: "&cYou don't have an item to show in your hand. :("
playeroffline: "&cThe player %player%&c is not online"
noonearound: "&cThere are no players around which could see your item :("
cooldown: "&cYou have to wait %remaining%&c more seconds before showing another item!"
Item IconsThis plugin can use WolfieMario's Text Icon Resourcepack to display an icon in the chat in front of the item's name. Enable this functionality by setting the texticonrp option to true in the config.yml and set WolfieMario's pack as your server resourcepack or integrate the changed chinese font sheets in your current server resourcepack.
If you use BungeeCord and want to set the pack on your whole network you can use my free BungeeResourcepacks plugin!
Please note that his pack isn't updated to 1.8 yet so you will not see icons for new items like from rabbits or ocean monuments!
Used UtilitiesShowItem contains some utilities you might find useful in your own projects for example one to convert Bukkit Material names to Minecraft item ids, one for Material to translation key resolving and one to map WolfieMario's text icons to the Materials. Feel free to use them, they are licensed under MPL v2.0!
It also includes MetricsLite to add some statistics via mcstats.org. You can opt-out by changing the settings in the plugins/PluginMetrics/config.yml file!
QuestionsWhy don't I see any item icons in the chat?
Help! Why do I have Chinese symbols now after I enabled that option?
These icons are Chinese Han symbols that get replaced via this resourcepack which you have to use for the icons to display right! (The best way for all users to get it are server resourcepacks!)
Now that I see the icons they seem to display the wrong item?
Why does my item name look like it does on this image?
This happens when the mapping for this item's translation key is not correct. Contact me with the item that didn't work and I will provide a solution/update for you asap!
(If you are really skilled you can figure that out on your own by looking at Minecraft's language file and adding it with Bukkit's Material to the transmapping.yml in the same fashion as the others!)
Why does it say "Unknown language key: xyz"?
This message tells you that you are missing a configuration option in the language section. This happens when an update adds new messages and you didn't add them to your config or let the config regenerate.
In the case from the image you would have to add a string at lang.item.unnamed that sets the display format of an unnamed item. (Take a look at the config above for more information)
Why does "Invalid Item" appear when I hover over the item name instead of the item description?
This happens when the mapping of the Bukkit material name to the Minecraft item id is not correct or missing. You can contact me with the item you used and the output of "/showitem -debug" and I will fix it for you asap.
(If you want to fix that yourself you have to look up the item's Material name and it's Minecraft id and add them to the idmapping.yml)
If you have any other questions feel free to contact me any time! The best way is via a private message here or the discussion forum to this resource.
Generally I should be able to get back to you with an answer in less then 12 hours ‒ during East Coast working hours it can even be under 1 hour!