Knokko’s Custom Items

Note: this plug-in requires more installation work than most other plug-ins. Read the tutorial or the installation section below for more info about this.

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.

Discord server

Invite link: https://discordapp.com/invite/bmF3Zvu

Basic tutorials:

Text: https://knokko.github.io/custom%20items/index.html

Video: https://www.youtube.com/playlist?list=PLcc-tPs9PuADC-shEBRynL9s2j6slSWCa

Advanced tutorials:

Custom containers (video): https://knokko.github.io/custom%20items/tutorials/containers/index.html

Troubleshooting

If you can, use /kci debug

If that doesn't work, check out https://knokko.github.io/custom items/troubleshooting.html

Supported minecraft server versions

Minecraft 1.8.x and earlier: impossible to support (at least without mods)

Minecraft 1.9.x, 1.10.x and 1.11.x: not supported, but could be if there would be enough interest

Minecraft 1.12.2: supported

Minecraft 1.13.2: supported

Minecraft 1.14.4: supported

Minecraft 1.15.2: supported, but misses custom tridents

Minecraft 1.16.4: supported, but misses custom tridents

Minecraft 1.16.5: supported, but misses custom tridents

Minecraft 1.17.x and later: didn't exist at the time of writing this

Notes when using alongside ViaRewind

Players will only be able to see the right textures, if the resourcepack format of their client version is the same as the resourcepack format of the server version. The following versions use the same resourcepack format:

Minecraft 1.8 and earlier (Note: this resourcepack format misses required features and therefor can't be supported)

Minecraft 1.9 to minecraft 1.12 (Note: even though this plug-in can't be used on servers with minecraft 1.11 or earlier, players from minecraft 1.9 to 1.11 may be able to join and see custom textures if you use a minecraft 1.12 server)

Minecraft 1.13 and minecraft 1.14

Minecraft 1.15 and minecraft 1.16

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)

Commands

/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.

/customitems debug will let the plug-in do check for installation problems and send the results in the chat to the player who executed the command. Note that this command will not work if the installation is too bad. Only players with the customitems.debug permission can use this command. Note: if you use a big server resourcepack, this command can freeze the server for multiple seconds, so anyone with this command has the power to freeze the server by repeatedly using this command.

/customitems encode will create a text representation of the item in the main hand of the command executor and put that in the server console. This can be used for complex crafting ingredients in the Editor. Only players with the customitems.encode permission can use this command.

/customitems give <item name> [player name] [amount] to give the custom item with that name to the player with the given name (by default the player that executes the command). Only players with the customitems.give permission can use this command.

/customitems list sends the names of all custom items to the player who executed the command. This can be nice for testing or when you forgot the name of a custom item. Only players with the customitems.list permission can use this command.

/customitems reload will reload the config.yml and the current .cis file (or .txt file). Only players with the customitems.reload permission can use this command.

/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 customitems.repair permission can use this command.

/customitems setblock <custom block> [x] [y] [z] [world] will place a custom_block at location (x, y, z) in world. Only players with the permission customitems.setblock can use this command.

Editor

Installation

• This plug-in requires Knokko Core, so you need to install that plug-in. The latest version of this plug-in usually requires the latest version of Knokko Core (for the right minecraft version). This plug-in simply won't work without it.
• Optional: Install the ActionBarAPI plug-in if you would like to display custom tool durabilities and wand/gun cooldowns. See https://knokko.github.io/custom items/compatibility/positive.html
• For each supported minecraft version, there is a separate 'Export for …' button in the editor. It's important that you use the right button for the minecraft version you would like to use this plug-in on.
• Download the plug-in from the Files section and put it in YOUR_SERVER_PATH/plugins
• Create your own item set as explained in the Editor section. The plug-in can't do anything if you haven't made your own item set.
• Make sure the server resourcepack is online and accessible and that the NAME.cis is in YOUR_SERVER_PATH/plugins/CustomItems (See Editor)

Source code (programmers only)

https://github.com/knokko/Custom-Items

Похожие моды

ColoursList UnicodeText Warp EasySetSpawn Reputation FarmENGINE HarvesterHoePremium DeadChest