ItemAPI is plugin which allows you to create custom items, handle clicks with them and do things like that easily. It features:
- Easy to use API for creating and modifying your own custom items
- A test item (/testitem)
- NBT and attribute libraries by aadnk
- Some other useful utilies by me
Frequently Asked Questions
Read these answers before asking anything.
Q: Why to use ItemAPI? Can't I just edit item's name and make my own listeners for clicks?
Of course, you can do everything from scratch, but using ItemAPI is easier. With it you don't need to do these things (yes, ItemAPI allows you cerate event which is only called when player does click/attack with the specified custom item).
Q: How it works?
ItemAPI stores data to vanilla Minecraft items, and then changes what happens when player uses them. It also contains tools for adding custom data to items and editing ItemAPI stores data to vanilla Minecraft items, and then changes what happens when player uses them. It also contains tools for adding custom data to items and editing attributes.
Q: Is it ready for use?
Yes, but some features are untested and most undocumented (there is only tutorial for absolute beginners). The code is, however, well-commented so you can learn so you can learn from it if you really want.
Why the version is 2.00 if this isn't even stable?
I have myself used ItemAPI for months now. It isn't very stable, but I know which things work and which not. And actually, there was 1.00 version (now it is legacy code).
Q: IT DON'T WORK!
This isn't actually question, but there is some common reasons for crashes:
- Too old Java; ItemAPI is compiled with Java 7
- Too old CraftBukkit; ItemAPI's NBT library requires Minecraft 1.7
- Corrupted jar file
If you think the reason isn't any of above, send report to issue tracker in Github with full server log.
Source code
Source code and all developer documentation (when I write it...) is avaintable in Github.