MODDING AGREEMENT
---------
Modding Noita is only allowed if you agree to the separate Modding Agreement (Noita-ModdingAgreement-vXXX.rtf).
The Modding Agreement can be found in the tools_modding folder, next to this file, and is available on our website.


Steps to start playing around with modding:
---------

1) Copy all files from Noita\tools_modding into the Noita root directory (contains Noita.exe)
   copy *.* ..
2) Run data_wak_unpack.bat
3) See Noita\mods\example, Noita\mods\nightmare or Noita\mods\starting_loadouts for example mods
4) Find basic documentation under Noita\tools_modding


Uploading and updating Steam Workshop mods (needs Steam version of the game):
---------

Preparation
---
1) The mod's folder should exist inside Noita\mods\

2) Create a file called workshop.xml inside the mod's folder with the following contents:
	<Mod
		name="YOUR_MOD_NAME_HERE"
		description="YOUR_MOD_DESCRIPTION_HERE"
		tags="TAGS"
		dont_upload_folders="FOLDER_TO_IGNORE1|FOLDER_TO_IGNORE2"
		dont_upload_files="FILE_TO_IGNORE1|FILE_TO_IGNORE2"
	> 
	</Mod>
where 
- YOUR_MOD_NAME_HERE and YOUR_MOD_DESCRIPTION_HERE are replaced with the name and description of your mod. You can use empty description in case you'd rather set the description through the mod's Steam workshop page (the description is not updated if the field is empty).
- TAGS is a comma-separated list of tags applying to the mod. Currently the following tags are available:
	gameplay
	graphics
	quality of life
	translations
	perks
	spells
	player characters
	loadouts
	biomes
	total conversions
	game modes
	creatures
	bosses
	alchemy
	tweaks
	items
	audio
	cheats
	funny
	streaming integration
	mod dependencies
Tag names must be spelled exactly as above, in lowercase. Feel free to tell us if you feel a tag is missing.
- FOLDER_IGNORE1 and so on are folders that shouldn't be uploaded separated with | (For example: dont_upload_folders="ignore_this|files\ignore_this_subfolder").
- FILE_IGNORE1 and so on are files that shouldn't be uploaded separated with | (For example: dont_upload_folders="secret_dev_file.txt").

3) Create a file called workshop_preview_image.png inside the mod's folder. This file will be used as the 
mod's preview image in Steam Workshop. The image should have 16:9 aspect ratio.

Other: 
- Mods that have request_no_api_restrictions="1" don't work through Steam Workshop.
- Only the following file types are uploaded:
	.txt
	.csv
	.bmp
	.xml
	.png
	.lua
	.frag
	.vert
	.bank
	.bin
	.plz
- Git folders (.git) are ignored automatically.
- If you remove your mod from Steam Workshop and upload it again later, workshop_id.txt has to be first removed from the mod folder. "Steam - workshop upload failed: 2" might be an indicator of this.

Uploading using the upload wizard
---
Run the following command from a command line (or use workshop_upload.bat shipped with the game):
	noita_dev.exe -workshop_upload

Batch upload:
---
Run the following command from a command line:
	noita_dev.exe -workshop_upload MOD_NAME -workshop_upload_change_notes CHANGE_NOTES
where MOD_NAME is the name of the mod folder inside the mods/ folder, for example nightmare
and where CHANGE_NOTES is the update's change notes or empty. This allows uploading mods without any interrupts from the UI.