AMASTER

 Program was written by Michal Korzycki and Piotr Winiarczyk.
 (c) 1996-2005 Version 3.10g
 Version release date : 2005-01-25 00:44

 This is universe master program for VGA-Planets game.
 It is intended to be portable and open source.

 NEVER give unedited amaster.log file to players since there is random seed
 inside. Universe is completly described by this number. Having this number
 player can recreate it.

 Amaster is mainly designed for Phost games with Explore Map add-on
 using AllowWraparoundMap = Yes. To change configuration parameters
 in order to make Amaster create universe MASTER 3.02 compatibile, see
 pmaster.cfg file from putil or pdk archive from http://www.phost.de

 Usage: amaster [options] [GameDirectory [RootDirectory]]
 Valid options:
       -h      -- Print help and exit.
       -v      -- Print version and exit.
       -c      -- Print command line strings.
       -l      -- Don't create log file.
       -w      -- Don't create wormholes.
       -m      -- Don't create map.
       -u      -- Don't fix map checksums.
       -p      -- Show progress in map creation and validation or in test mode. (MSDOS only)
       -i      -- Display homeworld near-far planets, native cash or minerals info.
       -t      -- Display post mastering statistics.
       -g      -- Display Homeworlds finding algorithm statistics.
       -n      -- Display each player planet(s) IDs.
       -d      -- Display each player planets, bases and ships number.
       -r      -- Don't show total run time.
       -a      -- Don't write message to players.
       -s seed -- Use seed in random generator.
       -f name -- Use file name as config file.
                 ( One can make AMASTER section in pconfig.src file )
       -z        -- Test mode ON. Tests provided map or configuration.
       -y number -- Number of tests in test mode. Default is 50.
       -x number -- Number of planets displayed in test mode summary. Default is 20.
       -o ID     -- ID of one of the Homeworlds in test mode.
       -3        -- PHOST3 support. Create universe for PHOST3 game.
       -k name.pgm -- Use name.pgm file as map creation mask.

 Files needed by Amaster to create universe.

 To create universe one must place following files in GameDirectory or
 RootDirectory: beamspec.dat, engspec.dat, hullspec.dat, torpspec.dat,
 truehull.dat, planet.nm, race.nm. The amaster.src should be placed in
 GameDirectory. When universe map is not created, the xyplan.dat should be
 present in GameDirectory or RootDirectory. Amaster will also try to read
 pconfig.src from GameDirectory. When there is no pconfig.src file or
 NumShips prameter is not set (Phost 3) number of ships is set to 500.

 Notes on test mode.

 Test mode is for checking maps or configuration. If Amaster is not
 generating map and it is using user provided map it may happen that
 same planets are choosen more often than others for Homeworlds.
 Host person should avoid such situations because same player can find
 this out and have advantage in game. If it happens tune Homeworld finding
 algorithm or consider change of game design. Use -p option to show
 progress in testing (works only on MSDOS platform). Using -o option one
 can provide one or more Homeworlds IDs, and test how offen such IDs are
 choosen and if so, which planets are choosen for Homeworlds too.
 In test mode you can also specify -g or -t flags to get various
 stastistic information about created universes. (new in 3.10)
 One can also gather same statistical information (again -g -t options)
 when Amaster creates maps or when ProvideHomeworld=Yes. In those cases
 no information about choosen Homeworlds IDs is displayed, so -g or -t
 option is obligatory.

 While displaying Map creation process symbols are used:

 '*' - map was created
 '#' - finding stars not in WraparoundRectangle
 '' - finding stars with distance smaller than given in config
 'X' - checking and fixing planet X coordinates sum
 'Y' - checking and fixing planet Y coordinates sum

 While displaying Test Mode progress symbols are used:

 '+' - test succesfully completed
 '=' - test completed but HW with ID set by -o option not found.
 '-' - test not completed, too many iterations

 When displaying IDs of player planet(s) symbols are used:

 'H' - planet is a Homeworld
 'B' - planet has base

 Homeworld finding algoritm parameters (new in version 3.0).

 MaxMapCounter    - How many times map can be created.
 MaxPlanetCounter - How many times planets minerals/natives are created
                    for each map.
 MaxHWCounter     - How many times Amaster try to find homeworld for
                    for each map and each planets setting.

 Maximal number of try to find homeworlds is
 MaxMapCounter*MaxPlanetCounter*MaxHWCounter.
 During that search, map is created MaxMapCounter times,
 planets are created MaxMapCounter*MaxPlanetCounter.


MaxMapCounter     = 20
MaxPlanetCounter  = 100
MaxHWCounter      = 50000

 All parameters described as 'arrayzed' can be in two forms.
 Short eg. RaceIsPlaying = Yes
 It means that 'Yes' is valid for all races.
 Long  eg. RaceIsPlaying = Yes,No,Yes,Yes,No,Yes,Yes,No,Yes,Yes,Yes
 Each race must have individual setting.

 RaceIsPlaying is arrayzed.
              1    2    3    4    5    6    7    8    9    10   11
RaceIsPlaying= Yes, No , No , No , No , No , No , No , No , No , No


 All 9 parameters (except BorderWidth) listed below have exactly
 same meaning as in Phost pconfig.src file. Look into Phost documentation
 for more deep explanation. Amaster sametimes uses them for
 other purposes.
