Shulkers Plugin Documentation

API Features

• Robust manipulation of Shulker Box items and blocks - See list of methods available below
• Color management for Shulker Boxes (both ItemStack and Block)
• Allows easy management of Shulker Box ItemStacks, Item Entity's and Blocks
• Custom Events which can be listened to and cancelled
  
  
• These features allow other plugins to create previews of the contents of Shulker Boxes, modify them, create tools to moderate them, or even create new Shulker Boxes with specific items

Basic Usage

Check if an item is a Shulker Box:

if (ShulkersAPI.isShulkerBoxItemStack(item)) {
    // it's a valid shulker box - do something with the Shulker Box
}

Read contents:

ItemStack[] contents = ShulkersAPI.getContents(shulkerItem);

Set contents:

ItemStack[] contents = new ItemStack[27];
contents[0] = new ItemStack(Material.DIAMOND_SWORD);
contents[1] = new ItemStack(Material.APPLE, 5);

ItemStack updated = ShulkersAPI.setContents(shulkerItem, contents);

Usage of API Example

@EventHandler
public void on(PlayerInteractEvent event) {
    Player player = event.getPlayer();
    ItemStack hand = player.getItemInHand();

    if (event.getAction() != Action.RIGHT_CLICK_AIR) return;
    if (!ShulkersAPI.isShulkerBoxItemStack(hand)) return;

    ItemStack[] contents = ShulkersAPI.getContents(hand);
    Inventory preview = Bukkit.createInventory(new ShulkerInventoryHolder, 27,
        hand.getItemMeta().getDisplayName() + ChatColor.RESET + " Preview");

    preview.setContents(contents);
    player.openInventory(preview);
}