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.

    
        
            
                
                    
                    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