= Quick Summary =
Duplicate the "default" folder in this directory and all its contents, rename it to something else.  Inside schematics folder swap out the schematic files for the biomes you want.  You'll now have a new "theme" you can use when exporting to minecraft.

= Introduction =
The minecraft exporter for Terra Firma 2 is designed to be customisable.  Each folder in this directory is a "Theme", which is a preset that configures how the world will be exported to minecraft.  To modify this, copy the "default" folder and rename it to something else- you should now have an additional Theme option when exporting from Terra Firma 2.

The themes are hot loaded each time the minecraft export interface is opened.  Any additional themes or changes to existing themes should be reflected in a subsequent export- you do not have to close Terra Firma 2 and reopen it.

= Files =
Inside the themes folder there are-

file: config.nbt
This is the configuration file for the theme.  NBT is the data format used by minecraft, there are plenty of free NBT editors that you can use to inspect/change this file.  Format follows below.

folder: schematics
This is where you place schematic (.schem) files, which are files that define objects to be added to the world, such as trees or plants.  You can use a tool such as https://beta.cubical.xyz/ to produce these files, or https://www.planetminecraft.com/ to find existing schematic files.  Only version 2 of the schematic file format is currently supported.

folder: datapacks
Any files or folders inside this folder will be copied into the datapacks folder in the created world.  This allows you to add datapacks that will be included in the exported world, allowing a lot of customisation.  The default theme has one datapack already, that creates a custom biome for the exporter.  There is one other datapack that is automatically generated by the exporter, which extends the maximum height of the world if the terrain requires it.

= Config File Format =
The config file is a compound tag containing two entries:

== biomes ==
Contains an entry for each biome, valid values are "forest", "grasslands", "hot_desert", "jungle", "mangrove_swamp", "marsh", "nothing", "oasis", "savanna", "swamp", "taiga".
Each entry contains the following tags:
  minecraft_id: a string of the minecraft biome for this biome
  trees: optional list of plants that will be written into the world in the tree generation spots.  Trees are spaced out randomly but roughly 5 blocks from each other.
  shrubs: optional list of plants that will be written into the world in the shrub generation spots.  Shrubs are generated on the top of every single block.

== plants ==
Each entry is a plant or collection of plants that can be referenced by the biomes.
Each entry has a single text value within it, one of the following:
  schematic: the path within the schematics folder to load a single schematic file
  folder: the path within the schematics folder to load all the schematics inside a folder.  The final plant will be randomly chosen from these
  single_block: the minecraft id of a single block to place