Often loaded by the autoconfig.cfg file, this script creates the array "mapcycle" with the cycle of maps, separated by semicolons (;).
Here an example of loading a few maps:
It is noteworthy that maps here can be either PNG's (.png), KAG (.kag) or Generator (.cfg) files. KAG map files will allow you to save 'happenings' not saveable by the png format (mainly exact locations of things and how broken a block is). Generator files will allow you to create maps that look fairly similar, but are different every time since noise is used to create them.
For example, a Map cycle with two maps that are initialized in .kag files would look like this:
On the other hand, a Map Cycle that uses a generator file will look like this:
When loading maps, the game starts looking from
kagServer/Base. If a map is not located located in the Base folder, then you will need to add directory for where the map is located before the file itself. For organizational purposes, it is recommended to create any subfolders (as needed) in the
kagServer/Base/Maps directory rather than leaving map files in the base folder or Maps folder (especially if you are running multiple servers on the same machine)
You may use a mixture of PNGS, KAG or Generator files, but make sure that you use the correct extension of the file when listing it. If the extension is not correct, it will not find it nor load it.
If a file can not be found, it will skip onto the next file that it can find. If none of the files can be found, it will load the default generator.