WhatIsIt
WhatIsIt - Item and entity names library and plugin
Help support development of WhatIsIt: Donate (Total donated to date: 6 USD)
This plugin aims to fill the hole of friendly item names in Minecraft server. This plugin is a must include for any other plugin requiring friendly item names, such as auction and trading plugins, and is a memorable toy for any server which has items, blocks or entities.
This plugin has been developed primarily for:
Drop by and pay us a visit!
Features
This plugin is primarily a library to get friendly names from a yml file for entities, blocks, items and enchantments. Easy access to public static commands makes integration into any plugin fast and easy.
All names are stored in names.yml. Storing the names in a customizable .yml file allows for easy language conversion and support for custom items with new item id's which would not normally be recognized by plugins which are not Spout compatible.
- Added monster type support to monster spawner blocks. (v1.0.2)
- If any spawner drop plugins assign the typeid to the data or damage, it should also display properly. (v1.0.2)
Videos
Plans
- Add authors for books.
Commands
Requires permission "whatisit.use":
- /wis - What is this? Shows friendly item info for the held item.
- /wit - What is that? Shows friendly entity or block info for what you're targeting.
Requires permission "whatisit.admin":
- /wis itis {String name} - Set name for item and save names.yml.
- /wit itis {String name} - Set name for item and save names.yml.
- /wis reload - Reload names.yml before showing item name.
- /wit reload - Reload names.yml before showing item name.
Permissions
- whatisit.use - Allows you to use the /wis and /wit commands. (default: op)
- whatisit.admin - Allows administrative functions. (default: op)
Permission Notes
- These permissions do not affect other plugins calling shared functionality.
- Vault is required in 1.b.1, but a fallback to superPerms has been added in 1.0.0.
Setup
This plugin is installed much like every other plugin. Put the WhatIsIt.jar file in your /plugins/ folder and restart the server. The config files automagically appear in the /plugins/WhatIsIt/ folder. Set up your permissions per the permissions plugin directions of your choice (this supports Vault, so any perms works, without Vault, uses bukkit's built-in system).
- In v1.b.0, the names.yml file is being generated with the config.yml content. Please use the uploaded names.yml file available on the file list on the right.
Configuration
In the config.yml file's config section, there is only one option, display-data-values. Set to true or false, the default is true. This will display the data values when using the /wis and /wit commands. This does not affect other plugins display of data values, they will not be sent data values from this plugin.
Everything else in config.yml is editable messages. Except the parenthesis around the data values and names, all output from WhatIsIt is specified in the messages section of config.yml. Edit here if you want to change these. These messages affect only WhatItIs output and not any plugin that calls WhatItIs.
In the names.yml file, separated by type, are id/name pairs. These are the values used to generate the names. You can edit them in game with commands or in the file itself. It may be safer for those unfamiliar with YML format to use the in game commands. For the rest of you, a semi-colon is used to separate the item id and data/damage info. %d can be used to insert the data value into the item name (added in 1.2.0 to show the map #).
Linking from your Plugin
See this useful linking page: Linking WhatIsIt (javadoc)
@incredinex
Congrats on the baby boy/girl! :D
@incredinex Dev build? WHERE? Link plz. I don't see anything on the guy's github. Also, congrats on babby. :D
Yay! A 1.7 dev build. Boo! Too late to do anything about it and my wife is about to have a kid tomorrow (today?).
The only update is the names file, anyone needing to update real quick just use the link I posted in the last comment. Let me know of any problems or missing entries you see. Love you, thanks, forget to donate (like normal) or don't (that would be great too!).
@SilverBrit
Sorry, on my iphone at the moment. You don't need to compile, just replace your names.yml file with this: https://github.com/incredinex/WhatIsIt/blob/master/src/names.yml
@incredinex
Can you please push out the commit that adds in the 1.7 blocks, I don't feel like compiling it myself, thanks!
@xxtreepuncherxx
Hey, that's awesome. If you want to do me a fav, can you check to make sure all the items are responding properly. I'm so tied down with work and other stuff (wife's about to spit a child out of her vaJJ). Some reason I feel like I probably missed something.
I have an unofficial 1.7.2 with working blocks and this plugin works flawless, thank you so much incredinex!
I know Minecraft 1.7 seems to have been out for a while, but I'm not seeing a bukkit supporting it yet. I'm just waiting to test the plugin before I release a 1.7 capable release.
@incredinex
This is fantastic. I was looking to share my version but yours looks very refined. Thank you!
I think I have all the 1.7 names in, but without a craftbukkit to test with, I can't go any further. Anyone feeling like double checking my update while we wait? https://github.com/incredinex/WhatIsIt/blob/master/src/names.yml
@heavyplay1992
I've never been able to get tekkit to work on my machine. It shouldn't be too hard to make a list of items in tekkit with the item id and data id and put it into the names.yml file as long as tekkit isn't using alternate structures to hold what type of item it is.
Hey incredinex, your plugin is just awesome. but i have one question.
can u make a version for tekkit lite? with all the tekkit lite items?
it will be make u godlike ^^
and if u dont want to do ist then i say only one thing: thanks anyway
@incredinex
Thanks for considering it. MaxHealth, MaxSpeed, and JumpHeight are really the only important attributes to identify on a horse anyhow. The reason being that it's more handy to identify one of those stats as an integer, straight and simple, than to either play around with the horse to get a rough estimate of its stats (which is unreliable) or to use another plugin to do it for you (which is annoying because those plugins tend to be redundant in function).
And take your time, there's no rush obviously. :)
@CommodoreAlpha
The support is for the major horse classes, horse, mule, donkey, etc. I know there's a beta out, but work's been pretty tight. I don't have plans on adding what you're talking about, but I'll think about it.
Would it be possible to have "/wit" display all the extra information about a horse? e.g. Its coat, its speed, its jumpheight, its health, whether it has a chest (this is not always obvious, as horses can have chests, technically), all the other unique information associated with horses, etc.
EDIT: I'm aware of your comment below mine, saying that you'll support horses. I'm wondering, when you do support more specific horse identification, whether you'll include some of the features I mentioned above or not.
I do have logic in place for WhatIsIt version 1.3.7 that distinguishes the major kinds of horse entities, but am waiting for a proper beta to make sure the current structures still exist before I release it.
@EpicPlugins
Vault has something similar to what you're describing in it.
Could you recommend a plugin, or provide the inverse functionality?
I want to create a simple give, and item command for my plugin, without relying on a suite plugin that would provide it along with tons of other shit (Essentials).
Thanks in advance!
Also interested in donating if this could be done. I'll be using this in another plugin anyway, so will donate regardless most likely.
Assuming it's approved, 1.3.6 is ready: http://dev.bukkit.org/bukkit-plugins/whatisit/files/22-1-3-6/
@bebosny
I'm using the standard PluginMetrics addin. Look in the /plugins/PluginMetrics folder to edit its configuration.