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 pasting it into the main one, to see how it works
- Go crazy and make your own language pack
Configuration
Config | Default | Ranges | Description |
---|---|---|---|
autoupdate | true | [true/false] | Will remind you when a new version is available |
pack.<itemid>.<data>.name | Any string | Will rename itemid:data to your string | |
pack.<itemid>.all.name | Any string | Will rename all itemid data values to your string | |
pack.<itemid>.other.name | Any string | Will rename all unset itemid data values to your string | |
pack.<itemid>.<data>.lore | Any string | Will add your lore list to itemid:data | |
pack.<itemid>.all.lore | Any string | Will add your lore list to all itemid data values | |
pack.<itemid>.other.lore | Any string | Will add your lore list to all unset itemid data values |
- Note: place lore in [square brackets] OR on seperate lines starting with a dash - (see examples)
Commands
/ItemRenamer config <set/get/reload> [variable] [value] — adjust config values in-game, or reload changes from disk
/ItemRenamer update — download newest version of the plugin, and automatically replace the jar on next restart
Ex:
- /ItemRenamer config set pack.35.5.name "&aLime"
- /ItemRenamer config set pack.354.0.name Jaffa Cake
- /ItemRenamer config set pack.354.0.lore [first line, "second line, with a comma", "&2colorful: third line"]
All commands default to OP, but also have permissions.
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
- This plugin doesn't actually edit any items, they just appear renamed .. if you were to suddenly stop using this plugin all items will go back to normal
- If a player renames an item in an anvil, that name will 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
TODO / Known bugs
- Allow more than 1 pack running at the same time, for per world support or permissions based
- If using version 1.2.0016+, you need ProtocolLib 1.8.4
Sourcecode
I've included the .java files inside every jar download, or access it via github:
https://github.com/meiskam/ItemRenamer
Changelog
- Adds ItemMeta, removes CraftBukkit dependency
- Changed color code character from § to &
- Bugfix: ingame editing of name and lore is now possible
- Initial release
Donate
If you liked this plugin and want to contribute to my welfare, feel free to send what ever you think is fair.