PlayerRace              = 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11
MapTruehullByPlayerRace = Yes

 If AllowWraparoundMap is Yes  - when placing the Homeworlds the distance
 "across" the border of the map will also be taken in consideration.
 BorderWidth is a historic parameter when there was no wrap map
 implemented in Phost and sometimes hosts use 'wrap border zone'
 for same reasons. BorderWidth set to 0 is a recommended choice for
 Phost 3.2 or newer.

AllowWraparoundMap  = Yes
WraparoundRectangle = 1000, 1000, 3000, 3000
BorderWidth         = 0

 Set this parameter to Yes if the Crystal homeworld is to have a temperature
 of 100 rather than 50, as for the other homeworlds.
 All 4 below parameters are used only when AdjustPopulation = Yes.
CrystalsPreferDeserts   = Yes
CrystalSinTempBehavior  = No
ClimateLimitsPopulation = Yes
MaxColTempSlope         = 1000

 Set the initial passwords for each player. Passwords may be up to 10
 characters in length. To indicate that no password should be used, set
 the password to 'none'.
Password1=none
Password2=none
Password3=none
Password4=none
Password5=none
Password6=none
Password7=none
Password8=none
Password9=none
Password10=none
Password11=none

 Here one select the mineral composition of non-homeworld planets.
 The 8 elements of the PlanetSurfaceRanges array is interpreted as follows:
            Nmin, Tmin, Dmin, Mmin, Nmax, Tmax, Dmax, Mmax
 The actual amount of a mineral found on a planet's surface will be
 randomly distributed between 'min' and 'max' limits. For example, if
 Nmin=0 and Nmax=1000, then each planet's surface will have anywhere
 from 0 to 1000 KT of Neutronium.

 MASTER 3.02 - Random normal settings.
PlanetSurfaceRanges= 0, 0, 0, 0, 250, 50, 40, 25

 Density is also specified as Nmin, Tmin, Dmin, Mmin, Nmax, Tmax, Dmax, Mmax.
 Note that density must be in the range 1 through 100.

 MASTER 3.02 - Random normal settings.
PlanetDensityRanges=10, 10, 10, 10, 100, 100, 100, 100

 Selecting the composition of minerals in the core of planets is a bit more
 complicated. You specify two sets of ranges, the "usual" range (umin-umax)
 and the "alternate" range (amin-amax). Then, you specify the frequency
 with which a given mineral will be chosen from the usual range. As before,
 the PlanetCoreRangesUsual and PlanetCoreRangesAlternate parameters are
 8-element arrays in the form :
      Nmin, Tmin, Dmin, Mmin, Nmax, Tmax, Dmax, Mmax.

 For example, for Neutronium you set the usual range to (umin=100,
 umax=1000) and the alternate range to (amin=2000, amax=10000). You set
 the usual range frequency to 80. Then, on 80% of the planets, the
 amount of in-core Neutronium will be between 100 KT and 1000 KT. On the
 remaining 20 of the planets, the amount of in-core Neutronium will be
 between 2000 KT and 10000 KT.
 MASTER 3.02 - Random normal settings.

PlanetCoreRangesUsual     = 0, 0, 0, 0, 700, 500, 500, 200
PlanetCoreRangesAlternate = 700, 500, 500, 200, 12000, 12000, 12000, 12000

 Percent chance of usual range
PlanetCoreUsualFrequency  = 75, 80, 85, 85

 Now you select the characteristics of natives on planets. The
 NativesOnPlanetFrequency parameter indicates the percentage of planets that
 are to have natives. For example, setting it to 60 means that 60 of
 the planets will have natives (this is the default MASTER 3.02 setting).
NativesOnPlanetFrequency  = 60

 The NativeTypeFrequencies array allows you to control the relative
 frequency of the different kinds of natives (Bovinoid, Humanoid, etc.)
 Each element of this 9-element array must be a number from 0 to 100 that
 is only meaningful in comparison to the other numbers. Two elements from
 this array indicate the relative frequency of occurrence of the corresponding
 native types. For example, if element 1 (Humanoids) is 10 and element 2
 (Bovinoids) is 20, then there will be twice as many planets with Bovinoids
 as Humanoids.
 Setting one item to 0 means that this native type will never appear.
 Default MASTER 3.02 behavior is equal probability for all native types
 except for Humanoids and Siliconoids which are half as likely as the others.
 The native types are coded:
  1 -- Humanoid
  2 -- Bovinoid
  3 -- Reptilian
  4 -- Avian
  5 -- Amorphous
  6 -- Insectoid
  7 -- Amphibian
  8 -- Ghipsoldal
  9 -- Siliconoid

                      1   2   3   4   5   6   7   8   9
NativeTypeFrequencies=50, 50, 50, 50, 100, 50, 50, 50, 50

 The NativeGovFrequencies array has the same format as NativeTypeFrequencies
 except that it applies to government types.
 Default MASTER 3.02 behavior is equal probability for all native governments
 except for Anarchy and Unity which are half as likely as the others.
 The government types are coded :
  1 -- Anarchy
  2 -- Pre-tribal
  3 -- Early Tribal
  4 -- Tribal
  5 -- Feudal
  6 -- Monarchy
  7 -- Representative
  8 -- Participatory
  9 -- Unity

                     1   2   3   4   5   6   7   8   9
