Item Renamer

Example ItemRenamer items

Tired of blocks called Sand? Want your enderpearls to say Grenade instead? Want to add extra lines of text below item names? Do all that and more with ItemRenamer. You can create your own custom item names for all items in your server, but still let users rename with an anvil. You can create your very own language pack!

Installation

  • Download ProtocolLib and put it in your plugins folder
  • Place ItemRenamer.jar in your plugins folder, on server start the configuration will be generated
  • Test out the example config by setting your world to run the example pack, to see how it works
  • Go crazy and make your own language pack

Developer Build

Development builds of this project can be acquired at the provided continuous integration server.
These builds have not been approved by the BukkitDev staff. Use them at your own risk.
Jenkins server

For developers

ItemRenamer 2.0.0 contains a fully-fledged API. Click here for more information.

Configuration

Default configuration can be found here.

ConfigDefaultRangesDescription
autoupdatetrue[true/false]Will remind you when a new version is available
creativedisabletrue[true/false]Will disable ItemRenamer while you're in creative mode
worlds.<worldname>Pack nameWill set this world to run the pack you put here
packs.<packname>.<itemid>.<data>.nameAny stringWill rename itemid:data to your string
packs.<packname>.<itemid>.all.nameAny stringWill rename all itemid data values to your string
packs.<packname>.<itemid>.other.nameAny stringWill rename all unset itemid data values to your string
packs.<packname>.<itemid>.<data>.nameAny stringWill add your name to itemid:data
packs.<packname>.<itemid>.<data>.loreAny stringWill add your lore list to itemid:data
packs.<packname>.<itemid>.<first>-<last>.nameAny stringWill add your name to every itemid with a data value of the give range.
packs.<packname>.<itemid>.<first>-<last>.loreAny stringWill add your lore list to every itemid with a data value of the give range.
packs.<packname>.<itemid>.all.loreAny stringWill add your lore list to all itemid data values
packs.<packname>.<itemid>.other.loreAny stringWill add your lore list to all unset itemid data values
  • Note: place lore in [square brackets] OR on seperate lines starting with a dash -

Player-specific packs

If you want to customize the renamer pack for a specific group of players, regardless of world, you may use the player info itempack along with the desired renamer pack. This feature requires Vault and a permission/chat plugins that supports player info.

This can be done as follows with PermissionEx:

users:
  Player:
    group:
     - Members
    options:
      itempack: none

Usage

It's possible to configure ItemRenamer without ever having to touch the configuration file or deal with the more complicated (but powerful) commands. Simply select an item you want to rename, and type the following:

/renamer select hand

That will select your current item's ID and durability (except for armor and tools), along with any enchantments, potion/fireworks effect, etc. Then use set name and add lore to rename the item and every other like it on the server:

/renamer set name Nameless Tool
/renamer add lore Unknown Artifact

This will automatically be applied to the current world you're in. Use "renamer set pack" to apply it to a different item pack, or teleport to the world with the item pack you want to rename.

Commands

  • Change whether or not to automatically check for updates:
    /renamer set setting autoupdate [true|false]
  • Get what item pack has been assigned to a particular world:
    /renamer get world [world_name]
  • Assign an item pack to the given world:
    /renamer set world [world_name] [pack_name]
  • Add a new item pack:
    /renamer add pack [pack_name]
  • Delete an item pack:
    /renamer delete pack [pack_name]
  • Select a item pack to use for all subsequent commands:
    /renamer select pack [pack_name]
  • Rename all items similar to the one the player currently is holding:
    /renamer select hand
  • Deselect the current item pack, going back to manually typing it:
    /renamer select none
  • Get the rename rule for a particular item:
    /renamer get item [pack_name] [itemID] [all|other|0-32767]
  • Set the name of an item(s) matching a single or multiple damage values:
    /renamer set name [pack_name] [itemID] [all|other|0-32767] [0-32767] [name (with spaces)]
  • Add a new lore line to an item(s) matching a single or multiple damage values:
    /renamer add lore [pack_name] [itemID] [all|other|0-32767] [0-32767] [lore (with spaces)]
  • Remove all the existing lores for a particular set of items:
    /renamer delete lore [pack_name] [itemID] [all|other|0-32767] [0-32767]
  • Add a new enchantment to a set of items: /renamer add enchantment [pack_name] [itemID] [all|other|0-32767] [0-32767] [enchantment_name] [level]
  • Remove an existing enchantment for a set of items: /renamer remove enchantment [pack_name] [itemID] [all|other|0-32767] [0-32767] [enchantment_name] [level]
  • Reload configuration:
    /renamer reload
  • Save configuration now instead of during server shutdown:
    /renamer save

All commands default to OP, but also have permissions.

Modify enchantments

It is also possible to add or remove existing enchantments to any given item. The easiest method is to mark the item you want to modify in your hotbar, and type the following command:

/renamer select hand
/renamer add enchantment NO_ATTRIBUTES 1

Every vanilla enchantment is supported:

  • Bow: POWER, PUNCH, INFINITY, FLAME
  • Weapon: SHARPNESS, BANE_OF_ARTHROPODS, SMITE, FIRE_ASPECT, KNOCKBACK, LOOTING, UNBREAKING
  • Tool: FORTUNE, EFFICIENCY, UNBREAKING, SILK_TOUCH
  • Armor: RESPIRATION, PROTECTION, BLAST_PROTECTION, FEATHER_FALLING, FIRE_PROTECTION, PROJECTILE_PROTECTION, THORNS, AQUA_AFFINITY

