Looks good!
If you have already downloaded SR, then you already have this, but I will paste the relevant details copied from the included readme below:
Code:
How to author GAN scripts (province files):
===========================================
It is assumed that you are familiar with map commands and map editing. The
format is pretty simple for editing GAN scripts and there are just a few rules
& suggested steps:
1. Look at existing GANs as a guide.
2. You do not need to add #nostart. This is added automatically.
3. You do not need to add #setland or #land. This is handled in the filename. (see below)
GAN FILENAME FLAGS:
-------------------
<Climates>
_HOT_ Hot Zone (southern map)
_CLD_ Cold Zone (northern map)
_TMP_ Temperate Zone (mid map)
<Patterns>
_IS_ ISLAND
_LK_ LAKE
_VC_ VOLCANO
_PN_ PENN
_VL_ VALLEY
_CO_ COAST
_LO_ LOST
<Treatment>
_R_ REPLACE - (#land) Set active prov & kill everyone in it. Used to REPLACE randomly placed units.
_A_ ADD - (#setland) Set active prov. Units added to existing.
_M_ MULTIPLE - More than one of a single province gan may be added to the map file.
_U_ UNIQUE - Once a single instance of the province gan is "picked", it can not be picked again.
<Terrain>
_S/L/N_ Small/Large/Normal
_PLN_ Plains
_SEA_ Sea
_WTR_ Some water
_MNT_ Mountain
_SWP_ Swamp
_WST_ Waste
_FST_ Forest
_FRM_ Farm
_MST_ Many Sites
_DEP_ Deep
_CAV_ Cave
_FS_ Fire Site
_AS_ Air Site
_WS_ Water Site
_ES_ Earth Site
_SS_ Astral Site
_DS_ Death Site
_NS_ Nature Site
_BS_ Blood Site
_PS_ Priest Site
_EMT_ Edge Mountain
SPECIAL GAN COMMANDS:
---------------------
@<value> <command>
->select a random line from the following <value> lines to follow this <command>.
Example #1:
@3 commander
"Minotaur Lord"
240 -- Priest
-- no commander
Result= "#commander 240 -- Priest" <- 1 in 3 chance to be printed in map file.
Example #2:
@1 landname
"Icky Swamp"
Result= "#landname <province#> "Icky Swamp" <- 100% chance to be printed in map file.
Example #3:
@2
#mag_astral 1
#mag_fire 1
Result= "#mag_fire 1" <- 1 in 2 chance to be printed. Note the space following "2 ".
Example #4:
@2 units
10 17 -- Archer
-- no Archer
Result= "-- no Archer" <- 1 in 2 chance to be printed. ie 50% chance of these units.
@RANDOM <command> <name or item list>
->select a random name or item to follow <command>.
Example #1:
@RANDOM landname FOREST
Result= "#landname <prov#> "Simple Woods"" <- Rnd name from DATA1 + rnd name from DATA2.
OR
Result= "#landname <prov#> "Ohmyg Forest"" <- Generated name + rnd name from DATA2.
Example #2:
@RANDOM comname COMMANDER
Result= "#comname "Kullray"" <- Generated name.
Example #3:
@RANDOM comname COMMANDER
@RANDOM additem HELMET
@RANDOM additem 1HANDWEAPON
@RANDOM additem SHIELD
@RANDOM additem ARMORHVY
@RANDOM additem BOOTS
@RANDOM additem MISCITEM
Result= <- Random item from the named item list.
#additem "Starshine Skullcap"
#additem "Jade Knife"
#additem "Weightless Tower Shield"
#additem "Silver Hauberk"
#additem "Boots of Stone"
#additem "Bracers of Protection"
(NOTE: I recommend only 1 or 2 MISC items as duplicates are possible!)
In a nutshell there are the flags used in the filename for pattern/terrain matching and flags for add/replace and multi/unique. Plus the following two structures:
@<value> <command>
@RANDOM <command> <name or item list>
A list of the current name & item lists can be pulled from "\LIST_CRATE\NameList.txt". The user should probably be given the option to select from the list or to enter a custom selection to allow for future additions or their own creations.
Oops, I was going to email this to you, but eh. I am a walking zombie tonight.
