WhatIsIt v1.2.0 Help support development of WhatIsIt: Donate (Total donated to date: 0 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. Download on BukkitDev! 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) 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. Linking from your Plugin See this useful linking page: Linking WhatIsIt (javadoc) Misc
Basically, that argument could be made for most libraries. I mean, one could say that about Vault, which has become quite popular. But before Vault was around, you could still copy/paste multi-economy and multi-permission code into your system. And this is released as a plugin, point being that you can do nearly nothing at all and have easy access to friendly item names. The point of this is to get a good unified friendly item name code out there for easy use and in a manner that can support more than those crappy enum toString() based name generation's that have sadly become quite overused, can be shared between plugins, can be updated easily and can support different languages.
So far, everything's gone smoothly. WhatIsIt has been on Aerial Heights for donators for a while now, no complaints. I've added it to floAuction which I released recently. If anyone else knows of a server with WhatIsIt, I'd be excited to know.
Idk, sorry. I meet so many people online that I gave up a long time ago trying to remember things like this. Maybe we played on the same server at one time.
I updated the title to reflect the most recent version I've tested this in. I haven't found any need to actually update it since I released it yet. Once the new items come out that @Dinnerbone's been cramming 1.3 with, I'll have to update for those. But unless something gets removed from Bukkit, this should keep working indefinitely. I'll plan on testing with R4 when I get home.
I am actually really surprised I haven't had to edit this one. I've been using it with floAuction and the whole time I haven't had one error with WhatIsIt myself. I did update my test environment and it's running good, so I can put 1.2.5-R4 in the title . Seriously, no one having any errors at all?
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.
You guys are weird. 77 servers (according to mcstats.org) and no one has anything to say for nearly a month?
We peaked at 100 servers yesterday on mcstats.org! Don't forget to grab floAuction and GoldIsMoney for your servers too guys.
I'm looking forward to MC 1.4. Just like with 1.3, I'm gonna try to get this updated as fast as I can for you guys when 1.4 comes out. It'll probably be v1.1.1 of WhatIsIt that's 1.4 compatible. From the looks of things, you should be able to just update your names.yml though, if you like.
NOTES ON MINECRAFT 1.4: I have uploaded a new names.yml file for 1.4. As far as I can tell, there should be no other necessary updates for 1.4, but until I can test with Bukkit, I'm not releasing an official update to WhatIsIt.jar.
