# Modding Stonehearth: first steps

**URL:** <https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619>\
**Category:** Modding\
**Created:** [January 1, 2014, 2:05pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619 "2014-01-01T14:05:43Z")\
**Posts on this page:** 20\
**Page:** 3

<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 9, 2014, 5:29pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/41 "2014-01-09T17:29:58Z")

</div>

Still not working for me. I will try again after the game gets an update. For now I will work on something else.

---

<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 9, 2014, 6:58pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/42 "2014-01-09T18:58:02Z")

</div>

@Skull24 Can you upload the .qb-file you have created? Also if you can explain step by step what you are doing, we might be able to find the point where everything breaks.

---

<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 9, 2014, 10:49pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/43 "2014-01-09T22:49:29Z")

</div>

**Before the new build.**

I do the following

Mods -\> stonehearth -\> entities -\> humans -\> female\_1, female\_2, female\_3 I change them all with these steps.

I edit female\_1, 2, 3.json files and change the names of file (head\_1.qb) and (body.qb) to this file (fiannahead.qb) and (fiannabody.qb).

I also remove these files head\_1.qb and body.qb with these files fiannabody.qb and fiannahead.qb.

The fiannabody.qb and fiannahead.qb models share the same space and loaction. As the stock files.

I then zip the file and run the game ans the results were always the same. Headless towns people or the stock body and my custom body share the same space. But as a result they can not move or do anything.

Thanks for the help @voxel_pirate and everyone else. I really do thank you guys.