NativeGovFrequencies=25, 50, 50, 50, 75, 50, 50, 50, 25

 The NativeRange has two elements, min and max, which indicate the
 minimum number and maximum number of natives for planets that have
 natives. The actual number of natives is chosen uniformly from this range.
 Note that these are thousands, the actual native population is 1000 times
 bigger. Default MASTER 3.02 behavior (approximate).
NativeRange=2, 9000

 Both parameters control starting happyness of natives and colonists
 in the moment of universe creation. If not defined later natives
 and colonist will have such happiness on all planets.
DefaultNativesHappy  = 80
DefaultColonistHappy = 80

 Set the number of planets that each race will start with. Configurable for
 each race. Default is 1, giving player only Homeworld planet.
 When OwnedPlanets=0 and FreeShips=Yes all ships for given player are
 generated in the same random point of universe.

 OwnedPlanets is arrayzed
              1    2    3    4    5    6    7    8    9    10   11
OwnedPlanets=  1

 Set the number of bases that each race will start with. Configurable for
 each race. Placed first on the Homeworlds and successively on the next
 planets.

 OwnedBases is arrayzed
              1    2    3    4    5    6    7    8    9    10   11
OwnedBases   = 1

 Initialy bases are created on planets nearest Homeworlds, but
 if needed they can be randomly moved to other player planets.
 BaseHopsNumber parameter describes number of trys of such moves.
BaseHopsNumber = 0

 BaseHopsFactor parameter sets probability of movement for base.
 Once base for movment is choosen and destanation planet is known
 there is certain probability to move base.
 Probablility = exp ( - DistanceToNewPlanet/BaseHopsFactor)
 When DistanceToNewPlanet = BaseHopsFactor
 Probablility = exp ( - 1 ) = 36.8
 Bigger values make bases hops ( jumps ) more frequent.

 Same numerical examples for BaseHopsFactor = 100

 DistanceToNewPlanet  Probability
    ( LY )              (  )
          10             90.5
          50             60.7
         100             36.8
         150             22.3
         200             13.5

BaseHopsFactor = 100

 One can limit distance from bases to Homeworld. BaseHopsLimit is minimal and
 maximal distance for planets to have base. BaseHopsLimit is in percentage
 of distance to the most distant planet owned by race (MaxPlanetDistance).
 Setting BaseHopsLimit = 0, 100 allow all player planets to have bases,
 while BaseHopsLimit = 25, 50 allows only planets nearer then
 MaxPlanetDistance* 50 /100.0 LY and more than
 MaxPlanetDistance* 25 /100.0 LY from Homeworld.
 Since BaseHopsLimit works only with base reassigment algorithm it is
 possible to have bases outside this limit. They were not moved during
 reassigment phase or reassigment was not done at all (BaseHopsNumber = 0).
BaseHopsLimit  = 0, 100

 While planets with bases are no longer the most closest to Homeword
 it is imposible to say which base will be assigned to which planet.
 See Planet1,..,Planet99 and HomePlanet1,..,HomePlanet99 parameters.
 When BindPlanetsToBases = Yes, Planet1 will be bind with nearest
 to Homeworld base, Planet2 to second nearest base... Next nearest
 non-base planet will be assigned to next free PlanetXX parameter,
 and so on.

 Example:
 OwnedPlanets = 7
 OwnedBases   = 3

 Shortly we describe Planet1 as P1, base 1 as B1
 PH  - Planet with Homeworld, BH - Homeworld base
 [ ] - No planets outside this range can have base.
       BaseHopsLimit defines those limits.

 1. BaseHopsNumber=0 - no base reassigment

         [           ]
    PH P1 P2 P3 P4 P5 P6
    BH B1 B2
    +-------------------------------->
    0                 Distance to Homeworld

 2. BaseHopsNumber not 0 - base reassigment
    BindPlanetsToBases = No

         [           ]
    PH P1 P2 P3 P4 P5 P6
    BH    B1    B2
    +-------------------------------->
    0                 Distance to Homeworld

    There is no way to tell which planet will have base.

 3. BaseHopsNumber not 0 - base reassigment
    BindPlanetsToBases = Yes

         [           ]
    PH P3 P1 P4 P2 P5 P6
    BH    B1    B2
    +-------------------------------->
    0                 Distance to Homeworld

    Now nearest to Homeworld base will have Planet1 settings
    base 2 will have Planet2 settings, then first to Homeworld
    non-base planet will get first not used planet number - Planet3.
    Next one will be Planet4 and the last one Planet5.

 4. BaseHopsNumber not 0 - base reassigment
    BindPlanetsToBases = Yes

         [           ]
    PH P1 P3 P4 P2 P5 P6
    BH B1       B2
    +-------------------------------->
    0                 Distance to Homeworld

    Base 1 is outside BaseHopsLimit. It may happen when base 1
    did not made any hops. One or more hops will bring base 1 into
    BaseHopsLimit range.


