Knokko's Custom Items 9.4

A custom items plug-in with custom textures

  1. knokko
    Native Minecraft Version:
    Legacy (< 1.13)
    Tested Minecraft Versions:
    • 1.12
    • 1.13
    • 1.14
    • 1.15
    • 1.16
    Source Code:
    Note: this plug-in requires more installation work than most other plug-ins. You really need to check the installation section or one of the tutorials.


    This plug-in allows server owners to add custom items with custom textures to their server. A server resourcepack will be used to achieve the custom textures. It will use resourcepack tricks, so no existing minecraft items will be lost.

    This plug-in will provide the following features:
    • Simple custom items that have their own texture, but no big other features. simpleItems.png
    • Custom tools, including swords, pickaxes, bows, shields, and more tools.png
    • Custom armor (but most pieces require Optifine for full functionality) armor.png
    • Custom crafting recipes (can include both regular minecraft items and custom items from this plug-ins) crafting.png
    • Let mobs and blocks drop custom items (or regular items)
    • Wands that can fire custom projectiles
    • Custom containers (some kind of custom crafting station/furnace)
    Basic tutorials
    Text: items/tutorials/basic tools.html

    Advanced tutorials
    Custom containers (video): items/tutorials/containers/index.html

    Discord server

    If you can, use /kci debug
    If that doesn't work, check out items/troubleshooting.html

    Supported minecraft versions
    • Minecraft 1.12.2
    • Minecraft 1.13.2
    • Minecraft 1.14.4
    • Minecraft 1.15.2
    • Minecraft 1.16.4/5
    Minecraft 1.8 and earlier can't be supported, unless everyone has Optifine. Minecraft 1.9 to minecraft 1.11 could be supported, but it wouldn't work for players joining in minecraft 1.8. Besides, it would be quite some work and these versions are very legacy...

    • /customitems damage <amount> [player name] will decrease the remaining durability of the custom tool in the main hand of the target player (the player with name player name) by amount. If the remaining durability is smaller than (or equal to) amount, it will be destroyed. Only players with the customitems.damage permission can use this command.
    • /kci debug looks for installation errors, and sends them back as chat message.
    • /kci encode can be used to use complicated crafting ingredients in custom recipes.
    • /kci give <item name> [player name] [amount] will give a custom item to a player
    • /kci list sends the names of all custom items as a chat message
    • /kci reload will reload the config and items, but not the textures
    • /customitems repair <amount> [player name] will increase the remaining durability of the custom tool in the main hand of the target player (the player with name player name) by amount. This command will not repair the tool beyond the maximum durability (if current durability + amount is larger than the maximum durability, the durability will be set to the maximum durability). Only players with the permission can use this command.
    • /kci setblock <block> [x] [y] [z] [world] will place the given custom block at (x, y, z) in the given world. Only players with the customitems.setblock permission can use this command.
    1. Download and run the Editor.
    2. Configure the items and textures you want.
    3. Click on one of the Export buttons. Open the Custom Item Sets folder on your computer (it should be in your Documents or Home folder, depending on operating system).
    4. Upload the .cis file inside that folder to YourServerFolder/plugins/CustomItems (you might have to create this folder first). If your server host doesn't allow you to upload files, you can use the .txt file in the same directory instead.
    5. Install Knokko Core for the right minecraft version (really, it won't work without this supporting plug-in). Installing this one is easy: just put it in your plugins folder.
    6. Optional: Install ActionBarAPI to display custom tool durability and wand/gun cooldowns. See items/compatibility/positive.html for details.
    7. Put this plug-in in your plugins folder.
    8. The .zip file in the Custom Item Sets folder is the resourcepack you will need. You can ask your players to install it, or make it your server resourcepack (but this can be an annoying task).
    If you need more detailed information about these steps, use one of the tutorials.
    KingStoney, Flak and SnowCutieOwO like this.

Recent Updates

  1. Fix bugs and add experimental support for minecraft 1.17
  2. Bugfixes
  3. Some bugfixes

Recent Reviews

  1. LegoCraftMC
    Version: 9.2
    A plugin that is free and very easy to use, I knew nothing about special items and special models. I learned thanks to this plugin and its editor. Thank you for continuing to develop this plugin. I hope new features come faster. (It would be nice if there were some more features about special blocks.)
  2. Odrag97
    Version: 9.2
    Hi i created an item an emerald pickaxe in the editor but when i put the command /minecraft:give @p stick{KnokkosCustomItems:{Name:pico_esmeralda}} it gives me a normal stick, i need help.
    With the export i have to put it in the plugin folder?
    1. knokko
      Author's Response
      First of all, I would recommend using [/kci give pico_esmeralda] instead of trying with /minecraft:give (the minecraft:give just an example of how you could create custom items with other commands, but isn't very useful on its own). Check the Installation section on this page or the text or video tutorial to see how to install everything you made in the Editor. Check the Troubleshooting section on this page if that doesn't seem to work.
  3. SoyVinagrito
    Version: 9.0
    It doesnt work on my server. Sorry for the bad rating but i cant say anything more.
    1. knokko
      Author's Response
      Did you try to troubleshoot? ( items/troubleshooting.html and/or /kci debug) By the way, please don't use reviews for these things, especially before troubleshooting (from your review, I can't tell whether you did that)
  4. ohfreddie
    Version: 8.9
    perfect.. still in development so there will always be a few issues but for the most part it works great! only plugin for this out there!
  5. Partakith
    Version: 8.6
    I have yet to start this up on my Server. I can already tell you deserve the five stars, while the interface isn't "pretty" It's a diamond. Thank you for the time you spent building and explaining, I'm looking forward to adding items in possibly the least complicated way I've seen so far. While there have been others & I have tested them, I liked them less than this before even running them and then not at all after.
  6. gaugt980131gg2
    Version: 8.6
    Great platform for creating custom items and giving a modded feel to your server, looking forward to see the community create custom packs as this plugin's popularity grows.
  7. 9-Vo1t
    Version: 8.3
    it works! i made a custom texture, added it to the editor, and it works! the editor is really easy to use once you understand it. if you get an error log in console then you got the wrong version of the core