# \[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:** 1

<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, 1:05pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/1 "2014-01-05T13:05:45Z")

</div>

It is rather easy to add a custom item into the Alpha which will be craftable by the carpenter (as it is the only profession in the game at the moment).

**Get prepared:**

- Unzip the “stonehearth.smod”-file
- Create a .png-file which represents the look of your item in the crafting UI
- Create a .qb-file which represents your item
- Create a .qb-file which represents an itemized version of your item

Creating the .qb-files will require a Home-, Master- or Stonehearth-Edition of QC.

**Relevant References (where to change / add something):**

- Stonehearth \>\> Mods \>\> stonehearth \>\> entities \>\> furniture ( 1️⃣ )
- Stonehearth \>\> Mods \>\> stonehearth \>\> entities \>\> professions \>\> carpenter \>\> recipes ( 2️⃣ )
- Stonehearth \>\> Mods \>\> stonehearth ( 3️⃣ )

1️⃣ - Just take an existing folder (item) and use it as a template. You will need to add the .png and the two .qb-files in this folder. The files named “proxy” are including information for the iconized version of your item. Be sure to replace all the references in the .json-files with your file- and folder-names. In the .json-files you can define how the item will be called once it is placed in the world and what will be the description.

2️⃣ - Create a recipe-file with your item name (again use an existing one as a template). Be sure to adjust the references (file- and folder-names) in the recipe-file. Here you can define the text which will be shown in the Crafting UI, the amount of resources required to craft your item and the duration it will take. You also need to add the name of this file into the “recipes.json”-file which you will find in this folder.

3️⃣ - Open the file called “manifest.json” and add the following two lines (after you have replaced the placeholder with the name / folder of your item):

_“placeholder” : “file(entities/furniture/placeholder)”,  
“placeholder\_proxy” : “file(entities/furniture/placeholder/placeholder\_proxy.json)”,_

Once done, just zip the stonehearth-folder again and rename it to stonehearth.smod. You should be ready to go now.

**A detailed tutorial (15 Min.) can be watched here:**

---

<div class="post-metadata">

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

</div>

ah good ol’ 6 am topics. thanks this was helpful.

---

<div class="post-metadata">

**Author:** ![DragoKen](https://avatars.discourse-cdn.com/v4/letter/d/b9e5f3/32.png) [@DragoKen](https://discourse.stonehearth.net/u/DragoKen)\
**Post date:** [January 5, 2014, 1:29pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/3 "2014-01-05T13:29:40Z")

</div>

Oh Voxel you darn scurvy pirate 😄 … this can’t be done with qubicle basic can it? Anyways thx for the tutorail its very handy.

---

<div class="post-metadata">

**Author:** ![LineLiar](https://avatars.discourse-cdn.com/v4/letter/l/94ad74/32.png) [@LineLiar](https://discourse.stonehearth.net/u/LineLiar)\
**Post date:** [January 5, 2014, 1:39pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/4 "2014-01-05T13:39:23Z")

</div>

Awesome! This will probably help a lot of potential modders. 😃

---

<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, 1:48pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/5 "2014-01-05T13:48:09Z")

</div>

@DragoKen Unfortunately not with QC in the free version. You will either have to have the Master- or Home-Edition… or just wait for next week and buy the Stonehearth Edition which should be available for $11.

---

<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, 1:48pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/6 "2014-01-05T13:48:52Z")

</div>

@voxel_pirate u sir are a scholar and a gentleman. i had worked out 2/3 of the things, but could not get my head around the last! than you!

---

<div class="post-metadata">

**Author:** ![DragoKen](https://avatars.discourse-cdn.com/v4/letter/d/b9e5f3/32.png) [@DragoKen](https://discourse.stonehearth.net/u/DragoKen)\
**Post date:** [January 5, 2014, 1:57pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/7 "2014-01-05T13:57:57Z")

</div>

I probably will 😃 but really tempted to splurge a bit on the $40 one since … yeah more gadgets 😁

---

<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, 1:58pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/8 "2014-01-05T13:58:50Z")

</div>

… the feature to export into the .obj-format is for sure very nice 😉.