BindPlanetsToBases = Yes


 Base reassigment procedure:
 Start- done once for one player:
  * Find possible planets for bases considering BaseHopsLimit.
 Main loop
  * Randomly find player base (not Homeworld).
  * Find player planet with no base and allowed for base.
  * Measure distance - DistanceToNewPlanet.
  * Compute Probability.
  * If Random(100) < Probability move base to new planet else do nothing.
  * Repeat all BaseHopsNumber times for each player.

 Set the natives to be found at planets that player will start with.
 First number is native type - NatType, second natives government
 type - GovType, then natives number in clans - NatClans,
 then natives happines - NatHappy, and finaly natives tax - NatTax.
 Planet1 - means the nearest planet to  Homeworld, Planet2 - second
 non-homeworld planet etc.. For native races codes look at the
 NativeTypeFrequencies table. Set 0 for no natives, -1 to randomly set
 natives type, -2 to don't change natives on planet (in case of no natives,
 there will be no natives on this planet, note the difference to 0).
 If natives type is set to value in range 1 - 9 and GovType is set
 to -1 natives government will be choosen randomly.
 One can define government by setting value from range 1 to 9,
 see NativeGovFrequencies table for NatType codes.
 If NatClans is set to -1 number of natives will be set randomly,
 else NatClans will be initial natives population.
 NatHappy = -1 will make natives happiness be set to DefaultNativesHappy.
 NatTax  = -1 will set natives tax to 0 (default value). All randomly
 set values will be choosen with universe default distribusions.
 New function of Planet1.. parameters is introduced in version 3.9
 Valid entries Planet1, Planet2,... ,Planet99

 Example:

 OwnedPlanets = 3
 OwnedBases   = 1
 Planet1      = 4, -1, 60000, 80, 0
 Planet2      = 0,  0,     0,  0, 0

 Players will get at start 3 planets, one with homeworld base,
 second with Avian natives with government randomly choosen having
 6000000 natives on planet with happiness of 80 and taxes set to 0.
 Third planet will have no natives.

 End of example.

        NatType, GovType, NatClans, NatHappy, NatTax
Planet1=      -2,       0,       0,         0,      0
Planet2=      -2,       0,       0,         0,      0


 HomePlanet1, ... , HomePlanet99 parameters describe starting planets
 number of clans, mines, factories, defence, cash, supplies,
 colonist happines, colonist tax. New in version 3.7
 HomePlanet1 is a planet nearest to Homeworld, etc.
 DefaultHomePlanet defines default starting planet parameters.

               Clans Mines Fac. Defence  Cash Supp Happy Tax
HomePlanet1   = 1000,  10,  100,    5,     0,   0,   80,   0
HomePlanet2   = 1000,  10,  100,    5,     0,   0,   80,   0

                   Clans Mines Fac. Defence  Cash Supp Happy Tax
DefaultHomePlanet = 1000,  10,  100,    5,     0,   0,   80,   0

 This parameter sets on or off checking of Amorphous natives on
 HomePlanets. If set to Yes and Amorphous are present they are deleted.
NoAmorphousOnHomePlanets = No

 Setting AllOwnedPlanetsTheSame to Yes will make Amaster search for
 first player that has HomePlanet #1 (the closest to Homeworld).
 Then this planet is copied to next player HomePlanet #1, and so on
 till last player with HomePlanet #1 is processed. Then Amaster will look
 for HomePlanet #2 and whole procedure is repeated. All HomePlanets
 are processed this way. Summing up, all HomePlanet #1 for all players
 are the same, all HomePlanet #2 for all players are the same...

AllOwnedPlanetsTheSame  = No

 If AllPlayerPlanetsTheSame = Yes HomePlanet #1 is copied to Home Planet #2,
 Home Planet #3 etc. Such procedure is done for each player.
 As result each player has same planets, but planets owned by different
 players can be different.
AllPlayerPlanetsTheSame = No

 Setting AllPlayerPlanetsTheSame = Yes AND AllOwnedPlanetsTheSame = Yes
 will make HomePlanets globally the same. Use Planet1 and HomePlanet1
 to control same of the settings of those planets.


 New in version 3.5
 Homeworld have temperature 50 F (or 100 F for Tholians/Crystals).
 If BioSupport = No temperature is random number from range 0 to 100.
 When BioSupport is on, temperature for normal planet is taken
 from range PlanetsTempRange. For initially owned planets it is taken from
 OwnedPlanetsTempRange. Probability of each temperature in that regions
 can be not equal (see BioSupportLevel parameter).
BioSupport          = Yes


 For BioSupportLevel=0 all temperatures from PlanetsTempRange or
 OwnedPlanetsTempRange have equal probability.
 As not normalized probability function P for temperature T Amaster uses :
 P(T) = BioSupportLevel*sin(3.1415*(T-PlanetsTempRange[0])/TempRange)
        +(100-BioSupportLevel)
 where TempRange = PlanetsTempRange[1]-PlanetsTempRange[0].
 Bigger values gives more planets with temperature closer to mean.
 Allowed values are from 0 to 100. Initialy owned planets temperatures
 are given by this probability too. In this case
 TempRange = OwnedPlanetsTempRange[1]-OwnedPlanetsTempRange[0].
