Plugin Description §

Welcome to CustomItemAPI

the Plugin allows you to add as many items as you want on your server, you can add new foods, New pickaxes and much more ! A configuration is present for people not having the necessary development skills.

getting started with API

To start development with the API, you need to have some conditions. plugin.yml

name: TestCustomItem
version: 1.0.0
author: you
main: you\test\Main
api: 4.0.0
depend: CustomItemAPI # it is very important !!!

Now that our plugin depends on CustomItemAPI, we can start by creating a basic item.

use pocketmine\item\ItemIdentifier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\BaseItem;


$item = new BaseItem(new ItemIdentifier(1000, 0), 'test', 'test_texture', 64, false);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Armor Creation

use pocketmine\inventory\ArmorInventory;
use pocketmine\item\ArmorTypeInfo;
use pocketmine\item\ItemIdentifier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomArmor;


$item = new CustomArmor(new ItemIdentifier(1000, 0), 'armor_test', new ArmorTypeInfo(5, 100, ArmorInventory::SLOT_HEAD), 'test_texture');
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Food Creation

use pocketmine\item\ItemIdentifier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomFood;

$item = new CustomFood(new ItemIdentifier(1000, 0), 'test_food', 'texture_name', false, 5, 10.00, 64);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Potion Creation

use pocketmine\item\ItemIdentifier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomPotion;

$item = new CustomPotion(new ItemIdentifier(1000, 0), 'test_potion', 'texture_name', true, 5, 10.00, 64); # the animation of the eating will be a potion
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Pickaxe Creation

use pocketmine\item\ItemIdentifier;
use pocketmine\item\ToolTier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomPickaxe;

$item = new CustomPickaxe(new ItemIdentifier(1000, 0), 'test_pickaxe', ToolTier::DIAMOND(), 'texture_path', 4.5, 455, 2);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Shovel Creation

use pocketmine\item\ItemIdentifier;
use pocketmine\item\ToolTier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomShovel;

$item = new CustomShovel(new ItemIdentifier(1000, 0), 'test_shovel', ToolTier::DIAMOND(), 'texture_path', 4.5, 455, 2);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Axe Creation

use pocketmine\item\ItemIdentifier;
use pocketmine\item\ToolTier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomAxe;

$item = new CustomAxe(new ItemIdentifier(1000, 0), 'test_axe', ToolTier::DIAMOND(), 'texture_path', 4.5, 455, 2);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Hoe Creation

use pocketmine\item\ItemIdentifier;
use pocketmine\item\ToolTier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomHoe;

$item = new CustomHoe(new ItemIdentifier(1000, 0), 'test_hoe', ToolTier::DIAMOND(), 'texture_path', 455, 2);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

Sword Creation

use pocketmine\item\ItemIdentifier;
use pocketmine\item\ToolTier;
use refaltor\customitemapi\CustomItemAPI;
use refaltor\customitemapi\items\CustomSword;

$item = new CustomSword(new ItemIdentifier(1000, 0), 'test_sword', ToolTier::DIAMOND(), 'texture_path', 455, 2);
CustomItemAPI::getInstance()->getAPI()->register($item); # the item is set to hold fill and will be register when onEnable().

What's new §

Fix:
- - All Enchants has fix (armor is fixed !)
- - Crash disable by plugin has fixed

Fix: Crash Config disable outdated

Fix:
- - Config update auto

Fix Crach packet null
creative_category
CustomItemAPI::getInstance()
Crash division by zero

Fix compatibility 1.19

fix boots and legs slots

fix tools mining speed
fix food crash
add potion item
fix armor block update

fix enchantable armor (50%)
add lore custom in construct item

Update 2.6.3
- Bugs fix:
- - Armor Slots
- - Duplications with slots
- - Textures NBTs
- Features:
- - Clean code
- - Hammer Items
- - Area for the hoe item

Update 2.6.0
- - Fix armor slots
- - Fix Custom KB and attack cooldown swordItem
- feature:
- - add manager for resource pack

Update ArmorComponents.php

Update fix pickaxe break

Update 2.0.0
- add custom knockback and custom attackCooldown in SwordItem
- Resolution of inconsistencies in HoeItem and ShovelItem classes
- Configuration fix(normally)
add Example ResourcePack in ExampleRS/ in my github

Add example events
Fix Bugs Events (BlockBreakEvent)
Fix minecraft mixture items (now, namespace is "cutom:item_name")

MCBlueGanzz

using v3.3.0

10 Jan 23

how to add texture items? https://github.com/Refaltor77/CustomItemAPI/tree/main/ExampleRS This link is no longer working, so how do I add a texture?

RZ302

using v3.3.0

31 Oct 22

The plugin works great for adding a few custom items without much effort. However, you set the items to numeric IDs in the config, therefore and for some other reasons I'd really appreciate some kind of give-command that works with numeric IDs.