ShowItem 2016-11-01

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 an updated version of WolfieMario's Text Icons RP: Direct link)

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!)
Requires Java 8!




--
Commands
/showitem (Alias: /si, /show)
Shows the item in your hand to every player around you. The radius can be set in the config.
Permission: showitem.command (Default: true)
/showitem <playername>
Shows the item in your hand to a specific player.
Permission: showitem.command.player (Default: true)
/showitem -radius <radius>
Shows the item in your hand to every player in the given radius.
Permission: showitem.command.radius (Default: true)
/showitem -world
Shows the item in your hand to every player in your current world.
Permission: showitem.command.world (Default: op)
/showitem -all
Shows the item in your hand to every online player.
Permission: showitem.command.all (Default: op)
/showitem -reload
Reloads the configs of the plugin
Permission: showitem.command.reload (Default: op)
/showitem -debug
Shows a debug message with the info of the item you hold in chat and in the console logs.
Permission: showitem.command.debug (Default: op)

Chat Variable
This 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.

Configs
This plugin contains several config and mapping files. The settings and messages of the plugin can be changed in the config.yml:
Code (YAML):
# If the messages should try finding a text icon for this item from WolfieMarios Resourcepack (http://imgur.com/a/oHvbX)
texticonrp: false
# 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
usefancymsg: true
# The default radius for the /showitem (/show, /si) command if no -r(adius) parameter is specified
defaultradius: 16
chat:
variable: "%item%"
# Which variable we should replace in the chat with the player's current item
commands:
# A list of commands where we should replace the variable with the item info, use * for all commands
- "msg"
- "say"
- "me"
- "ch"
# Cooldowns for the radius and the direct show command in seconds.
# 0 to disable cooldowns entirely.
# Exempt permission: showitem.cooldownexempt
cooldowns:
all: 300
world: 60
radius: 10
direct: 0
# 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!
usenickname: true
lang:
count: "(%count%x)"
item:
# 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
unnamed: "[%icon%%type%]%count%"
named: "[%icon%%name%]%count%"
# The %type% variable is also usable in the named string for example like this:
# named: "%icon%%type% &anamed %name%
all:
self: "You show the item %item% to everyone!"
target: "%player% shows everyone the item %item%!"
world:
self: "You show the item %item% to everyone in your world!"
target: "%player% shows the item %item% to everyone in his world!"
radius:
self: "You hold up the item %item%!%customradius%"
custom: "&8(View distance: %radius%&8 blocks)"
target: "%player% holds up the item %item%!"
player:
self: "You show %player% the item %item%"
target: "%player% shows you the item %item%"
error:
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!"
The other yml files (transmapping.yml and iconrpmapping.yml) are used for several different mappings, for example for mapping the bukkit materials to translation keys for multi language support.

Item Icons
This plugin can use an updated version of WolfieMario's Text Icon Resourcepack (updated pack: download, don't use the one from the imgur album!) 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 one of my free Bungee Resourcepacks or World Resourcepacks plugins or the enhanced Force Resourcepacks version to force your users to use the pack!

Used Utilities
ShowItem 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! MetricsLite is licensed under the following license:


Questions
Why don't I see any item icons in the chat?
Check if you have set the texticonrp option in your config.yml to true. (Note: You also need to use Wolfie Mario's text icon resourcepack for that to work proberly!)
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?
That can only happen if the mapping in the iconrpmapping.yml are wrong ‒ either for this item or all of them. If you changed the file try deleting it and letting it regenerate. If you did not do such a thing contact me with the items which are wrong and I will try to provide you with a fix/update!
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 try to 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 try to 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!

Terms
This plugin is licensed under GPLv3. By purchasing this resource you are gaining the rights stated in the license. You cannot refund your purchase after already acquiring the resource. It should work as described and if you have problems contact me! All of the rights given to you can be revoked at any time by the author, especially in the case that the terms were violated.
By downloading you accept the previous terms and the license this resource is under!

My Resources