BioSupportLevel     = 50


 Temperature range of normal planets when BioSupport = Yes
PlanetsTempRange    = 0, 100


 Temperature range of initialy owned planets when BioSupport = Yes
OwnedPlanetsTempRange = 15, 84


 If natives population is bigger than max population on planet
 (due to temperature) adjust population to maximum allowed
 for that temperature.
AdjustPopulations   = Yes

 Set the minimal distance between homeworlds - The Homeworlds will be placed
 randomly on the map with at least HomeworldsRadius LY between them.
 Large values (above 500 LY) can make it hard to find.
HomeworldsRadius    = 100

 HomeworldsRange is active when AllowWraparoundMap = No.
 This parameter sets area where homeworlds can be located,
 so preventing homeworlds to be to near universe border.
 Default values are computed from WraparoundRectangle by adding
 or subtracting HomeworldsRadius/2. Each race now got circle
 of radius HomeworldsRadius/2 with planets to colonize.
 Idea by Daniel Bruedigam.
HomeworldsRange     = 1200, 1200, 2800, 2800

 Host can turn off homeworld finding algorithm by setting
 ProvideHomeworlds parameter to Yes. Homeworlds planets
 Id's are taken from Homeworlds parameter in such case.
 No mine, cash, or any other checking is done.
 If race is not playing put 0 as homeworld planet id.
ProvideHomeworlds = No

              1   2   3   4   5   6   7   8   9  10  11
Homeworlds =   1,  2,  3,  4,  5,  6,  7,  8,  9, 10, 11


 MASTER 3.02 - Very high homeworld population settings.

 HomeworldClans is arrayzed.
             1    2    3    4    5    6    7    8    9    10   11
HomeworldClans=30000

 MASTER 3.02 - Very high starting money.

 HomeworldCash is arrayzed.
              1    2    3    4    5    6    7    8    9    10   11
HomeworldCash=15000


 These arrays indicate the amount of minerals to place in the core of each
 homeworld, and on the surface. Each array is indexed by race.

 MASTER 3.02 - Homeworlds extra rich settings.

 All HomeworldCore, HomeworldSurface and HomeworldDensity are arrayzed.
                    1     2     3     4     5     6     7     8     9     10    11
HomeworldCoreN     = 4000
HomeworldCoreT     = 2000
HomeworldCoreD     = 3500
HomeworldCoreM     = 1650

HomeworldSurfaceN  = 2000
HomeworldSurfaceT  = 300
HomeworldSurfaceD  = 350
HomeworldSurfaceM  = 150

HomeworldDensityN  = 20
HomeworldDensityT  = 20
HomeworldDensityD  = 15
HomeworldDensityM  = 95


  Homeworld starting Mines, Factories, Defence, Supplies.
  HomeworldMines, HomeworldFactories, HomeworldDefence, HomeworldSupplies
  HomeworldColonistTax and HomeworldColonistHappy are arrayzed.
  New in version 3.7

                        1     2     3     4     5     6     7     8     9     10    11
HomeworldMines         = 100
HomeworldFactories     = 150
HomeworldDefence       = 100
HomeworldSupplies      = 1000
HomeworldColonistTax   = 7
HomeworldColonistHappy = 80


 Bases control

 BaseFreeDefence, BaseFreeFighters are arrayzed

BaseFreeDefence            = 10
BaseFreeFighters           = 20


 Setting one or more of below parameters to yes will make
 free parts to be stored in homeworld base.
 BaseFreeHulls, BaseFreeEngines, BaseFreeBeams and BaseFreeTorps
 BaseFreeTorps are arrayzed.

 BaseFreeHulls = Yes
 * 1  ship in race slot 1
 * 1  ship in race slot 2

 BaseFreeEngines = Yes
 * 4  Impulse Drive (StarDrive 1) engines
 * 2  Dimetrans Drive (StarDrive 3) engines

 BaseFreeBeamss = Yes
 * 8  Kill-O-Zap (X-Ray Laser) beams

 BaseFreeTorps = Yes
 * 3  Fusion Bomb (Proton torp) tubes
 * 20 Fusion Bomb (Proton torp) torpedoes

BaseFreeHulls              = Yes
BaseFreeEngines            = Yes
BaseFreeBeams              = Yes
BaseFreeTorps              = Yes


 If AllBasesTheSame = Yes and more than one base is present,
 all bases are like homeworld base, so can get free defense, fighters,
 parts or tech levels.
AllBasesTheSame            = No

 When set to yes this parameter will make Amaster to change
 non homeworld bases tech levels to 10 if natives on this planet
 gives such tech levels.
AdjustBasesTechs           = Yes

 This array indicates the starting engine tech for each one of the Homeworlds.
 Each element must be in the range 1 through 10.

 StartingEngineTech, StartingHullTech, StartingBeamTech,
 StartingTubeTech are arrayzed.
                    1  2  3  4  5  6  7  8  9 10 11
StartingEngineTech = 7
StartingHullTech   = 1
StartingBeamTech   = 1
StartingTubeTech   = 1


 Free ships.
 Ships are placed on orbit of Homeworld.
 When FreeShipsOnBases = Yes each player bases will get same
 free ships as Homeworld. FreeShipsOnBases is arrayized.