---

<div class="post-metadata">

**Author:** ![LineLiar](https://avatars.discourse-cdn.com/v4/letter/l/94ad74/32.png) [@LineLiar](https://discourse.stonehearth.net/u/LineLiar)\
**Post date:** [January 5, 2014, 2:01pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/9 "2014-01-05T14:01:59Z")

</div>

Oh wow… I didn’t even see that was possible. Here I come, world!

---

<div class="post-metadata">

**Author:** ![Sarhifigus](https://avatars.discourse-cdn.com/v4/letter/s/8797f3/32.png) [@Sarhifigus](https://discourse.stonehearth.net/u/Sarhifigus)\
**Post date:** [January 5, 2014, 2:31pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/10 "2014-01-05T14:31:03Z")

</div>

Thanks for this tutorial, both the Video and the instructions are good, can’t wait to see what people add

---

<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, 2:40pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/11 "2014-01-05T14:40:41Z")

</div>

@voxel_pirate ok ur gona laugh at this one, ive been scratching my head as to why it was not working, and why when the carpenter crafted the item it would not spawn in the world as an icon.

after tearing my head out for hours, i noticed my qb files are only 1kb in size. they were empty… so in all,  
**can i ask what your export settings are for your qb files?**

edit: scratch that i cant export anything as .qb with master edition of qubicle

---

<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, 4:14pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/12 "2014-01-05T16:14:31Z")

</div>

This settings work for exporting qb files

![](https://us1.discourse-cdn.com/flex022/uploads/stonehearth/original/2X/3/3d329106b91a02cb4833229bf0ac5fe38b9560fe.jpg)

@voxel_pirate Nice guide. I had found this out already but failed due to typos 😊. I tried to add a different category, but game crashed. Did you found out what you need for that?

---

<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:18pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/13 "2014-01-05T16:18:50Z")

</div>

na still did not work, its not the settings its just not working for me, its stupid. i tryed other models as well.

---

<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, 4:20pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/14 "2014-01-05T16:20:51Z")

</div>

maybe it is typos. I had those too and wondered why it did not work. Everything has to be exact correctly named.

---

<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:23pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/15 "2014-01-05T16:23:23Z")

</div>

named? as in the file name?

---

<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, 4:24pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/16 "2014-01-05T16:24:42Z")

</div>

everything. filename too

---

<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:28pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/17 "2014-01-05T16:28:21Z")

</div>

i have the model named, i have the file named the same, it should just export as sickle.qb, but it exports so fast and is empty when i open it again.

---

<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, 4:33pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/18 "2014-01-05T16:33:38Z")

</div>

maybe a dumb question, but have you selected the object in qubicle? It needs to be selected before exporting and at the origin (0,0,0). Some objects have the middle of the object at the origin, some have a corner of the box surrounding the object as (0,0,0)

---

<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:35pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/19 "2014-01-05T16:35:47Z")

</div>

@moondrixx_01 You can see my export settings in the video. They are similar to Miturion’s but I have “Hollow” unchecked but check “Single Object” (as proposed by Tim from Minddesk). Depending on the size of your item the proxy-qb-file could be rather small (mine is 4 kb), however the full-sized qb-file should be significant larger. Can you upload your qb-files somewhere to check them?

I have had the same issue with items not spawning. I could add the item and see it in the crafting UI. My carpenter also crafted it, but once he was finished the item did not spawn. The problem was that I did not add it in the manifest.json. Be sure that you have it in there with the right links to the folders / files. Also that it is included in the redipes.json.

P.S. In worst case invest the 15 minutes to take a look at the video above. There you should see all steps required.

---

<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:44pm UTC](https://discourse.stonehearth.net/t/tutorial-how-to-add-a-custom-craftable-item/4782/20 "2014-01-05T16:44:07Z")

</div>

yep every other step is in place EVERY thing is right cheeked it 5 times over. the exact issue ur describing is happening, i have watched the video twice now, its all right, just the qb files r empty. [Dropbox - Error](https://www.dropbox.com/s/lu97k5rkbjy2xh1/sickle.qb)

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