Knokko's Custom Items
Note: this plug-in requires a different installation procedure than most other plug-ins. You really need to check the installation section or one of the tutorials.
Description
This plug-in allows the owners and developers of servers to create custom items with their own textures. (It requires a server resource pack.) Everyone who would like to use this plug-in needs to download the Editor and use that to create their own custom item set.
Installation
- Download and run the Editor. Editor.jar can be found in the Files section. If you have a working Java installation, you can just download and double-click this file. If not, you can either install Java or download a native version of the Editor from https://github.com/knokko/custom-items-gradle/releases
- Put this plug-in (CustomItems.jar) in your plug-ins folder
- Configure the items and textures you want (in the Editor)
- Click on the Export... button, and follow the steps (in the Editor)
If you need more detailed information about these steps, you can ask for help on the Discord server.
Discord server
Invite link: https://discordapp.com/invite/bmF3Zvu
New tutorials:
https://www.youtube.com/watch?v=GsC-pNlBjwg
Old basic tutorials:
Text: https://knokko.github.io/custom%20items/index.html
Video: https://www.youtube.com/playlist?list=PLcc-tPs9PuADC-shEBRynL9s2j6slSWCa
Old advanced tutorials:
Custom containers (video): https://knokko.github.io/custom%20items/tutorials/containers/index.html
Wands and guns (text): https://knokko.github.io/custom items/tutorials/wands and guns/index.html
Troubleshooting
If you can, use /kci debug
If that doesn't work, check whether CustomItems is listed in /plugins
Features
-Custom items with their own display name, lore, attribute modifiers and textures
-Custom tools with their own damage and durability
-Custom bows with their own damage, speed and durability
-Custom armor with their own armor value and other attribute modifiers, unfortunately without model texture.
-Crafting recipes that can use vanilla ingredients and custom items (or combined)
-Block & mob drops for custom items
-Custom containers (like a custom furnace, but much more powerful, unfortunately without block texture)
-Custom projectiles with custom wands to launch them
-Custom blocks (but still in beta)
Check the wiki for more information.
Source code (programmers only)
Comments
-
knokko Owner
-
knokko2 Author
-
TechWizzart Contributor
-
View User Profile
-
Send Message
Posted Feb 12, 2020Very cool plug-in. Seems to work pretty darn good in Spigot 1.15.2. However, seems to be a slight problem with custom items stacking properly. Example: I have a custom item called zinc_coin. It is dropped 100% when a zombie is killed. Run over and pick up the drops. No problem so far. However, once your inventory is full....the coin cannot be picked up by standing in close proximity even tho the zinc coin stack in inventory is less than 64. Removing any item from inventory will allow the coin to be picked up. Then you can replace the item you originally removed. Hope that all makes sense. Other than that slight annoyance.....I love this plug-in. Been searching for one like it for a long time. Excellent work Dev! Keep it up.
-
View User Profile
-
Send Message
Posted Feb 13, 2020In reply to amigaman67:
Thank you for reporting this issue, I will try to fix it when I have the chance. I'm also glad you like it!
-
View User Profile
-
Send Message
Posted Feb 6, 2020nice plugin, I love it,
Can I reprint and translate it to a Chinese Forum? I will mark the original link and the author. Don't worry, I won't get any benefit from it, therefore, you can understand the reprint here as a kind of sharing. If there are other conditions, we can talk about it.
www.mcbbs.net (This is largest Minecraft Forum in China)
-
View User Profile
-
Send Message
Posted Feb 6, 2020In reply to aikinitt:
Yes, you can do this, but I won't help you with translating.
Translating just this page won't be very hard (at least if you skip the outdated 'Full editor guide').
This page itself isn't that much to translate, but if you want to translate the work-in-progress documentation and tutorials at https://knokko.github.io/custom%20items/index.html, you will have quite some work to do...
-
View User Profile
-
Send Message
Posted Feb 7, 2020In reply to knokko:
No problem, I can finish it
-
View User Profile
-
Send Message
Posted Mar 25, 2020In reply to aikinitt:
It seems that you haven't done it yet. Can you also give me a permission? I also want to try it. I'm also Chinese（别问我为啥用英语(⊙o⊙））
-
View User Profile
-
Send Message
Posted Mar 26, 2020In reply to like_wind484:
Sure, go ahead.
-
View User Profile
-
Send Message
Posted Feb 5, 2020Hi, sorry for a question again XD
I redownloaded both the plugin (Version 6.2 which you just uploaded) and the latest version of knokko core for minecraft 1.14.4 (uploaded on Sep 2, 2019), using editor version 6.1 (you uploaded it on Jan 12, 2020), this time when I do /customitems list, it showed my item, but when I do /customitems give <item> , it generates an error again:
[12:01:45 INFO]: YFshadaow issued server command: /customitems give rem
[12:01:45 ERROR]: null
org.bukkit.command.CommandException: Unhandled exception executing command 'customitems' in plugin CustomItems v6.2
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:47) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:159) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.dispatchCommand(CraftServer.java:739) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnection.handleCommand(PlayerConnection.java:1804) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnection.a(PlayerConnection.java:1612) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PacketPlayInChat.a(PacketPlayInChat.java:47) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PacketPlayInChat.a(PacketPlayInChat.java:5) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnectionUtils.lambda$ensureMainThread$0(PlayerConnectionUtils.java:23) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.TickTask.run(SourceFile:18) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.executeTask(IAsyncTaskHandler.java:136) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandlerReentrant.executeTask(SourceFile:23) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.executeNext(IAsyncTaskHandler.java:109) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.aX(MinecraftServer.java:1029) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.executeNext(MinecraftServer.java:1022) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.awaitTasks(IAsyncTaskHandler.java:119) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.sleepForTick(MinecraftServer.java:1006) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.run(MinecraftServer.java:929) ~[patched_1.14.4.jar:git-Paper-243]
at java.lang.Thread.run(Thread.java:748) [?:1.8.0_242]
Caused by: java.lang.NoSuchMethodError: nl.knokko.core.plugin.item.attributes.ItemAttributes.createWithAttributes(Ljava/lang/String;I[Lnl/knokko/core/plugin/item/attributes/ItemAttributes$Single;)Lorg/bukkit/inventory/ItemStack;
at nl.knokko.customitems.plugin.set.item.CustomItem.create(CustomItem.java:108) ~[?:?]
at nl.knokko.customitems.plugin.set.item.CustomItem.create(CustomItem.java:118) ~[?:?]
at nl.knokko.customitems.plugin.command.CommandCustomItems.onCommand(CommandCustomItems.java:103) ~[?:?]
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:45) ~[patched_1.14.4.jar:git-Paper-243]
... 17 more
Last time I was also using this version of knokko core, but I could not find any newer versions of knokko core than this(uploaded on Sep 2, 2019). I downloaded knokko core from this website: https://dev.bukkit.org/projects/knokko-core/files
Thank you!
-
View User Profile
-
Send Message
Posted Feb 5, 2020In reply to yfshadaow:
Hi, you should download Knokko Core version 1.14 7 as this is the latest release for Minecraft 1.14. The number behind the 14 is which version of the core it is for that Minecraft version, so it has nothing to do with which subversion of Minecraft 1.14 you are using.
-
View User Profile
-
Send Message
Posted Feb 16, 2020In reply to TechWizzart:
Thank you very much!
-
View User Profile
-
Send Message
Posted Feb 5, 2020Hello!
sorry for my bad English
I have a problem with the helmets:
during the game The texture appears in the helmet icon.
But becomes a diamond helmet again when placed on a player.
Do you have a solution?
My image is in ".png" maybe bad format?
Thank you very much!
-
View User Profile
-
Send Message
Posted Feb 5, 2020In reply to Forge_User_43838905:
Unfortunately, that's just the way it works. Custom helmet textures will probably work in the future, but not now. The other armor pieces won't have custom textures in the currently existing minecraft versions.
-
View User Profile
-
Send Message
Posted Feb 5, 2020In reply to knokko:
In reply to knokko:
OK thx you for your answer
-
View User Profile
-
Send Message
Posted Feb 3, 2020Hello!
I created an item set for my server following the instructions given, but when I tried to do /customeitems list, it says an internal error has occured. Here's the server console log:
[18:49:57 ERROR]: null
org.bukkit.command.CommandException: Cannot execute command 'customitems' in plugin CustomItems v6.1 - plugin is disabled.
at org.bukkit.command.PluginCommand.execute(PluginCommand.java:37) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:159) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.dispatchCommand(CraftServer.java:739) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnection.handleCommand(PlayerConnection.java:1804) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnection.a(PlayerConnection.java:1612) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PacketPlayInChat.a(PacketPlayInChat.java:47) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PacketPlayInChat.a(PacketPlayInChat.java:5) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.PlayerConnectionUtils.lambda$ensureMainThread$0(PlayerConnectionUtils.java:23) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.TickTask.run(SourceFile:18) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.executeTask(IAsyncTaskHandler.java:136) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandlerReentrant.executeTask(SourceFile:23) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.executeNext(IAsyncTaskHandler.java:109) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.aX(MinecraftServer.java:1029) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.executeNext(MinecraftServer.java:1022) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.IAsyncTaskHandler.awaitTasks(IAsyncTaskHandler.java:119) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.sleepForTick(MinecraftServer.java:1006) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.run(MinecraftServer.java:929) ~[patched_1.14.4.jar:git-Paper-243]
at java.lang.Thread.run(Thread.java:748) [?:1.8.0_242]
Thank you!
-
View User Profile
-
Send Message
Posted Feb 3, 2020In reply to yfshadaow:
According to Paper, the plug-in is disabled.
If you don't know why it is disabled, you should send me the beginning of your console, specifically the part where the plug-in is being enabled.
-
View User Profile
-
Send Message
Posted Feb 3, 2020In reply to knokko:
I found this when the server was starting:
[09:27:41 INFO]: [CustomItems] Enabling CustomItems v6.1*
[09:27:41 ERROR]: Error occurred while enabling CustomItems v6.1 (Is it up to date?)
java.lang.NoSuchMethodError: nl.knokko.core.plugin.item.attributes.ItemAttributes.createWithAttributes(Ljava/lang/String;I[Lnl/knokko/core/plugin/item/attributes/ItemAttributes$Single;)Lorg/bukkit/inventory/ItemStack;
at nl.knokko.customitems.plugin.set.item.CustomItem.create(CustomItem.java:108) ~[?:?]
at nl.knokko.customitems.plugin.set.item.CustomItem.create(CustomItem.java:118) ~[?:?]
at nl.knokko.customitems.plugin.set.ItemSet.loadResult(ItemSet.java:1173) ~[?:?]
at nl.knokko.customitems.plugin.set.ItemSet.loadRecipe(ItemSet.java:1134) ~[?:?]
at nl.knokko.customitems.plugin.set.ItemSet.load5(ItemSet.java:185) ~[?:?]
at nl.knokko.customitems.plugin.set.ItemSet.<init>(ItemSet.java:103) ~[?:?]
at nl.knokko.customitems.plugin.CustomItemsPlugin.loadSet(CustomItemsPlugin.java:110) ~[?:?]
at nl.knokko.customitems.plugin.CustomItemsPlugin.loadSet(CustomItemsPlugin.java:164) ~[?:?]
at nl.knokko.customitems.plugin.CustomItemsPlugin.onEnable(CustomItemsPlugin.java:67) ~[?:?]
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:263) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:338) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:420) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.enablePlugin(CraftServer.java:467) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.enablePlugins(CraftServer.java:381) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.a(MinecraftServer.java:474) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.DedicatedServer.init(DedicatedServer.java:290) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.run(MinecraftServer.java:876) ~[patched_1.14.4.jar:git-Paper-243]
at java.lang.Thread.run(Thread.java:748) [?:1.8.0_242]
[09:27:41 INFO]: [CustomItems] Disabling CustomItems v6.1
[09:27:41 ERROR]: Error occurred while disabling CustomItems v6.1 (Is it up to date?)
java.lang.NullPointerException: null
at nl.knokko.customitems.plugin.CustomItemsPlugin.onDisable(CustomItemsPlugin.java:78) ~[?:?]
at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:265) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.java.JavaPluginLoader.disablePlugin(JavaPluginLoader.java:373) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.SimplePluginManager.disablePlugin(SimplePluginManager.java:453) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:342) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:420) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.enablePlugin(CraftServer.java:467) ~[patched_1.14.4.jar:git-Paper-243]
at org.bukkit.craftbukkit.v1_14_R1.CraftServer.enablePlugins(CraftServer.java:381) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.a(MinecraftServer.java:474) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.DedicatedServer.init(DedicatedServer.java:290) ~[patched_1.14.4.jar:git-Paper-243]
at net.minecraft.server.v1_14_R1.MinecraftServer.run(MinecraftServer.java:876) ~[patched_1.14.4.jar:git-Paper-243]
at java.lang.Thread.run(Thread.java:748) [?:1.8.0_242]
Thank you!
-
View User Profile
-
Send Message
Posted Feb 4, 2020In reply to yfshadaow:
It looks like your Knokko Core is either missing or outdated. Please download a newer version.
-
View User Profile
-
Send Message
Posted Jan 11, 2020I made two pickaxes and one of them overwrites the other.
-
View User Profile
-
Send Message
Posted Jan 12, 2020In reply to epicestgamerest:
Overwriting where? In the resourcepack?
Do they have the same internal item type and internal item damage?
-
View User Profile
-
Send Message
Posted Jan 12, 2020In reply to knokko:
It overwrites almost everywhere. I looked at the resource pack and noticed the damage variant. I dont think its the resources fault. The crafting recipe for the second pixckaxe was overwritten by the first, and when I did givetools, the texture for the first pickaxe was on both of them. My best guess is that the durability variable wasnt written to the second pickaxe