FreeShips           = No
FreeShipsOnBases    = No

 This is number of ships on one base, so when FreeShipsOnBases=Yes
 total number of player ships will be FreeShipsNumber * OwnedBases[player]
 FreeShipsNumber is arrayized.
FreeShipsNumber     = 2

FreeShipsAllTheSame = No

 If FreeShipsAllTheSame = No each race will get ships in standard way
 (one ship with first hull allowed for race, one with second allowed
 hull and so on).
 If FreeShipsAllTheSame = Yes all races get ships with below hull numbers.
 For hull codes look to Phost doc, file hullfunc.htm, List of Hulls section.
 17 is 'LARGE DEEP SPACE FREIGHTER' or in PList 'HANSA CLASS LARGE TRANSPORT'.
 Up to 20 hull ids can be defined in FreeShipsHull parameter.
FreeShipsHull      = 17

 More free ship control can be achived with ship templates and race ships
 parameters.

 Ship templates are defined with four numbers : hull number, engine, beam,
 tubes tech levels, number of beams, number of tubes.
  If value is unset or set to -1 FreeShipsHull, FreeShipsEngines,
 FreeShipsBeams, FreeShipsTubes value or maximal possible number of beams
 or tubes will be used.
 Some examples:
 Ship1 = 104,9,9,9,1,1
 Ship2 = 105,1
 Ship3 = -1,9,-1,7,-1,0

 RaceXXShipYY parameters partialy override FreeShipsHull or
 FreeShipsAllTheSame actions. RaceXXShipYY parameters has two modes.
 First mode is used to define ship with template number.
 Example : Race1Ship2 = Ship1
 Exaplanation : Use ship template 1 (Ship1) as race 1 ship 2. So if
 FreeShipsAllTheSame = Yes and FreeShipsHull=17 and FreeShipsNumber = 4
 race 1 will have 4 ships with hulls 17, 104, 17, 17
 All other races will have hulls 17, 17, 17, 17
 If FreeShipsHull=1,2,3 race 1 will have hulls 1, 104, 3, 1
 All other races will have hulls 1, 2, 3, 1

 Second mode for RaceXXShipYY setting parameter is similar to ship definition
 in ship templates.
 Example : Race1Ship2 = 100,2,-1,10,-1,2
 Explanation : in 2nd ship of race 1 hull with id 100, engines of tech 2,
 default beams tech level (value of FreeShipsBeams), torps of 10th tech,
 maximal number of beams allowed by hull and two torp tubes will be used.
 More examples of RaceXXShipYY parameters:
 Race1Ship1 = 56,1,2,3,4,5
 Race1Ship2 = Ship1
 Race2Ship1 = Ship2
 Race2Ship2 = 56,1
 Race2Ship3 = -1,1


 Default free ships equipment tech levels.

FreeShipsEngines   = 6
FreeShipsBeams     = 6
FreeShipsTubes     = 6


 Free ammo for ships (fighters or torpedos).

FreeShipsAmmo      = 20


 Engines are coded :
       PLIST                      STD LIST
       -------------------        -------------------
  1 -- Impulse Drive              StarDrive 1
  2 -- Linear Drive               StarDrive 2
  3 -- Dimetrans Drive            StarDrive 3
  4 -- Dimesexta Drive            SuperStarDrv 4
  5 -- Metagrav Drive             Nova Drive 5
  6 -- Enerpsi Drive              HeavyNova Drv 6
  7 -- Interuniversal Drive       Quantam Drive 7
  8 -- Improbability Drive        Hyper Drive 8
  9 -- Bistromatic Drive          Transwarp Drive

 Beams are coded :
       PLIST                      STD LIST
       -------------------        -------------------
  1 -- Laser Cannon               Laser
  2 -- Kill-O-Zap                 X-Ray Laser
  3 -- Desintegrator              Plasma Bolt
  4 -- Phaser                     Blaster
  5 -- Disruptor                  Positron Beam
  6 -- Electron Ram               Disruptor
  7 -- Ion Cannon                 Heavy Blaster
  8 -- Turbolaser Battery         Phaser
  9 -- Inpotron Cannon            Heavy Disruptor
 10 -- Multitraf Spiral           Heavy Phaser

 Torpedoes are coded :
       PLIST                      STD LIST
       -------------------        -------------------
  1 -- Space Rocket               Mark 1
  2 -- Fusion Bomb                Proton Torp
  3 -- Paralyso-Matic Bomb        Mark 2
  4 -- Initial Bomb               Gamma Bomb
  5 -- Photon Torp                Mark 3
  6 -- Graviton Bomb              Mark 4
  7 -- Arkon Bomb                 Mark 5
  8 -- Antimatter Bomb            Mark 6
  9 -- Katalysator Bomb           Mark 7
 10 -- Selphyr-Fataro-Dev.        Mark 8



 Parameters used to make equal start for each race.

 Number of planets that Homeword should have near (NearSearchRadius)
 and far (FarSearchRadius). This helps to make fair start for all.
 No more 0 planet in 84 LY circle, and 10 by your enemy homeworld.