[fiannahead.qb](https://discourse.stonehearth.net/uploads/short-url/h0G1Nk3C88vagLbweqXsKTx2cN7.qb) (35.8 KB)  
[fiannabody.qb](https://discourse.stonehearth.net/uploads/short-url/vilPYj4Mjium6BPomgz0ofXqrUp.qb) (35.8 KB)

---

<div class="post-metadata">

**Author:** ![HSTF](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/hstf/32/3031_2.png) [@HSTF](https://discourse.stonehearth.net/u/HSTF)\
**Post date:** [January 10, 2014, 2:25am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/44 "2014-01-10T02:25:48Z")

</div>

I am having trouble with the game opening after I have done as instructed by the steps posted from the link at the top of this thread. I do the steps listed but when I attempt to run the game, it doesn’t run. I really want to get into modding and would like help.

---

<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 10, 2014, 2:44am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/45 "2014-01-10T02:44:22Z")

</div>

What’s stonehearth.log say? It’s in the folder with stonehearth.exe. It should helpfully tell us what’s wrong.

---

<div class="post-metadata">

**Author:** ![HSTF](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/hstf/32/3031_2.png) [@HSTF](https://discourse.stonehearth.net/u/HSTF)\
**Post date:** [January 10, 2014, 3:01am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/46 "2014-01-10T03:01:03Z")

</div>

Error looking for manifest in stonehearth: invalid file path ‘stone hearth/manifest.json’.

---

<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 10, 2014, 3:04am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/47 "2014-01-10T03:04:15Z")

</div>

Ok, the format for all mods include the default ones need to be either a folder containing everything or a .smod with the same name containing that folder. What you’ve probably got is a stonehearth folder containing a stonehearth folder which contains everything. Move the inner one out as you need only the one.

---

<div class="post-metadata">

**Author:** ![HSTF](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/hstf/32/3031_2.png) [@HSTF](https://discourse.stonehearth.net/u/HSTF)\
**Post date:** [January 10, 2014, 3:24am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/48 "2014-01-10T03:24:52Z")

</div>

Thanks! I saw that happening but thought that was what was supposed to happen. I’ll fix it next time I can and see if it works.

---

<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 10, 2014, 7:12am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/49 "2014-01-10T07:12:44Z")

</div>

@Skull24 I could imagine that your problem is that you have not named the limbs appropriately. Your matrix for the head does not have a name, i.e. it is labled with the default from QC like “Matrix\_0”. Make sure that if you alter body parts, you also adopt the related name. Try to change the name of the matrix to “head” (F2)… that should do the trick.

In case it works, I assume that the animations will not look properly as you have also changed the size of the matrix. Try to align it back to the size which is used by the standard matrix to prevent some offsets.

---

<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 10, 2014, 11:56am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/50 "2014-01-10T11:56:29Z")

</div>

So while I’ve been playing around with the ui I produced a .psd that splits all the parts of the crafting ui into separate layers. It’s not particularly good and I’ll probably improve it later but I figure it might be useful if anyone wants to reskin it for a mod. [Here it is](https://www.dropbox.com/s/lqm96htb66nk5d2/craftuibase.psd), I might split it up a bit more later so that it auto recolors stripes and such but it’s fine for now.

---

<div class="post-metadata">

**Author:** ![HSTF](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/hstf/32/3031_2.png) [@HSTF](https://discourse.stonehearth.net/u/HSTF)\
**Post date:** [January 10, 2014, 7:52pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/51 "2014-01-10T19:52:13Z")

</div>

Now it’s coming up with an error message whenever I press new game. “header.compression == COMPRESSION\_NONE”

---

<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 11, 2014, 4:36am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/52 "2014-01-11T04:36:55Z")

</div>

I haven’t seen that one before unfortunately, I’d suggest making sure you don’t have any corrupted .smod’s or anything. @RepeatPan do you know what would be causing it?

I’ve also updated the .psd base however dropbox seems to be having issues so it’s not up yet. The new thing is that I moved all the stripes and shadows into overlays so it’s now super easy to recolour everything. Just look for the files labelled " - EDIT" to know which ones determine the colour. For example my first recolour is here, it’s just a combo of dark grey and bone white, it still needs work but as a first look at an alternative crafting ui.

 ![](https://us1.discourse-cdn.com/flex022/uploads/stonehearth/original/3X/2/9/29bfb62dcb24ec80b5af8fff5a4801a1842df248.png)

---

<div class="post-metadata">

**Author:** ![RepeatPan](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/repeatpan/32/46418_2.png) [@RepeatPan](https://discourse.stonehearth.net/u/RepeatPan)\
**Post date:** [January 11, 2014, 10:20am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/53 "2014-01-11T10:20:32Z")

</div>

compression level sounds a bit odd, but then again this could mean so much nowadays. It’s likely not the smod files (trying to 7z instead of zip them simply crashes the game, no message, compression level ultra or store don’t do anything either). What I can say with some confidence is that he sees a (failed) assert, the game assumes the compression (of something) to be… none, which is not the case.

However, _so many_ things are compressed. Is Stonehearth expecting uncompressed PNG? Are QB in some way compressed? There’s too many possibilities to make a decent guess; the best way would be to diff the directory/smod against the original files.

---

<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 11, 2014, 3:38pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/54 "2014-01-11T15:38:18Z")

</div>

I did and this is what happened.

---

<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 11, 2014, 8:06pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/55 "2014-01-11T20:06:26Z")

</div>

You’ve changed the body-files for only one variant of the femal settler, right? To me this looks like Stonehearth is not finding the files / limbs… which again I think is either due to:

- wrong naming of the files
- wrong naming / position of the limbs

… maybe check all the small details and make them as close to the initial files as possible (also check for things like the right file format, .qb vs. qmo… I know, but I would really check everything 😉).

---

<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 11, 2014, 10:30pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/56 "2014-01-11T22:30:18Z")

</div>

Okay, I will try that and let you know what’s up.

---

<div class="post-metadata">

**Author:** ![Wade](https://avatars.discourse-cdn.com/v4/letter/w/9de053/32.png) [@Wade](https://discourse.stonehearth.net/u/Wade)\
**Post date:** [January 13, 2014, 1:52am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/57 "2014-01-13T01:52:58Z")

</div>

@HSTF I had the same issue at first. When exporting the .qb file from Qubicle Constructor, make sure compression is clicked “off.” It’s on by default.

---

<div class="post-metadata">

**Author:** ![HSTF](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/hstf/32/3031_2.png) [@HSTF](https://discourse.stonehearth.net/u/HSTF)\
**Post date:** [January 13, 2014, 2:05am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/58 "2014-01-13T02:05:56Z")

</div>

Thanks! I was wondering why the originals were at 32mb but the edited versions were at 5mb.

---

<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 13, 2014, 11:58pm UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/59 "2014-01-13T23:58:59Z")

</div>

I keep getting the same results. I will wait till the next build and see what happens.

**Side Note**

I’ve been busy working on a story and will show it to you guys soon. Here’s the thing I want to make it an animated story. I will need everyone’s help to make it happen. Well, if you guys want to and if you like it, lol.

---

<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 14, 2014, 12:49am UTC](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619/60 "2014-01-14T00:49:28Z")

</div>

> [@Skull24](#):
>
> Here’s the thing I want to make it an animated story.

excellent! would love to participate… what other details can you provide? 😃

[Previous page](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619.md?page=2)

[Next page](https://discourse.stonehearth.net/t/modding-stonehearth-first-steps/4619.md?page=4)