\n
<\/p>\n
<\/p>\n
<\/p>\n
\n<\/p>\n
\n
\n <\/p>\n<\/p>\n
\n
![](\"https:\/\/cdn.modrinth.com\/data\/dw1mp4kD\/images\/0fa5f6a7090dff62370fb5cc3221b07e2af5a0be.png\")
\n <\/p>\n
An API for making custom blocks and items for 1.20+ on paperMC<\/p>\n
## How to use?<\/p>\n
### Data driven blocks and items<\/p>\n
#### Create a ‘pack’ ##### Add items ##### Add blocks #### Use a ‘pack’ ### Add blocks and items with a plugin<\/p>\n #### Custom items example: #### Custom blocks example: ### Features \/ Bugs An API to make your own custom blocks and custom items.<\/p>\n","protected":false},"featured_media":52797,"template":"","meta":{"_minecraft_slug":"custom-item-api","_minecraft_project_id":"dw1mp4kD","_minecraft_author":"Senne","_minecraft_license":"MIT","_minecraft_downloads":1621,"_minecraft_follows":12,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"custom-item-api.zip","_minecraft_size_bytes":825749,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T06:58:25.194219Z","_minecraft_date_created":"2023-08-21T23:18:07.929688Z","_minecraft_date_modified":"2024-05-18T13:09:49.719660Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/custom-item-api","_minecraft_icon_attachment_id":52797,"_minecraft_imported_at":"2026-06-02T22:05:42+00:00","_minecraft_import_hash":"c107468f403cffc78bbbd183e543ed91","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,89,873,127],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,102,62],"class_list":["post-52796","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-game-mechanics","mod_category-library","mod_category-paper","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-6","minecraft_version-1-21"],"yoast_head":"\n
\nTo create custom items and blocks in this way, you will have to create a ‘pack’ similar to a datapack or a resource pack. The file structure of which looks like this:
\n“`
\n–
\n – blocks
\n – default_block
\n – transparent_block
\n – items
\n“`
\nThe namespace of your pack will be what shows before the item id in the give command “`namespace:item_id“`.<\/p>\n
\nTo add an item you just need to create a json and put it in the items folder. The name of the file will become the item id.<\/p>\n
\nTo add a block you need to create a json. If you want it to be a transparent block, you need to put it in the transparent_block folder. It is recommended to use a block that is transparent as the placed_block, otherwise it might look weird. If you want a normal block you put the json in the default_block folder. The name of the file will become the block id, for good practice you should make this id the same as the id of its item but it’s not required.<\/p>\n
\nTo use a ‘pack’ you need to put it in the packs folder, this can be found by going in the plugins folder and then the custom_item_api folder.
\n“`
\n– plugins
\n – Custom_Item_Api
\n\t– packs
\n“`<\/p>\n
\nYou can add a custom item by creating a “`new CustomItem(Material material, NamespacedKey key, Class actions)“`.
\nThis will create the custom item if there isn’t a custom item with this NamespacedKey. The actions define what should happen when the item is clicked, it’s a class that implements “`CustomItemActions“`.
\nYou can change the texture,tags,…
\nIf you want to place a custom block using this item you can add this with CustomItem#setCustomBlock(NamespacedKey)<\/p>\n
\n““java
\nNamespacedKey itemKey = new NamespacedKey(plugin, “example_item”);
\nCustomItem customItem = new CustomItem(Material.FURNACE, itemKey, Class.forName(“org.super_man2006.custom_item_api.utils.items.EmptyCustomItemAction”));
\ncustomItem.setCustomBlock(blockKey);
\ncustomItem.setName(Component.text(“Example”));
\n“““<\/p>\n
\nYou can add a custom item by creating a “`new CustomBlock(Material material, NamespacedKey key, Class actions, Material placedBlock)“`.
\nThis will create the custom item if there isn’t a custom item with this NamespacedKey. The actions define what should happen when the block is placed\/broken\/clicked on, it’s a class that implements “`CustomBlockActions“`.
\nYou can change the texture,tags,…
\nThe block uses an item texture, NOT a block texture. This means that if you set custom model data (cmd) you can change the texture.
\nIf you want to drop a custom item after breaking this block you made with CustomBlock#setDropItem(NamespacedKey)<\/p>\n
\n““java
\nNamespacedKey blockKey = new NamespacedKey(plugin, “example_block”);
\nCustomBlock customBlock = new CustomBlock(Material.FURNACE, blockKey, Class.forName(“org.super_man2006.custom_item_api.utils.blocks.EmptyCustomBlockAction”), Material.STONE);
\ncustomBlock.setRotation(CustomBlock.Rotation.AROUND_Y);
\n“““<\/p>\n
\nIf you find bugs or want a feature to be added, ask in the discord or create an issue on github.<\/p>\n","protected":false},"excerpt":{"rendered":"