DSPAddPlanet

For other languages of this README, please refer to

中文說明

DSP Add Planet

CAUTION

BACKUP YOUR SAVE FILE FIRST

It's currently UNRESTORABLE after using this mod.

And BACKUP YOUR CONFIG FILE if you are already using this mod.

This mod is NOT COMPATIBLE with Galactic Scale 2 and will be DISABLED if launch with Galactic Scale 2.

Introduce

This mod allows you add new planets to your existing saved games (and modify original planets or birth point if you know what you are doing).

The first time you install this mod and lauch the game, a config file will be generated in your save file directory (see below), then you can edit the config file to add new planets (or modify original planets).

To add or modify planets, you will need some information about original planets in your game, I made a small tool to make it easier to get those information, you can press V to open the star map and click the 'Add Planet' button on the bottom-right corner to open the tool.

In the tool, stars are listed in the left panel, click on it to view info about planets in that star system, include planet's index, orbitIndex, orbitAround, number etc. The current star system is on the top of all.

You can click 'Copy' button on the right to copy the uniqueStarId to your clipboard.

A 'unqiueStarId' is a string composed of an optional save name, cluster string and star name, which can basically uniquely identify a star.

Read 'Config file' section below on how to add planets in the config file.

After finishing editing the config file, exit game, BACKUP YOUR SAVE FILE, then re-launch the game, load the save file you just add planets to.

Then you should be able to see new planets (and modified planets) in your game.

Note that auto-saves have the same name as your last loaded game (though it's not displayed in the menu), so it's fine to use auto-saves.

Config file

Config file location

The config file lies in your game's save file directory, in a sub-directory named 'modData/IndexOutOfRange.DSPAddPlanet', file name 'config.xml'.

For example C:\Users\administrator\Documents\Dyson Sphere Program\Save\modData\IndexOutOfRange.DSPAddPlanet\config.xml

Planet order

New planets will be added in the same order as they are written in the config file.

Format

For old txt format please to Old README

Since version 0.1.0, the config file has changed to an xml file. It's basic structure is displayed below. Old.txt file can still be read but without new features.

Since version 0.2.0 the config file splitted into two parts: and

Generally, planets' UniqueStarId does not have a 'GameName', these configurations have lower priority but will be applied to any saved game or new game which has the same cluster string and star name, while planets in must have a UniqueStarId with a proper GameName, these configurations have higher priority than planets, but will only be applied to named existing saved games.

Note that if you create a new game and does save it manually, it's GameName and it's auto saves' GameName will be empty, and configurations in will be applied to it.

configurations -->

The cluster string

The star name

-->

The game name of your save file

The cluster string

The star name

false

4

0

2

3

false

0

0

false

200

3600

3600

true

0

0

true

0

0

Accurate

10

Random

100000

1

0

5

Default

Copper

Parameter descriptions

(required)

a unique id of the target star composed of your save name, cluster string and star name,

for example, if '2_test' is your save name, '44525415-64-A10' is your cluster name,

'Erakis' is the name of the star you want to add new planets to,

then your uniqueStarId will be '2_test-44525415-64-A10-Erakis'

(required/optional)

default value if false.

Whether this planet is the birth planet in this galaxy.

If you are modifying the theme of original birth planet then at least one planet in your configurations must have this option set to true, this is because the birth info of the original birth planet wil