There's also three custom enchantments:

  • GLOW 1: Preserve the enchantment glow with no visible enchantment name
  • NO_ATTRIBUTES 1: Remove all the attribute lines introduced in 1.6.1 and 1.6.2.
  • NO_DURABILITY 0: Remove any visible durability on the item. Switch out 0 with any other number to force a durability value.

Permissions

itemrenamer.config.get — read-only access to configs
itemrenamer.config.set — can edit configs or reload from disk
itemrenamer.update — gets a notification when update is ready, and can use update command

Notes

  • Join us on irc at: irc://esper.net/ItemRenamer
  • Items in the creative menu are only client-side, and thus cannot be renamed by this plugin. But creative players will see their items renamed in the main inventory bar.
  • This plugin doesn't actually edit any items, they just appear renamed .. if you were to suddenly stop using this plugin all items should go back to normal
  • If a player renames an item in an anvil, that name should take precedence over the ItemRenamer one
  • When setting lore in game make sure to wrap the text in square brackets, each line separated by a comma, and enclosed in quotes if it contains special characters

Sourcecode

Access the source code via GitHub:
https://github.com/meiskam/ItemRenamer

Donate

Donate

Metrics

MCStats Plugin Metrics for Item Renamer

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of CommodoreAlpha CommodoreAlpha Oct 19, 2014 at 23:34 UTC - 0 likes

    @meiskam: Go

    No, I mean the newer lore, like "Attack Damage +4".

    It can be removed via command - as depicted in an example above - but I want to directly edit the config file. In other words, what tag do I use to tell the plugin to "erase" the vanilla lore?

    Sure, I'd love to include my server IP here. But it's under construction, and I wouldn't want to get sued for players wandering inside and getting hit by a random beam of steel floating about. And no, I doubt plugins would make very good lawyers either. I've never seen a plugin that forced you to sign a contract do so well.

  • Avatar of meiskam meiskam Oct 19, 2014 at 21:39 UTC - 0 likes

    @Leeman1234: Go
    @BrvtvsC: Go
    @Bobacadodl: Go

    Are you guys using "ProtocolLib - Spigot Hack 1.8", or an older version?

    @CommodoreAlpha: Go

    Such as the music disk lore? I don't think that can be removed without a client-side mod.

    Last edited Oct 19, 2014 by meiskam

    BFAK:meiskam,74919,2d6c5de1b19d7aabc1fb74542e178ac033f9e170a90b33ea1616af55a9476d26

  • Avatar of CommodoreAlpha CommodoreAlpha Oct 17, 2014 at 22:04 UTC - 0 likes

    I'm not a fan of using commands to edit the config, so I was wondering how one would go about configuring an item to not display any vanilla attribute text.

  • Avatar of Shado47 Shado47 Oct 07, 2014 at 09:58 UTC - 0 likes

    Item Renamer correctly starts up for me and sets up its config. But as soon as I start to edit it, the config wont load anymore. I compared to the generated config multiple times. The entire form is 100% correct.

    Leader of Team Melanistic, the worlds biggest Minecraft coding team! Mods, Plugins, Tools and more! RECRUITING PLUGIN CODERS!

  • Avatar of Bobacadodl Bobacadodl Sep 13, 2014 at 14:19 UTC - 0 likes

    @Leeman1234: Go

    Same problem here. Please fix it! :)

    Plugin dev || Server owner

  • Avatar of BrvtvsC BrvtvsC Sep 09, 2014 at 17:21 UTC - 1 like

    @Leeman1234: Go

    I have this same problem.

  • Avatar of Leeman1234 Leeman1234 Sep 02, 2014 at 19:19 UTC - 1 like

    With newest dev built Spigot and ItemRenamer.. When I try to join as 1.8 client [works as 1.7 client though]

    http://puu.sh/bixxq/0b5c4a11a2.png

    No error in console. No Idea what may cause it.

    BFAK:78177,59ab2b8281744488746acca012c78b06193ee7bf41aa222a61fee821fe2117bc

  • Avatar of aadnk aadnk Sep 02, 2014 at 00:50 UTC - 0 likes

    @pilvimaa: Go

    Interesting. Looks like a concurrency issue.

    I haven't been able to reproduce it myself, but I believe this should fix it. You can find the updated version on my Jenkins server.

  • Avatar of Superboop Superboop Aug 30, 2014 at 14:30 UTC - 0 likes

    The stackrestrictor option no longer works for 1.7.9-R02 (current beta build). All renamed items are joining into one stack.

    Last edited Aug 30, 2014 by Superboop
  • Avatar of pilvimaa pilvimaa Aug 18, 2014 at 18:17 UTC - 0 likes

    Dev build 22 caused constant disconnects on Spigot 1.7.10 build 1609.

    Reverting back to build 20 fixed the problem.

    The client error message was something about too many bytes of information in some package. I'm sorry but I could not find the error message. It seems my client has stopped writing logs a month ago for some reason and there was nothing relevant in server logs.

    But I could find this. Possibly related, from server logs:

    http:pastebin.com/5763JCpi

Facts

Date created
Nov 06, 2012
Categories
Last update
Dec 22, 2013
Development stage
Release
License
MPL-2.0
Curse link
Item Renamer
Downloads
25,544
Recent files

Authors

Relationships

Required dependency
ProtocolLib