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)
@MrREOM
Honestly, I don't have the time to do something like that. I appreciate the idea though.
1.3.4 has the 1.5.0 items. I think I added all of them, let me know if I missed anything.
Do you think you can make it compatible with essentials so for example when a person has a nickname it will show that nickname instead of the players full in game name?
@xxtreepuncherxx Thank you, good sir!
IF only there was an easy way to import/export my customised itemid's there's no easy way of merging really is there ? (nudge nudge , separate main and custom configs for next update )
Added new items to names.yml
http://pastebin.com/udndzxCH
@davidp5118
Thank you for your praise and I'm so happy you like this plugin. For the most part, it probably will work, but obviously it won't have the names for the new items till I get a chance to add them...but good news, any server using this can add the names themselves if I am not fast enough for them (unlike many hardcoded item name plugins).
I'm a bit overloaded at my jobs so there might be a tad of a delay once I find out 1.5 is out, but I do take pull requests if anyone wants to help me out :).
This is such an awesome plugin, and i recommend it to anyone who owns a server, its vital!
My server loves it and depends on it, thank you.
Will the current version work with 1.5?
@ContenderCraft
I got the names from the wiki data values page. If you send a list of which ones you think should be changed, I'll take a look out of it.
@deaddude22
You can use this plugin in alias with this plugin and it will allow you to place those specific spawners etc, i'm using it right now.
> http://dev.bukkit.org/server-mods/spawner/A bunch of blocks have incorrect names or different capitalization on words. like most have upper case at start of each word, some have it where the second word is not upper case.
@deaddude22
You'll need a plugin designed to let you do that, deaddude22. This one doesn't do that.
@ohjays
That sounds like a reasonable idea, but honestly I'm so slammed with both my jobs, I'm not going to even pretend to have time for plugin development. At the moment, I'm just hoping I don't have to do too much when the next release comes out.
How come i spawn a specific spawner.
Like a zombie spawner? Also to be able to place it on the ground because when i place any spawner (52:50-100) it will just place down the basic pig spawner.
Would it be possible to extend this to load additional custom yml files just so they can be easily separated. Im running mcpc-plus 1.4.7 and am adding stuff for forestry/railcraft/traincraft/ic2 for instance.
perhaps an additional subfolder we can drop custom names in ?. instead of modifying the original. gets a bit messy and easy to mess up after a while. ie allow for custom1_names.yml, custom2_names.yml sort of thing.
Great plugin very handy
@joshwenke
WhatIsIt doesn't return the display name. floAuction must be getting that on it's own.
How to remove named items? Like in floAuction if someone names an item, how to show just the item name and not the special text they name it as?
German names.yml: names.yml 95% :)
Okay, so I missed one.
Technically no code update is needed for 1.4.6. Just add this to the items section of names.yml.
I'll get a new jar file out today that will do this for you too.
EDIT: Sorry for the delay. I was working on the floAuction issues which were causing item data loss. Here's an update that will automatically fill in your names.yml for you: http://dev.bukkit.org/server-mods/whatisit/files/18-1-3-2/
Anyone on the 1.4.5 R 1.0, download the new 1.3.1.