Purchase with Bitcoin or Litecoin on OpenBazaar!
(Other crypto currencies supported manually)
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!
Basic test server: test.moep.tv
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/1.13+ version)
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 almost every Bukkit chat plugin! If you find one that doesn't work (and is free/open source) then contact me and I will look into it! It also works together with ChestShop to display hover messages and item infos in buy/sell messages.
Blocks client crashes due to lots of item data! E.g. when the full content of a shulker box or a player head are send to the player this might lead to some issues that might cause the client to disconnect as it can't handle that amount of data. You can also individually configure certain item types to be blocked in the config!
Please note that this plugin will only work on Minecraft server and client versions starting with 1.8 and some functionality might break if you use different client and server versions!
(According to some users 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! You also might need old versions of this plugin to get it running on older Bukkit servers.)
Requires Java 8!
Spoiler: Known incompatibilities
/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)
/showslot <slot> (Alias: /ss)
Shows the item in a specific slot to every player around you. The radius can be set in the config. Finding out the correct slot is made easier with the inventory help click function! (middle click by default)
Permission: showitem.command.slot (Default: true)
Reloads the configs of the plugin
Permission: showitem.command.reload (Default: op)
Options change the behaviour of the command if enabled. All options can be used with both the /showitem and the /showslot command.
Shows the item to a specific player.
Permission: showitem.command.player (Default: true)
/<command> -radius <radius>
Shows the item to every player in the given radius.
Permission: showitem.command.radius (Default: true)
Shows the item to every player in your current world.
Permission: showitem.command.world (Default: op)
Shows the item to every online player.
Permission: showitem.command.all (Default: op)
Shows a debug message with the info of the item in chat and in the console logs.
Permission: showitem.command.debug (Default: op)
All permissions can also be viewed here.
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 placeholder variable can be configured (default is %item% and %item%slot%% e.g. %item40% for the off-hand), is case insensitive and has a separate permission node (showitem.chat and showitem.chat.slot) which is set to true by default.
You can also set a spam protection in the config (chat.max-per-message) that limites the times the variable is replaced in chat. (Use the permission showitem.chat.spam to bypass that limit, ops have that by default)
This feature should be compatible with the Minecraft chat and all Bukkit chat plugins. It will not work with BungeeCord or cross server chats! You can also define certain commands in which the variable should be available (for example /msg) to match you specific server configuration and plugins.
Inventory Slot Help Click
In order to find out the correct slot number you can use the inventory help click which defaults to the middle mouse button (doesn't do anything in vanilla survival but it can be changed in the config) which prints out a message which contains useful information on how to use the slot in the chat placeholder or the commands. (You can use the permission showitem.helpclick to manage who has access to it)
It will only show possible options that the player has access to. E.g. if your players only have access to the chat variable, player and default radius command then they will only see these three messages. And if a player does not have access to the slot-specific commands/variable at all this function won't do anything.
Please note that this only works on Spigot (or forks) that contain the Bungee-Chat-API!
You can define which items players are able to show and which not. These settings can be defined in the "block" section of the config.yml:
# Block certain items from getting shown.
# Can be bypassed with showitem.blockbypass and showitem.blockbypass.<blockname>
# List of materials to block
# Materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# - STONE
# - DIAMOND_SWORD
# Block items with certain strings in their names from getting shown (case-insensitive)
# r= prefix indicates that the string should be handled as a regex
# - "name 1"
# - "r=name \\d"
# Block items with certain strings in the lore from getting shown (case-insensitive)
# r= prefix indicates that the string should be handled as a regex
# - "name 1"
# - "r=name \\d"
# Item durability value, can use comparators, <x, >x, =x, !=x or just equal a single number
# Also supports chaining of comparators with a comma. E.g. >5,<20 for between 5 and 20
# Block items with the unbreakable tag
# Block items with certain enchantments, can block both all or only certain levels
# Names: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html
# Can take the same comparators as the durability
# - "DAMAGE_ALL"
# - "ARROW_DAMAGE:>2"
# Serialize the item to YAML and filter it with regex.
# This is only for advanced users and is less efficient, leave empty to disable.
# Block only specific items that match certain block types. All global types can be used.
# Can by bypassed with showitem.blockbypass.specific.<name> e.g. showitem.blockbypass.specific.special-sword
- "Phoenix616's Sword"
# Add multiple matcher, e.g. an invenerted matcher that
# blocks everything that isn't in this matcher
# inverted: true
# - WRITTEN_BOOK
By default only an example category is defined to block something (which shouldn't ever be an issue) and the comments explain each option. If you want certain players to bypass these blocks then you can use the showitem.blockbypass permission to allow bypassing of all blocks or the showitem.blockbypass.specific.<name> permission to allow bypassing certain specific blocks for a more finer control over what is blocked. (All specific blocks fall back on the default block if they didn't match, to bypass the default block use showitem.blockbypass.specific.default)
This plugin can use an updated version of WolfieMario's Text Icon Resourcepack (updated pack: download/1.13+ version, don't use the one from the imgur album!) to display an icon in the chat in front of the item's name which is a retextured Chinese Han symbol. 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 want to have more control your server resourcepacks and which players see the icons in chat then 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!
Note for Chinese users wanting to use the Icons:
With the default settings a part of the unified Han-symbols section in the Unicode standard is overridden by the item icons so if you need these symbols you have to use a different area of the unicode standard.
The easiest is to just change the offset in the mapping's configs to 0xAC00 and use a modified icon resource pack. (pre 1.13 pack, 1.13+ pack) These will use the modern Korean Hangul Syllables area of the Unicode instead which shouldn't interfere with Chinese Han Symbols as far as I'm aware.
If you want to use a different Unicode area then you will have to edit the names of the font files inside the resource pack accordingly.
This plugin contains several config and mapping files.
Almost all aspects about the plugin (settings and messages) can be changed in the config.yml.
The other yml files (transmapping.yml, iconrpmapping.yml and iconrpmapping-flattening.yml) are used for mapping the bukkit materials to translation keys for multi language support and for the chat icons.
You can use maven to depend on my plugin by using this API artifact and repository. There are also an online javadocs.
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 open source licenses!
It also adds some statistics via bStats.org. You can opt-out by changing the settings in the plugins/bStats/config.yml file! MetricsLite is licensed under the following license:
Spoiler: Versions before 1.4
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! E.g. with my ForceResourcepacks plugin.)
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. You can try setting use-translation-mapping to true in the config. If that didn't work either 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!
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!
By downloading you accept the previous terms and the license this resource is under!
Purchases are not subject to VAT according to §19 (1) of the German UStG.