Document your code
Every project on GitHub comes with a version-controlled wiki to give your documentation the high level of care it deserves. It’s easy to create well-maintained, Markdown or rich text documentation alongside your code.
Sign up for free See pricing for teams and enterprisesGuide to adding new content to CDDA for first time modders: Getting Started
Getting Started
Before you can create a mod or change, you need to set up a github account and make a copy of the CDDA code.
A brief introduction to git and github
If you don't know anything about git or github, you should read the brief introduction to git and github. If you know how git works, move on to the next section.
Setting yourself up with github
Here's a bunch of links that contain more information about how set yourself up to make a change to CDDA:
https://github.com/AMurkin/CDDA-GitHub-Start is an illustrated tutorial on setting up a github account, forking and cloning the repo, and pushing a PR.
http://cddawiki.chezzo.com/cdda_wiki/index.php?title=Contributing has the same information in th middle. You can 100% ignore all the stuff about compiling, but it's the same process to share JSON and code changes, so set up a github account.
Technically, you can just edit the files in your game's data/json folder, but if you do that while in a git repo, then git will automatically keep track of your changes.
This is mostly about the mod manager app, but it gives the basics of setting up a new mod: http://cddawiki.chezzo.com/cdda_wiki/index.php?title=Mod_manager
There's a fair bit of documentation in the game already: https://github.com/CleverRaven/Cataclysm-DDA/tree/master/doc Start with the modding guide:
https://github.com/CleverRaven/Cataclysm-DDA/blob/master/doc/MODDING.md then the general JSON format guide:
https://github.com/CleverRaven/Cataclysm-DDA/blob/master/doc/JSON_INFO.md
Before you contribute, make sure you read the JSON style guide and the manual of style for descriptive text: https://github.com/CleverRaven/Cataclysm-DDA/blob/master/doc/JSON_STYLE.md https://github.com/CleverRaven/Cataclysm-DDA/blob/master/doc/MANUAL_OF_STYLE.md
Now what?
Here's information on adding:
- a new recipe!
- a new item!
- a new location!
- better NPC dialogue!
- a new NPC
- a new quest!
- a new monster!
- a new morale effect!
- a new vehicle part!
- a new vehicle!
- a new starting profession!
- a new anything else!