WhatIsIt Plugin: Friendly Names for Minecraft Items and Mobs

What Is the WhatIsIt Plugin for Minecraft Servers?

Running a Minecraft server often means juggling dozens of plugins that need to display item, block, or entity names in a friendly, readable way. Auction houses, trading systems, and custom economy plugins all depend on accurate, human-readable names. The WhatIsIt plugin steps in as a lightweight library and command tool that fills this exact gap. It provides a centralized, customizable dictionary of friendly names for items, blocks, entities, and enchantments, making it a must-have foundation for any server that values clear communication.

Key Features That Make WhatIsIt Stand Out

WhatIsIt isn’t just another name-lookup utility. It’s designed to be a developer-friendly library and a server admin’s toy all at once. Here’s what you get right out of the box:

• Centralized names.yml database – All friendly names live in a single YML file, separated by type (items, blocks, entities, enchantments). This makes language translation and custom item support effortless.
• Easy public API for developers – Other plugins can call WhatIsIt’s static methods to retrieve a clean name without reinventing the wheel. Integration is fast and painless.
• Monster spawner support – Since version 1.0.2, the plugin can display the mob type stored in a spawner block’s data, which pairs beautifully with spawner drop plugins.
• Data value display toggle – Admins can choose whether to show the numeric data/damage value alongside the friendly name, all controlled via a simple config option.
• In-game editing commands – You don’t need to fiddle with YML syntax if you’re not comfortable. Use /wis itis or /wit itis to set a name and save it directly.
• Vault and SuperPerms support – Permissions integrate with any major permissions plugin, with a fallback to Bukkit’s built-in system when Vault isn’t present.

Commands and Permissions at a Glance

WhatIsIt ships with two sets of commands, neatly separated by permission nodes. Regular users with whatisit.use can query names, while admins with whatisit.admin can edit and reload the name database.

User Commands

• /wis – “What is this?” Displays the friendly name of the item you’re holding.
• /wit – “What is that?” Shows the friendly name of the entity or block you’re looking at.

Admin Commands

• /wis itis [name] – Sets a custom name for the held item and saves it to names.yml.
• /wit itis [name] – Sets a custom name for the targeted block or entity.
• /wis reload and /wit reload – Reload the names.yml file on the fly without restarting the server.

Both permission nodes default to operators, so you can lock down or grant access as needed. Keep in mind that these permissions only control the commands; other plugins that use WhatIsIt’s library functions are not affected by them.

Configuration Made Simple

After installation, two configuration files appear in the /plugins/WhatIsIt/ folder. The config.yml handles display options and message customization. The only toggle is display-data-values, which when set to true (the default) appends the numeric data value in parentheses to the name. Every other message in the plugin’s output can be edited in the messages section — from the prefix to the exact phrasing of “You are holding” or “You are looking at.”

The names.yml file is the heart of the plugin. It organizes name mappings by type, using a semicolon to separate the item ID and its data/damage value. A special %d placeholder can even insert the data value directly into the name string, perfect for showing map numbers or custom item variants. You can edit this file manually or use the in-game admin commands to avoid YML formatting headaches.

Seamless Integration for Developers

WhatIsIt was built with other plugin authors in mind. The static methods are publicly accessible, so integrating friendly name lookups into your own auction, trade, or info plugin takes just a few lines of code. The javadoc documentation outlines exactly how to link your project to WhatIsIt, ensuring that any item, block, or entity can be presented with a polished name without duplicating effort. For server owners, this means a more consistent experience across every plugin that taps into the library.

Getting WhatIsIt up and running is refreshingly straightforward. Drop the JAR into your server’s plugins folder, restart, and the config files generate automatically. For those who prefer a more visual approach to managing mods and plugins, you can easily install WhatIsIt via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. This way, you keep your server setup tidy without manually moving files around, and you can browse additional tools that complement your configuration.

Why Every Server Admin Should Consider WhatIsIt

The plugin fills a niche that many server setups overlook until it’s too late. Without a unified naming system, items with custom data values often show up as raw IDs or cryptic strings in chat, breaking immersion and confusing players. WhatIsIt solves this elegantly by letting you define exactly how every in-game object should be named. It’s lightweight, open to customization, and plays nicely with the rest of your plugin ecosystem. The addition of spawner type recognition and the ability to reload names on the fly makes it a tool that grows with your server.

Whether you’re building a massive economy network or a cozy survival world, clear item names improve trading, auctions, and general interaction. With a supportive permission system, easy YML editing, and a developer-friendly API, WhatIsIt earns its place as a foundational library. There’s even a demonstration video on YouTube that walks through its features if you want to see it in action before diving in.

Conclusion

WhatIsIt transforms the way your server handles item, block, and entity names. By centralizing friendly names into an editable YML file and offering simple commands for both users and admins, it removes the friction of unrecognized IDs and data values. The plugin’s true strength lies in its dual role as a standalone utility and a library that other plugins can rely on, making it a quiet but powerful asset behind the scenes. If you’re tired of seeing “minecraft:stone” in your auction listings or want to give custom items the names they deserve, WhatIsIt is the straightforward, no-fuss solution your server has been missing.