Distribution.ini

Distribution.ini is a file in the main game that defines a number of facts and hierarchies about the way the star map is created and populated. It affects the spawning and distribution of stars, planets, and items. Even quests and fleets are controlled in part by distribution.ini

Distribution.ini is split into several sections. They are:

  • STARCLASSES - lists and enables the different classes of stars to be used in the game, such as "redgt" or "blhole".
  • PLANETCLASSES - lists and enables the different classes of planets to be used in the game, such as "grassland" or "gasgiant". This section also assigns each planet class a letter code, which is used in the PLANETDIST section later in distribution.ini.
  • ITEMDISTFLAGS - lists and enables the 5 different item distribution flags.
  • PLANETDIST - consists of a list of the star classes from STARCLASSES above, each followed by a 10-digit string of letter codes corresponding to the codes in PLANETCLASSES. The game uses this to pick what types of planets can orbit each star type.
  • PLANETITEMS - defines which item distribution flags go with which planet classes.
  • SCORECLASSES - lists and enables the score classes in the game, defining the categories for scoring, and determining how they appear at the mission debriefing at the end of the game.
  • MAPSIZE - these three code blocks correspond to the three sizes of maps, and define the sizes and stats of the map, how many aliens and quests are on the star map, additional score modifiers, etc. See MAPSIZE block for more information.

Adding new planets, stars, etc.

If you add custom stars to your mod, you'll need to make sure they correspond to categories in STARCLASSES and PLANETDIST. If they don't, you'll need to add appropriate entries to those sections. Not doing so can cause your mod to crash in some situations.

If you add custom planets to your mod1, you'll need to make sure they correspond to categories in PLANETCLASSES and PLANETDIST. If they don't, you'll need to add appropriate entries to those sections. Not doing so can cause your mod to crash in some situations.


Modifying Item Distribution

You also have the option of adding to or modifying STARCLASSES through PLANETITEMS to alter the odds and distribution of your items, stars and planets in your mod. This can result in some very subtle alterations to the tone of your game.2


Altering the Scoring System

If you make new score classes, you'll need to update the list in distribution.ini, and the lists in mission.ini.


Changing the number of races, fleets, allies or events

The MAPSIZE block defines how many races, fleets, allied ships, and events appear on the map. More information may be found at MAPSIZE block.

Unless otherwise stated, the content of this page is licensed under Creative Commons Attribution-ShareAlike 3.0 License