Master
From PlanetsWiki
Contents |
[edit] Overview
Master.exe is an application that comes with the complete package that you download from www.planets4.com. It is used to create new games. You will be able to choose a map to use or a custom VPS script as well as starting homeworld conditions, other planet conditions, races to be in the game, AI players, etc. Files created by this application are stored in the Planets\UNIV\GAMEx (where x is from 1 to 12). They can be modified by the HConfig application. You can look at the upcoming Master 213 changes.
If you're using a script then aware that scripts need to be in Windows format (with Windows formatted line breaks). It's safest to sent them by email in a zip file or similar, and not send them directly. Using a tool like Notepad++ you can also change this format. If your scripted Master takes a long time to run and appears to have only mastered a 'default' universe (possibly with no planets at all), then the likelihood is that your script file is in the wrong format.
[edit] Options
The following options and defaults are valid with Master 203 (coming with Host 210),
[edit] Game Info
| Setting | Default |
|---|---|
| Game Name | Alpha Game |
| Host Name | Tom Servo |
| RST File Name | player |
[edit] Select Races
- TODO
[edit] Starting Positions
- TODO
[edit] Homeworld Levels
| Setting | Min. | Max. | Default |
|---|---|---|---|
| Minerals on Base | None | Extra Abundant | Average |
| Natives | None | Extra Abundant | None |
| Starting Cash | 2,000 | 20,000 | 4,000 |
| Population | 200,000 | 5,000,000 | 300,000 |
| Cargo and Metals | None | Extra Abundant | Above Average |
| Start With 3 Extra Freighters | NO | YES | NO |
| Start With Standard ships | NO | YES | YES |
[edit] Planet Levels
| Setting | Min. | Max. | Default |
|---|---|---|---|
| Minerals In the Ground | None | Extra Abundant | Above Average |
| Natives | None | Extra Abundant | Average |
| Contraband | None | Extra Abundant | Some |
| Cargo and Metals | None | Extra Abundant | Average |
The g_ values refer to the planet levels: 0 (none), 1 (some), 2 (average), 3 (above average), 4 (abundant), 5 (extra abundant)
A real value is finally rounded this way: 1.5 -> 1, 1.51 -> 2, -1.5 -> -2, -1.49 -> -1
Natives
For each type:
- IF RND < 8% THEN
- IF 10 * RND < g_startNative THEN
- Natives = 100k * g_startNative * RND
- ELSE
- IF RND < 20% THEN Natives = 10k * RND
- IF 10 * RND < g_startNative THEN
Climate and HD
- StarType = INT(21 * RND) + 1
- StarHeat = StarType * 5 + RND * 20 - 10 (Min=0, Max=100)
- Climate = StarHeat + RND * 6 - 1.5 (Min=0, Max = 100)
- HD = 500 * RND + 50
- Inertia = RND * 100
- 95% of the time: Delta = RND * 6.5 - 3
- 5% of the time: Delta = RND * 15 + 3
Minerals
- Densities
- easyN = Rnd * 80 + 20
- easyD = Rnd * 90 + 10
- easyT = Rnd * 80 + 10
- easyM = Rnd * 60 + 5
- Surface minerals
- v = 2 * g_startCargo²
- oreN = Rnd * 100 * v + Rnd * 100
- oreD = Rnd * 80 * v + Rnd * 80
- oreT = Rnd * 50 * v + Rnd * 50
- oreM = Rnd * 20 * v + Rnd * 20
- eleN = Rnd * 10 * v + Rnd * 100
- eleD = Rnd * 80 * v + Rnd * 100
- eleT = Rnd * 50 * v + Rnd * 50
- eleM = Rnd * 20 * v + Rnd * 50
- Core
- v = g_startMineral² + 1
- resN = Rnd * 300 * (v + 1)
- resD = Rnd * 250 * (v + 1)
- resT = Rnd * 250 * (v + 1)
- resM = Rnd * 150 * (v + 1)
- With chance of
- 1/20: resN = 5000 + Rnd * 30000 * g_startMineral
- 1/22: resD = 5000 + Rnd * 25000 * g_startMineral
- 1/25: resT = 5000 + Rnd * 17000 * g_startMineral
- 1/28: resM = 5000 + Rnd * 10000 * g_startMineral
Food, med units and supplies
- Food = 150 * Rnd + 50
- Med = Rnd * Food
- If Rnd < 0.3 And g_startCargo > 1 Then Supplies = Rnd * 100
Contraband
For each type:
- If Rnd * 35 < 1 + g_startContraband Then
- contra = 10 * Rnd * g_startContraband
- If Rnd < 0.18 Then contra = 500 + Rnd * 500
[edit] Command Line
If you already have a script, you can also run Master.exe from command line without the user interface:
Master scriptfile.vps yigfile.yig /bovgx scriptfile.vps = including full pathname to the script (scripts are usually in %planetsdir%\scripts\) yigfile.yig = including full pathname to the universe(yig)-file (in %planetsdir%\univ\GAMEX\) /b: Batch File Mode: No GUI will be displayed /o: Overwrite YIG: An existing YIG will not abort Master /v: Verbose Logging: Additional log file information /g: Store master.log file with game file /x: Exit GUI automatically
See Game Mastering with Scripts (PDF) or the more recently updated scripting section, for all the possibilities
[edit] Example
Master C:\Planets4\scripts\Samplescript.vps C:\Planets4\univ\GAME4\game4.yig /ox
[edit] CLI vs GUI
Note that when you use the command line instead of the GUI, then there are certain differences in how master will function. If you use the command line then master requires that you provide the details of each planet unless you provide values in the "Begin Start" section of the VPS script. You can always override the random values given to the planets by setting them to 0 or another value of your choice. Homeworlds will not start with the normal random values unless you provide values in the "Begin Start" section. Objects will not have random values assigned unless starting positions are defined in the "Begin Start" section.
[edit] See Also
- Master Item Distributions Give Numbers for Homeworld & Planet Levels for their corresponding words.
- Game Mastering with Scripts (PDF),
- Starting Ships Matrix
- Resources on Starting Ships Matrix
- Starting Buildings
- Starting Homeworld Resources
- Scripting
- Host

