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)
does anyone have a complete names.yml file for FTB unleashed 1.5.2? It would be best to have all the mods ids incase someone has them all enabled. if so please post a link here. It would really be helpfull to may people
@incredinex
Thank you!
@adventuretc
Feel free to write whatever plugins you like.
@adventuretc
My names.yml file is based on the information on the Wiki. I don't know if that's the same as what's in the game itself in all cases. I think there are some cases where the game is less specific than is useful in names. The main purpose of this plugin was to power the names for stores and/or auctions (or similar things) which run (from other plugins) by chat command so the names needed to be very specific even if the name Minecraft itself uses isn't exactly what is listed in my plugin.
Also, there are some strange things in names.yml, such as '44;2: Wooden Stone Slab'. I would use en_US.lang as a reference because some name like Oak Log are not used by the original game.
I am writing a plugin for my server that replaces default item names with names from a minecraft .lang file and saves it to names.yml. I think this would be enough for most people and would make a nice feature, what do you think? Can I release a separate plugin that does this?
@Gamerswell
When you hold the item in your hand and type "/wis" is it telling you the same number as what you have in the names.yml file? You might have to turn on display-data-values in the config.yml.
@incredinex
Al right sorry didn't see that, I have done it now, but the items still don't work, I have reloaded the plugins, restarted the server but it won't worked. I have double checked the item id's but nope.
@Gamerswell
You can specify and item id and data id except potions since they work differently.
Same question lol, could you add mod item support?
@ZenDarva
I haven't the foggiest idea.
@Thepom360
That's a good question. I'm not sure. But I'm pretty sure that the answer will be, "yes," when the next version comes out. Maybe someone might convince me otherwise between now and then, but I seriously doubt it.
Does the plugin name have to show?
I put it up on github, the jar file you need is in the top level of the repository, instructions are in the readme.md.
If there was a way to do spoilers, or any other kind of collapsed data, i would post an example names.yml here, but without a spoiler tag it would take up waaaaay too much space.
https:github.com/ZenDarva/listBuilder
The resulting Names.yml does require hand editing, this tool just takes away the vast majority of the drudgework.
@LHammonds
The plant top ones are correct, I believe. http://minecraft.gamepedia.com/Data_values#Large_Flowers it says, " >= 8 Top Half of any Large Plant; low three bits 0x7 are not set to the plant type, they are derived from the block below." Also, in my testing, I've found that the top half of the plant's data does not correspond to what kind of plant it is.
I just uploaded a file that does have the rest of the changes, thanks.
@ZenDarva
That sounds very interesting.
I've just finished writing a Forge plugin, for 1.6.x, that automatically builds the names.yml file for modded servers. Now, it's not perfect, of course, some mod authors don't name their items correctly, etc, and i haven't bothered with getting entity names, I've only got it pulling Items, blocks, and Enchants. If people are interested in this utility, I'll put it up on github, and post a link here.
Thanks for the update. I just downloaded the 1.3.7 update and comparing your new names.yml to my modified one, I see some differences as noted below:
Yours starting @ line #459:
Mine:
Yours @ line #648
Mine:
The following lines are missing from yours:
Thanks,
LHammonds
@fungreenfox
Thanks, I'll take a look at that. There were a lot of items this time.
Found this in the -t large biome world:
162;0: Acacia Wood
174;0: Packed Ice
- there are probably a few more.
@MechaTech84
Thanks, I'll get those in there.
@fungreenfox
That's specifically referring to the "display-data-values" option. It makes the /wis and /wit commands display the data numbers. It doesn't add the data numbers to other plugins that access the names via this Plugin, like floAuction.
Hey flobi. I updated AH, I think you missed the water breathing potions in the most recent names.yml though. They were showing up as cordial and artless potions.