Yes, it is a
bit light on lacking any documentation.
Tags are dumped raw to output, and are read in raw.
Let's do an example case, like a free coke reaction for the smelter (everybody loves free coke!).
1) Do everything you would normally do when modding a new reaction. Namely, create the reaction in the reaction_smelter.txt raw file
in the region's raw\objects folder. Something like this:
[REACTION:FREE_COKE]
[NAME:free coke baby!]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:BAR:NO_SUBTYPE:COAL:COKE][PRODUCT_DIMENSION:150]
[SKILL:SMELT]
Add it to the end of the file.
Like normal, add the tag to the entity_default.txt file, for example:
[PERMITTED_REACTION:FREE_COKE]
If you don't understand that so far, go look at the other reaction modding threads.
Now the free coke is supported in your save game's raws, but it doesn't exist in the world, so loading the game will ignore it.
Now's when you edit the exported file from dfworldtinker.
Search for the ====reaction====
That is how I delimit and identify the different sections.
You should see a list of all the reactions in the game. Simply add a new line with:
FREE_COKE
It must be on it's own line, it must come after the existing reactions, and it must be in all capital letters.
Save the file, and run the import command for your region and the edited file.
First the program makes a backup of your world file, which can get big, so pay attention to it.
If everything works, inside the game the smelter will now be able to create free coke.
Some notes on importing:
When re-importing a file, note that the sections must come in the order expected, must be exactly what you want added, and the tags themselves must be in the correct order, or strange things will happen. If, for example, you swap the DIAMOND_RED line with the SAND_RED line,
every layer of red sand in the world will be replaced with red diamond, and vice versa. Not only that, but every bag of red sand will transmute to bags of red diamond powder, every red diamond gem will transmute to red sand gem. This is, obviously undesired and unstable. I only intend the tool for adding tags for modding a running game... but you are free to use it as you like.
After all, a solid raw adamantine mountain where there used to be boring granite does sound kind of cool, doesn't it?
...
...
note how it still has all the veins in it.
Clear as mudstone?