Tutorial: Making your first item - pantonshire/Vulcan GitHub Wiki

NOTE: This tutorial was made for Vulcan Alpha 0.2.0 and is not guaranteed to work in other versions.

---

Time to add your very first item to Minecraft! Follow these steps, and you'll have your very own item in the game in no time.

Create a new Vulcan file

• You can call this file anything you want. It just needs to end in .vlcn
• I'll be calling mine "tutorial.vlcn".

Setting the type

• We need to tell Vulcan what kind of file we've made. We do this by writing:
  type: item
  on the very first line. Make sure it's all lower-case!

Setting the item's attributes

• Below the line you just wrote, add the following:
  attributes:
• This tells Vulcan that we're going to set the item's attributes. An item's attributes are things like its name, its texture, how many you can fit into one stack, and so on.
• Now for the fun part: choosing the attributes! Firstly, let's choose a name. On the next line, write:
  set name to "INSERT YOUR NAME HERE"
  Change the INSERT YOUR NAME HERE to whatever you want. Make sure you keep the quotation marks in, though!
• We can set the item's description in the same way:
  set description to "INSERT YOUR DESCRIPTION HERE"
• If you want, you can make your item shiny by writing
  set shiny to true
  By default, it will be false — if you don't write anything, then your item won't be shiny.
• You can change how many items fit in a stack by writing
  set stack to NUMBER
  replacing NUMBER with whatever whole number you want. For example:
  set stack to 5
• Now to give the item a texture.
• You can make your own texture using an application like photoshop. Make sure its size is 16x16 and give it the .png extension.
• If you don't want to make your own texture, you can download an example one I made here.
• To apply your texture to your item, write:
  set texture to "NAME"
  replacing NAME with whatever the name of your texture is. Remember to keep the quotation marks in! For example:
  set texture to "example_texture"

Finished file
Here's the complete file I made:

type: item

attributes:
    set name to "Example item"
    set description to "My brilliant example item!"
    set shiny to true
    set stack to 16
    set texture "example_texture"