NearFarPlanetCheck = No

 Minimal and maximal number of planets in 1 to NearSearchRadius LY
 from Homeworld.
NearPlanetsNo      = 1, 5
NearSearchRadius   = 84

 Minimal and maximal number of planets in 1 to FarSearchRadius LY
 from Homeworld.
FarPlanetsNo       = 5, 15
FarSearchRadius    = 165


 Check for planets NativeCashSearchRadius LY or less from Homeworlds
 with natives. Estimate income from natives. Tax rate is computed to make
 natives happines change of 0.

 Formulas used:
 NatTax = (5.0 + PlanetNatGovm/2.0 - sqrt ( PlanetNativePopulationClans/10000.0))/0.85
 if (PlanetNatType==Avian) NatTax+=10.0/0.85
 Cash = ((PlanetNativePopulationClans*PlanetNatGovm*NatTax+2500.0)/5000.0)
 if (PlanetNatType==Insectoid) Cash*=2
 if (PlanetNatType==Amorphous) Cash=0
 NatCashFromOnePlanet=((Cash*NativeTaxRateForRace+50.0)/100.0)

 Starting from Amaster v3.0 NativeTaxRateForRace=100.0 for each race.
 Starting point should be independent of race abilities.

NativeCashCheck = No


 Minimal and maximal cash from all planets to accept Homeworld.

NativeCash = 1000, 4000


 At what radius from Homeworld take planets with natives for cash computing.

NativeCashSearchRadius = 165


 Check for minerals expected to mine from planets in range MineSearchRadius.
 For each mineral formulas are used (example counts Tritanium on one planet):

 MineRate = 200.0 * 100.0 * PlanetDensity(TRITANIUM)/10000.0
 if (PlanetNatType==Reptilian) MineRate*=2.0
 MineTurns= PlanetCore(TRITANIUM)/MineRate
 if (MineTurns>MaxMineTurns) MineTurns=MaxMineTurns
 MineTitaniumFromOnePlanet = MineTurns*MineRate

 '200.0' is a expected number of mineral mines on planet.
 '100.0' is race mining rate, same argument as for NativeTaxRateForRace=100.0
 MaxMineTurns is number of turns to count average mining.
 MineTitaniumFromOnePlanet is sumed for all planets in range MineSearchRadius
 and MineTitaniumAllPlanets/MaxMineTurns is compared to MineTritanium first
 number (minimum) and MineTritanium second argument (maximum).

 Meteors and meteors showers are not counted.
 MineTurns variable gives us resonable number of turns to dig out
 all minerals from planet.

MineCheck        = No
MineTritanium    = 150, 900
MineDuranium     = 100, 600
MineMolybdenium  = 50, 400
MineSearchRadius = 165
MaxMineTurns     = 20


 Wormhole generation routine is based upon code from:
 PWORMGEN   Version 2.1
 Author: Edward Winkelman

  General wormholes generator settings.

CreateWormholes             = No
WormholeNumber              = 25


  Maximal number of iteration of wormhole generation code,
  this limit prevents endless loops.

MaxWormholesCounter         = 10000



 Amaster specific settings for wormhole generation procedure.
 One can prevent wormholes being near homeworlds.
 If NoWormholesNearHomeworlds = Yes, wormholes cannot be nearer than
 MinWormHomeDistance to homeworlds.

NoWormholesNearHomeworlds   = Yes
MinWormHomeDistance         = 100

 If NoWormholesNearPlanets = Yes, wormholes cannot be nearer than
 MinWormPlanetDistance to any planet.

NoWormholesNearPlanets      = Yes
MinWormPlanetDistance       = 10


 Minimal distance between any two wormholes (exit and entrance is checked).

MinWormholesDistance        = 50


 Minimal length of wormhole (distance between exit and entrance).

MinWormholeLength           = 50



 PWORMGEN settings.


 WormholeUniDirChance/100 is probability that wormhole is unidirectional
 Valid values 0 - 100
WormholeUniDirChance        = 20


 WormholeStartMoveChance/100, WormholeEndMoveChance/100 is probability
 that wormhole start/end will move.
 Valid values 0 - 100
WormholeStartMoveChance     = 20
WormholeEndMoveChance       = 20


 Wormhole start, end range

WormholeStartRange          =  1000, 1000, 3000, 3000
WormholeEndRange            =  1000, 1000, 3000, 3000


 Wormhole instablility range.
 Valid values 0 - 100, first value < second value
WormholeInstabilityRange    =  0, 30


 Wormhole mass range.
 Valid values 1 - 32000, first value < second value
