# Is there / will there be any documentation on mutations?

**URL:** <https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573>\
**Category:** The Toolbox\
**Created:** [July 2, 2021, 7:59am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573 "2021-07-02T07:59:51Z")\
**Posts on this page:** 17\
**Page:** 1

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 7:59am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/1 "2021-07-02T07:59:51Z")

</div>

Currently trying to work on mutations for a mod, and noticed a lack of documentation on them. There are docs for seemingly everything else, why isn’t there any for mutations? Is it planned, or has it been forgotten? Or have I just been unable to find the documentation?

---

<div class="post-metadata">

**Author:** ![anonanon](https://avatars.discourse-cdn.com/v4/letter/a/96bed5/32.png) [@anonanon](https://discourse.cataclysmdda.org/u/anonanon)\
**Post date:** [July 2, 2021, 8:19am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/2 "2021-07-02T08:19:18Z")

</div>

everything is on the wiki or at least it was  
explain what it is you want and maybe I can help

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 8:34am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/3 "2021-07-02T08:34:42Z")

</div>

I don’t need help with anything specifically, I was just wondering if there was proper documentation for mutations, like those in the /doc/ folder.

---

<div class="post-metadata">

**Author:** ![anonanon](https://avatars.discourse-cdn.com/v4/letter/a/96bed5/32.png) [@anonanon](https://discourse.cataclysmdda.org/u/anonanon)\
**Post date:** [July 2, 2021, 8:41am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/4 "2021-07-02T08:41:01Z")

</div>

seems a little in depth and I don’t see it in there I can’t really explain it that well other than just reiterating the entire raw code for the effects sorry man

---

<div class="post-metadata">

**Author:** ![anonanon](https://avatars.discourse-cdn.com/v4/letter/a/96bed5/32.png) [@anonanon](https://discourse.cataclysmdda.org/u/anonanon)\
**Post date:** [July 2, 2021, 8:42am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/5 "2021-07-02T08:42:02Z")

</div>

oh but if that would be helpful data/json/mutations

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 8:44am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/6 "2021-07-02T08:44:42Z")

</div>

Yeah, I’ve pretty much had to just pick apart other code to figure out how to add mutations. It’s worked well enough, but some proper docs would make things easier and probably let me do more.

---

<div class="post-metadata">

**Author:** ![nigromancer](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/nigromancer/32/11320_2.png) [@nigromancer](https://discourse.cataclysmdda.org/u/nigromancer)\
**Post date:** [July 2, 2021, 3:26pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/7 "2021-07-02T15:26:04Z")

</div>

Yep. I’ve created a few new traits by reworking existing ones but I would like to add news ones.

---

<div class="post-metadata">

**Author:** ![Fris0uman](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/fris0uman/32/8607_2.png) [@Fris0uman](https://discourse.cataclysmdda.org/u/Fris0uman)\
**Post date:** [July 2, 2021, 3:28pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/8 "2021-07-02T15:28:06Z")

</div>

> <https://github.com/CleverRaven/Cataclysm-DDA/blob/68b8751a108922c102319261628bb80478b67af8/doc/JSON_INFO.md#traitsmutations>

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 6:07pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/9 "2021-07-02T18:07:24Z")

</div>

Thanks. Had a feeling it was somewhere that I just wasn’t looking.

---

<div class="post-metadata">

**Author:** ![nigromancer](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/nigromancer/32/11320_2.png) [@nigromancer](https://discourse.cataclysmdda.org/u/nigromancer)\
**Post date:** [July 2, 2021, 6:59pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/10 "2021-07-02T18:59:15Z")

</div>

Thanks. Lots of interesting code here but I can’t see how to affect morale. I wanted to create an agoraphobic trait that gives morale penalties when outdoors. Rather like being light sensitive but affecting morale cf ‘nomad’ trait. Any suggestions that I could stick in a json?

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 8:31pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/11 "2021-07-02T20:31:45Z")

</div>

Sounds like what you want to do isn’t possible (based on my understanding) with just JSON. A lot of the traits (not mutations) utilize C++, which is why when you look at them in their JSON file they’re basically blank. Agoraphobia is something that would fit in the base game, so you could probably get it included if you were to write the code for it and then setup a PR.

---

<div class="post-metadata">

**Author:** ![nigromancer](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/nigromancer/32/11320_2.png) [@nigromancer](https://discourse.cataclysmdda.org/u/nigromancer)\
**Post date:** [July 2, 2021, 9:05pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/12 "2021-07-02T21:05:53Z")

</div>

Thanks for clarifying.  
Yah, that sounds hopeful. First, however, I’ll need to graduate from json to C++. Where to begin… I wonder if someone can lend me a copy of SICP? 🙂

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 9:28pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/13 "2021-07-02T21:28:01Z")

</div>

Assuming I was looking for the correct thing, here’s a link to a website with the full text plus some other helpful stuff: [https://mitpress.mit.edu/sites/default/files/sicp/index.html](https://mitpress.mit.edu/sites/default/files/sicp/index.html)

---

<div class="post-metadata">

**Author:** ![nigromancer](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/nigromancer/32/11320_2.png) [@nigromancer](https://discourse.cataclysmdda.org/u/nigromancer)\
**Post date:** [July 2, 2021, 10:15pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/14 "2021-07-02T22:15:17Z")

</div>

Uh, I’m not a CS major but… Wow.  
Thanks! I was joking of course, but it’s fun to see IRL game content.  
Still, it’s not going to help me learn C++, is it? 😵

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 2, 2021, 10:53pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/15 "2021-07-02T22:53:05Z")

</div>

Trust me, I’m not a CS major either. Never done C++, but I have done C which is extremely similar. It isn’t too difficult to learn, I’d recommend just looking for a course online. There are plenty of great free courses out there.

---

<div class="post-metadata">

**Author:** ![nigromancer](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/nigromancer/32/11320_2.png) [@nigromancer](https://discourse.cataclysmdda.org/u/nigromancer)\
**Post date:** [July 3, 2021, 8:18am UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/16 "2021-07-03T08:18:37Z")

</div>

Thanks for the encouragement. I may end up spending more time creating content than playing the game - but the journey will be fun. Cheers, 😉

---

<div class="post-metadata">

**Author:** ![ERROR\_CODE](https://sea2.discourse-cdn.com/flex016/user_avatar/discourse.cataclysmdda.org/error_code/32/11153_2.png) [@ERROR\_CODE](https://discourse.cataclysmdda.org/u/ERROR_CODE)\
**Post date:** [July 3, 2021, 12:52pm UTC](https://discourse.cataclysmdda.org/t/is-there-will-there-be-any-documentation-on-mutations/26573/17 "2021-07-03T12:52:20Z")

</div>

That’s how I’ve felt too. Good luck, man.