Skip to content
Domenico edited this page Mar 29, 2024 · 73 revisions

Download Custom Items for 10% off on Polymart: https://polymart.org/resource/custom-items.1. Use the coupon code POLYMART to get 10% off!

CustomItems adds completely new items to the game without replacing any normal items

CustomItems Item Marketplace: https://cui.polymart.org

Overview

CustomItems is an amazing plugin that is easy to use. This plugin allows you to add custom items and blocks with new textures to your Minecraft server also you can add custom recipes and trigger actions for your custom items and Minecraft items. CustomItems even hooks into Skript, so you can write your own Skripts to run when players do something with your item! This plugin has a GUI for creating and editing items and their actions.

Tutorial Videos

tutorial videos by @Brickgard (if you don't want to use the GUI): https://www.youtube.com/playlist?list=PLlfRkPeBRr31l0tjwgNbrjVq5b0CR5OtI. They go in-depth about how to directly edit item .yml files!

tutorial videos by @Nathan (if you do or don't want to use the GUI): https://www.youtube.com/playlist?list=PLrIVdw3Zc45neCLJ0iLKguF5SrqaIXx0b.

Discord

Click here to join the Custom Items Discord server

Editing the wiki

You can edit the wiki! To do so, first sign up for a GitHub account if you don't already have one. Then, just click the "edit" button on the top right of any wiki page! Please don't change information unless you know what ever your writing is correct.

Getting Started

To get started with CustomItems you should try the GUI, run the command /cui create myItemNameHere to open up a GUI and create your first item!

You can also edit files directly using yml files, which is more complex but is more powerful for experienced users. If you want to dive into yml files, this wiki has all of the information you should need!

We also recommend you take a look at the item yml files generated by the plugin when it first starts just to give you some insight into how everything works.

After that, take a look at the Creating a Custom Item page

For a list of all possible options when creating custom items (but without much explanation), you can check out the Custom Item Reference page

To add a custom texture to your items, look at the Adding Custom Textures to Items page

You can get more information about fallback textures Here for blocks, and Here for items

Additionally, you can get some more information about triggers and actions on the Handlers and Actions page

Lastly, for more information about creating custom blocks, you can head over to the Creating a Custom Block page

If you're a developer looking to add Custom Items to your plugin, awesome! You can find some more information about that on the Developer API page

Example Files

These examples files are for Minecraft 1.14 and above ONLY https://s3.amazonaws.com/projects.store/spigot/CustomItemsExampleFiles.zip

Quick Reference

Creating a Custom Item Creating a Custom Item
Custom Item Reference Custom Item Reference
Adding Variables and Globals to Items Variables and Globals
Creating a Custom Block Creating a Custom Block
Custom Block Reference Custom Block Reference
Adding Custom Textures to Items Adding Custom Textures to Items
Fallback Textures Block Fallback TexturesItem Fallback Textures
Triggers and Actions Handlers and Actions
Developer API Developer API

Support Custom Items

Support Custom Items by using our referral links when you sign up for things online (you'll never be charged more, and in some cases, you could even get a discount when you use our links)

amazon.com — every time you want to go to Amazon to buy something, use the link http://bit.ly/minecraft-amazon

fiverr.com — marketplace where you can order things like custom plugins, server videos, and more — sign up using the link https://track.fiverr.com/visit/?bta=66686&brand=fiverrcpa

Wiki Contributors

[MSWS] for being the first one to add a lot of the information to this wiki.

Nathan for adding a lot of information and making the wiki a bit neater.