# \[Tutorial\] How to add a custom, craftable item

**URL:** <https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782>\
**Category:** Modding\
**Created:** [January 5, 2014, 1:05pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782 "2014-01-05T13:05:44Z")\
**Posts on this page:** 20\
**Page:** 2

<div class="post-metadata">

**Author:** ![voxel\_pirate](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/voxel_pirate/32/2309_2.png) [@voxel\_pirate](https://discourse.stonehearth.net/u/voxel_pirate)\
**Post date:** [January 5, 2014, 4:47pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/21 "2014-01-05T16:47:05Z")

</div>

So if all the namings and links to the folders are right… do you have 2 version of it, i.e. a proxy-file? Which one is that one you’ve posted.

I would try to move it to the center as Miturion mentioned and if it is the proxy-version I would create a Matrix which is 10 x 10 x 10 Voxels in size and is also centered.

---

<div class="post-metadata">

**Author:** ![moondrixx\_01](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/moondrixx_01/32/12571_2.png) [@moondrixx\_01](https://discourse.stonehearth.net/u/moondrixx_01)\
**Post date:** [January 5, 2014, 4:50pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/22 "2014-01-05T16:50:31Z")

</div>

that is the proxy and i have used a 10x10x10, the problem is happening with all quibicle models i have. here is the original file [Dropbox - Error](https://www.dropbox.com/s/k3a9r6x021hh42y/sickle.qmo)

---

<div class="post-metadata">

**Author:** ![voxel\_pirate](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/voxel_pirate/32/2309_2.png) [@voxel\_pirate](https://discourse.stonehearth.net/u/voxel_pirate)\
**Post date:** [January 5, 2014, 5:01pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/23 "2014-01-05T17:01:19Z")

</div>

Hm… if this .qb-file results from that .qmo-file… it looks strange. If I use the settings described above, there is no difference between the qmo- and qb-file. Can you describe your problem a bit more in detail in the official Minddesk-forum. Tim might be of help.

---

<div class="post-metadata">

**Author:** ![moondrixx\_01](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/moondrixx_01/32/12571_2.png) [@moondrixx\_01](https://discourse.stonehearth.net/u/moondrixx_01)\
**Post date:** [January 5, 2014, 5:06pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/24 "2014-01-05T17:06:31Z")

</div>

dont worry im an idiot, i was trying to open the qb file, when i imported it, it worked fine. also i missed a bracket on each line in the manifest, maybe this is a sign i should go to bed, sorry for the trouble and thanx for you help!

---

<div class="post-metadata">

**Author:** ![voxel\_pirate](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/voxel_pirate/32/2309_2.png) [@voxel\_pirate](https://discourse.stonehearth.net/u/voxel_pirate)\
**Post date:** [January 5, 2014, 5:18pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/25 "2014-01-05T17:18:34Z")

</div>

> [@Miturion](#):
>
> I tried to add a different category, but game crashed. Did you found out what you need for that?

@Miturion do you mean a category in the crafting UI, just like “Construction & Furnishings”? For this you just need to edit the recipes.json-file in the professions-folder (carpenter in this case). E.g. I have added my printing press into a new category by changing the file like that:

```
{
   "craftable_recipes" : [
      {
         "category" : "Construction & Furnishings",
         "recipes" : [
            "file(picket_fence_recipe.json)",
            "file(picket_fence_gate_recipe.json)",
            "file(simple_wooden_chair_recipe.json)",
            "file(arch_backed_chair_recipe.json)",
            "file(table_for_one_recipe.json)",
            "file(dining_table_recipe.json)",
            "file(not_much_of_a_bed_recipe.json)",
         ]
      },
      {
         "category" : "Weapons & Armor",
         "recipes" : [
            "file(wooden_sword_recipe.json)",
            "file(wooden_buckler_recipe.json)"
         ]
      },
      {
         "category" : "Printing",
         "recipes" : [
            "file(printing_press_recipe.json)",   
         ]
      }
   ]
}

```

Not sure yet for what the other .json-files do include a category-tag as it is in one of the files “weapon” for all the items and is at least not linked to the crafting UI. We will find out with time, I guess. Here a screenshot of the result:

 ![](https://us1.discourse-cdn.com/flex022/uploads/stonehearth/original/3X/7/7/77f7205fc72d3d363bdf32ad22c348a00992fc4f.png)

---

<div class="post-metadata">

**Author:** ![Miturion](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/miturion/32/43498_2.png) [@Miturion](https://discourse.stonehearth.net/u/Miturion)\
**Post date:** [January 5, 2014, 5:23pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/26 "2014-01-05T17:23:37Z")

</div>

great, yea that was what I was trying. Maybe also some bracket or something or the fact that I had it in 2 categories at the same time. 😑

btw @voxel_pirate. If you have time can you make some guide for installing mods? I dont know how to make video’s and put them on youtube and stuff and the fact that you are great at them 😄 .  
People seem to have trouble with installing my mod and @Avairian’s mod and I dunno why. It goes fine by me.

---

<div class="post-metadata">

**Author:** ![Avairian](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/avairian/32/47084_2.png) [@Avairian](https://discourse.stonehearth.net/u/Avairian)\
**Post date:** [January 5, 2014, 5:27pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/27 "2014-01-05T17:27:49Z")

</div>

> [@Miturion](#):
>
> People seem to have trouble with installing my mod and @Avairian’s mod and I dunno why. It goes fine by me.

I seem to have issues sometime when I try to install my test builds. If i take the same zip file and re-install it it sometimes fixes itself. Between that and the process being a little complicated a video might help quite a bit.

---

<div class="post-metadata">

**Author:** ![Miturion](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/miturion/32/43498_2.png) [@Miturion](https://discourse.stonehearth.net/u/Miturion)\
**Post date:** [January 5, 2014, 5:36pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/28 "2014-01-05T17:36:15Z")

</div>

hmm, I dont have that problem with the builds. Only when I test my typo-files 😝

---

<div class="post-metadata">

**Author:** ![Avairian](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/avairian/32/47084_2.png) [@Avairian](https://discourse.stonehearth.net/u/Avairian)\
**Post date:** [January 5, 2014, 5:39pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/29 "2014-01-05T17:39:05Z")

</div>

> [@Any advice from modders on how to present their mods in videos?](https://discourse.stonehearth.net/t/any-advice-from-modders-on-how-to-present-their-mods-in-videos/4712/24):
>
> I can try and upload a direct smod file later today if that’ll help. One thing I noticed when creating test builds is to unzip the downloaded mod file in a separate location and then copy and past it to combine it with the original game files.
> 
> Also make sure that when you unzip the files it doesn’t put the stonehearth folder into another stonehearth folder (ex mods/stonehearth/stonehearth/entitites) as my unzipping program tries to do.
> 
> Idk if that makes any sense. Let me know if you try it out.

This could be the issue I have sometimes. Sometimes I’m working to fast and don’t pay much attention to what I’m doing. xD

---

<div class="post-metadata">

**Author:** ![voxel\_pirate](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/voxel_pirate/32/2309_2.png) [@voxel\_pirate](https://discourse.stonehearth.net/u/voxel_pirate)\
**Post date:** [January 5, 2014, 6:54pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/30 "2014-01-05T18:54:43Z")

</div>

@Miturion I need to get into the topic first. I know there are some activities going in the Stonehearth Guru community… but did not look into the details yet. Actually the best approach would be to add the mods into the mods-folder without overwriting stonehearth.smod all the time. But as mentinoed, need to look into this first.

---

<div class="post-metadata">

**Author:** ![SteveAdamo](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/steveadamo/32/13955_2.png) [@SteveAdamo](https://discourse.stonehearth.net/u/SteveAdamo)\
**Post date:** [January 5, 2014, 7:21pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/31 "2014-01-05T19:21:46Z")

</div>

> [@voxel\_pirate](#):
>
> It is rather easy to add a custom item into the Alpha which will be craftable by the carpenter

wow, another excellent tutorial from @voxel_pirate… well done my friend! 👍

we should start collecting these into a journal of sorts… “Voxel Pirate’s Greatest Hits!”…

and, if you order now,…

---

<div class="post-metadata">

**Author:** ![Avairian](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/avairian/32/47084_2.png) [@Avairian](https://discourse.stonehearth.net/u/Avairian)\
**Post date:** [January 5, 2014, 7:35pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/32 "2014-01-05T19:35:17Z")

</div>

What program do you use to create your icon images?

---

<div class="post-metadata">

**Author:** ![Miturion](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/miturion/32/43498_2.png) [@Miturion](https://discourse.stonehearth.net/u/Miturion)\
**Post date:** [January 5, 2014, 7:35pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/33 "2014-01-05T19:35:28Z")

</div>

Yes, I saw that one. It is great, but unfortunately it does not yet work when you need to overwrite files. But adding code to the manifest is good with that.

---

<div class="post-metadata">

**Author:** ![voxel\_pirate](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/voxel_pirate/32/2309_2.png) [@voxel\_pirate](https://discourse.stonehearth.net/u/voxel_pirate)\
**Post date:** [January 5, 2014, 8:36pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/34 "2014-01-05T20:36:45Z")

</div>

@Avairian I have created the icon using [Inkscape](http://www.inkscape.org/de/), an open source alternative to Adobe Illustrator.

---

<div class="post-metadata">

**Author:** ![Avairian](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/avairian/32/47084_2.png) [@Avairian](https://discourse.stonehearth.net/u/Avairian)\
**Post date:** [January 5, 2014, 8:42pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/35 "2014-01-05T20:42:55Z")

</div>

Thanks I’ll have to check that out! I was trying to use gimp but I don’t know how to use it well. ☹

Nice tutorial by the way! Using it now to add some craftables to the game. 😄

**Edit:** Inkscape is a pretty nice program. I have no idea how you’ve created such a nice icon. I have no idea what I’m doing. o.o

---

<div class="post-metadata">

**Author:** ![Skull24](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/skull24/32/50675_2.png) [@Skull24](https://discourse.stonehearth.net/u/Skull24)\
**Post date:** [January 6, 2014, 3:40am UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/36 "2014-01-06T03:40:40Z")

</div>

@voxel_pirate great work as always.

I forgot can someone please remind me. What program are they using to write and compile the .json files and what program are they using to write and compile .lua files? Thanks in advance.

---

<div class="post-metadata">

**Author:** ![Smokestacks](https://avatars.discourse-cdn.com/v4/letter/s/97f17d/32.png) [@Smokestacks](https://discourse.stonehearth.net/u/Smokestacks)\
**Post date:** [January 6, 2014, 3:46am UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/37 "2014-01-06T03:46:29Z")

</div>

Are the .json files not possibly simply Notepad? I can certainly open, edit and save them with it, but I also have a feeling Tom mentioned it in a stream. Lua, I’m not sure. Would it not just be in the Lua programme?

Pardon the complete lack of coding knowledge, and hence also any very silly things said. 😛

---

<div class="post-metadata">

**Author:** ![Xavion](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/xavion/32/43501_2.png) [@Xavion](https://discourse.stonehearth.net/u/Xavion)\
**Post date:** [January 6, 2014, 4:47am UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/38 "2014-01-06T04:47:03Z")

</div>

.json files are just text. The lua being compiled only slightly reduces load time and that’s it. They use [Sublime Text](http://www.sublimetext.com/) I’m pretty sure, it comes with a free untimed trial that just pops up with a do you want to register message occasionally. It works for .lua and .json and is generally a good program.

---

<div class="post-metadata">

**Author:** ![sdee](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/sdee/32/65441_2.png) [@sdee](https://discourse.stonehearth.net/u/sdee)\
**Post date:** [January 6, 2014, 6:17pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/39 "2014-01-06T18:17:34Z")

</div>

@voxel_pirate, just wanted you to know that Team Radiant is thrilled with your printing press! Everyone here wants to be a literate. 😉

Eventually we’ll need a way for the recipe list to be constructed dynamically from all the installed mods, so you don’t have to edit recipies.json.

---

<div class="post-metadata">

**Author:** ![Skull24](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/skull24/32/50675_2.png) [@Skull24](https://discourse.stonehearth.net/u/Skull24)\
**Post date:** [January 6, 2014, 6:59pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/40 "2014-01-06T18:59:58Z")

</div>

@Smokestacks and @Xavion Thanks for the help and tips.

[Previous page](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782.md?page=1)

[Next page](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782.md?page=3)