API for Developers

Maven Dependency

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.yourusername</groupId>
    <artifactId>DKCommandItems</artifactId>
    <version>1.2.0</version>
</dependency>

Getting Plugin Instance

Dkcommanditems plugin = Dkcommanditems.getInstance();

Creating Custom Items Programmatically

ItemManager itemManager = plugin.getItemManager();

// Create item with custom display name
ItemStack baseItem = new ItemStack(Material.DIAMOND);
ItemMeta meta = baseItem.getItemMeta();
meta.setDisplayName("§6§lLegendary Sword");
baseItem.setItemMeta(meta);

List<String> commands = Arrays.asList(
    "give %player% diamond 1",
    "title %player% title {\"text\":\"Reward!\",\"color\":\"gold\"}"
);

itemManager.saveItem("MyItem", baseItem, commands, true); // true = single use

Checking if Item is Custom

ItemStack item = player.getInventory().getItemInMainHand();

if (itemManager.isCustomItem(item)) {
    String itemName = itemManager.getCustomItemName(item);
    CustomItem customItem = itemManager.getCustomItem(itemName);
    
    // Do something with the custom item
}

Getting All Custom Items

Set<String> itemNames = itemManager.getItemNames();

for (String name : itemNames) {
    CustomItem item = itemManager.getCustomItem(name);
    // Process each item
}

Events

@EventHandler
public void onItemUse(PlayerInteractEvent event) {
    ItemStack item = event.getItem();
    
    if (itemManager.isCustomItem(item)) {
        String itemName = itemManager.getCustomItemName(item);
        // Custom logic here
    }
}