WormholeMassRange           =  1, 32000


 Map generation section

 Map generation algorithm:
 INIT
 * if PlanetsNumber != 500 randomly find IDs for planets inside
   WraparoundRectangle.
 GENERATION
 * For planets inside WraparoundRectangle X and Y is generated in region
   defined by WraparoundRectangle, exclusive. Planets that should be outside
   got X = WrapMaxX + WrapMinX/2 or X = WrapMinX/2 with 50 probability each.
   Y = WrapMaxY + WrapMinY/2 or Y = WrapMinY/2 with 50 probability each.
 TESTS
 * For planets inside WraparoundRectangle check if X or Y are not in
   WraparoundRectangle range. For planets outside check if they
   are outside. Fix if needed.
 * Check if any two planets are less than PlanetsMinDistance, fix it.
   Ignore planets outside WraparoundRectangle.
 if FixMapChecksums == yes
 {
  * Check X coordinates sum of all planets. If not equal 0xf3d19 fix it.
  * Check Y coordinates sum of all planets. If not equal 0xf4c89 fix it.
 }
 * Try again all TESTS. If all ok, map is ready.

 Fix X and Y checksumes routine is based upon code from:
 Fix map checksums
 by Roger Burton West <roger@firedrake.demon.co.uk>
 Written in c-- in 1997

 Invoking Amaster with -m option will prevent Amaster from
 crating map even if CreateMap = Yes.
 Amaster can read PGM (Portable Grayscale Map) files via -k filename option.
 This PGM file is used as mask for map creation. Each color represents
 probablity that if X and Y is randomly choosen the planet will have those
 X and Y. PGM file width and heigth are scaled to WraparoundRectangle values.
 The map creation process using mask file can be disturbed when
 FixMapChecksums is on. Amaster will display warning in such situation.
 To achive desire map shape invoke Amster with -u option.
 The example of map shape file is in config directory of distribution.
 Copy face.pgm file to game directory and run amaster:
    amaster -u -k face.pgm game_dir
 To create map mask PGM file use this color to probability table :
        Color   "0" - black -   0 probability for this X,Y
        Color "128" - gray  -  50 probability for this X,Y
        Color "255" - white - 100 probability for this X,Y
 All other gray scale values can be used too.

CreateMap                  = Yes

 If 2 planets have distance smaller than PlanetsMinDistance
 one planet is moved.

PlanetsMinDistance         = 6


 Amaster 3.9d can create maps with less than 500 planets. Simply same of
 the planets are created outside WraparoundRectangle.
 When map is not created by Amaster PlanetsNumber is determined from
 map file, overwriting value defined in config file.
PlanetsNumber              = 500

 Early VGA-Planets program requires that sum of all planets X
 coordinate is 0xf3d19. Setting FixMapChecksums to Yes makes Amaster
 to generate maps with X sum of 0xf3d19 and additionaly Y sum of 0xf4c89.
 Since maps with or without such sums are equal, maps with good X and Y
 sums are generated as default. This option works also for maps with
 PlanetsNumber less than 500.
 Invoking Amaster with -u option will prevent Amaster from
 fixing map checksums map even if FixMapChecksums = Yes.
FixMapChecksums            = No


  Ion Storms creation section

  Ion storms are THost specific. Master program found on THost site
  does not generate ion storms on universe creation.
  They start to exist during game. During first few turns
  they are generated with very small voltages (harmless), but
  as game continues they can be introduced to universe being
  more dangerous. Ion storm information in stored in grey.hst file.
  Basic ion storm generator is implemented in Amaster v3.6
CreateIonStorms            = No


  Number of ion storms created by Amaster.

IonStormsNumber            = 5


 Starting X and Y of ion storm center are in range IonStormsCenterRange.
 Heading parameter is choose randomly from range 0 to 359.

IonStormsCenterRange       = 1000, 1000, 3000, 3000


 Initial ranges for ion storms voltage and radius.

IonStormsVoltageRange      = 1, 100
IonStormsRadiusRange       = 10, 150

 If NoIonStormsNearHomeworlds = Yes, ion storms center cannot
 be nearer than MinIonStormsHomeDistance to any homeworld.

NoIonStormsNearHomeworlds  = Yes
MinIonStormsHomeDistance   = 150


   Version history.

   below v0.96 written by Michal Korzycki

    v0.98 Rewritten to C from C++.

    v1.0  New config reader.
          Near far check.
          Natives cash check.

    v1.1  Random seed control.
          Homeworld search progress display.

    v1.2  Wormhole generator.
          Map generator and validator.

    v2.0  Minerals check.
          Portability.

    v2.1  Near, Far search radius.
          2 bugs fixed in config reader.

    v2.2  Statistics: -t option.

    v2.3  Freeships.

    v2.4  Base Control.
          AuxData saved.

    v2.5  2 bugs found by Degi. Thanks.
          Free ammo for free ships.
          All HW tech levels can be set.

    v3.0  New fast homeworld search algoritm. Idea by Degi.

    v3.1  Homeworld density parameters, statistic improved.

    v3.2  Parameters of mineral ranges can be fully configured.

    v3.3  Same minor bugs.
          Config parameters are range checked.
          More statistic.

    v3.4  Few bugs corrected.
          New wormhole generator parameters.

    v3.5  BioSupport procedure changed.

    v3.6  Ion Storms for THost.

    v3.7  Better Homeworld and Homeplanets control.

    v3.8  Up to 100 Homeplanets, host can pick Homeworlds.
          Many small changes.

    v3.9  New format of PlanetXX parameters. More bases control.
          Maps with less than 500 planets.

    v3.10 32-bit random number generator.
          Test mode for testing maps and configurations.
          PHOST4 support.
          Map creation mask PGM file can be used.
          Better free ships control


This is a testing version.
It may be incomplete, and have more bugs (or features) than the public live version at planetscentral.com.