Custom Items

The custom item API is pretty short because it doesn't really need to be very complex.

There's a Bukkit Service Manager for registering per item events, or you can just access the static field at AsynCore#itemEventManager, here you can register custom events, there are docs in the source and it's pretty self-explanatory

Unlike the Block API, all events for items are done via direct access and interfaces, this is because items are usually not as complicated as blocks, so there's not really a reason to make its own mini-event system.

When an event is called, the ItemStack is grabbed from its transformer and is searched for the byte array NBT tag asyncore.object_data, then the object is deserialized and the event is invoked on the object after the event is passed, the object is reserialized, and saved in the nbt of the item stack in asyncore.object_data

public class MyItem implements CanInteractWith {
   @Override
   public void interact(PlayerInteractEvent event) {
      event.getPlayer().sendMessage("hi!");
   }

   @Override // you should never call this method, only implement it
   public ItemStack createBaseStack() { 
      // this is the *default* itemstack for the item, so when you want to give a custom item to a player, CustomItemFactory will use this method and add the nessesary NBT
	ItemStack stack = new ItemStack(Material.DIAMOND);
	stack.addUnsafeEnchantment(Enchantment.DURABILITY, 10);
	return stack;
   }
   
   ... serialization and deserialization methods we went over this in "Persistence and you", if you haven't read that page yet, I suggest you do it now ...
}

There's no registering for this other than registering the persistent

Creating Custom Items

Great, now put it in the world, to get an ItemStack from your custom item, you can use the CustomEventFactory class for all your needs