Skip to content

Latest commit

 

History

History
346 lines (234 loc) · 9.9 KB

README.md

File metadata and controls

346 lines (234 loc) · 9.9 KB
Raw

Sigma Dimensions

The Universal Rescale Mod for KSP, adopted by R-T-B with permission for changes under Sigma's ARR license. Original work is ARR, but future changes are now permitted and PR's welcome.

Proof of adoption:

prrof

Downloads

Other Links

How To Report A Bug

To report a bug or to ask for support, open an issue on GitHub.

How To Install

To install the mod manually, follow these instructions:

1. Install Manually

  • Remove any other version of the mod.
  • Unzip the archive directly into the folder 'KSP\GameData'

2. Uninstall manually

  • Delete the folder 'KSP\GameData\SigmaDimensions'

License

All Rights Reserved

Settings

SigmaDimensions
{
}

This is the settings node, it is provided by the mod and should be edited using ModuleManager patches.

The SigmaDimensions settings node contains both Base and Advanced settings:

Base Settings Definitions

  • Resize, <double>, default value = 1, Can be set to any positive number.

    Planetary Radius is multiplied by this value.

The mass of each body is changed to maintain the same surface gravity.

  • Rescale, <double>, default value = 1, Can be set to any positive number.

    Orbit size (SemiMajor Axis) is multiplied by this value.

  • Atmosphere, <double>, default value = 1, Can be set to any positive number.

    Atmosphere height is multiplied by this value.

  • dayLengthMultiplier, <double>, default value = 1, Can be set to any positive number.

    Rotation period is multiplied by this value.

Does not affect tidally locked bodies.

Advanced Settings Definitions

  • landscape, <double>, default value = 1, Can be set to any positive number.

    Altitude of geographical features is multiplied by the "Resize" and "landscape" parameters.

  • geeASLmultiplier, <double>, default value = 1, Can be set to any positive number.

    Surface gravity is multiplied by this value.

  • resizeScatter, <double>, default value = 1, Disabled if set to zero.

    ENABLED:  ground scatter size is multiplied by the "Resize" parameter.
DISABLED: ground scatter size is not modified.

Ground scatter density is always adjusted to account for the different surface area.

  • resizeBuildings, <double>, default value = 1, Automatic when zero, custom when set to a positive number.

    AUTOMATIC: buildings size is multiplied by "Resize" when shrinking planets.
CUSTOM:    buildings size is multiplied by this parameter.

  • groundTiling, <double>, default value = 1, Can be set to any positive number.

    Ground textures tiling is multiplied by this parameter.

  • CustomSoISize, <double>, default value = 0, Enabled if set to any positive number.

    ENABLED:  Sphere of Influence is multiplyed by this parameter.
DISABLED: Sphere of Influence is multiplyed by the "Rescale" parameter.

Affects only bodies with the Sphere of Influence defined in their config file.

  • CustomRingSize, <double>, default value = 0, Enabled if set to any positive number.

    ENABLED:  rings size is multiplyed by this parameter.
DISABLED: rings size is multiplyed by the "Rescale" parameter.

  • atmoASL, <double>, default value = 1, Can be set to any positive number.

    Atmospheric pressure at surface level is multiplied by this parameter.

  • tempASL, <double>, default value = 1, Can be set to any positive number.

    Surface temperature is multiplied by this parameter.

  • atmoTopLayer, <double>, default value = 1, Can be set to any positive number.

    Atmosphere height is multiplied by this parameter. Atmosphere curves are extended/trimmed accordingly.

  • atmoVisualEffect, <double>, default value = 1, Can be set to any positive number.

    The height of the atmosphere aesthetics is multiplied by this parameter.

  • lightRange, <double>, default value = 1, Can be set to any positive number.

    The distance component of light intensity curves is multiplied by the "Rescale" and "lightRange" parameters.

  • scanAltitude, <double>, default value = 1, Can be set to any positive number.

    Altitude limits for orbital scanners is multiplied by the "Resize" and "scanAltitude" parameters.

  • scienceAltitudeThreshold, <double>, default value = 1, Can be set to any positive number.

    Altitude limits for the border between low and high space is multiplied by "scienceAltitudeThreshold", and the square root of "Resize" times "Rescale".

  • debug, <bool>, default value = false

    When 'true' fills the file output_log.txt with debug information

Planet Specific Changes

To apply Planet Specific Changes follow these instructions.

1. Create a .cfg file with the following code in it

@Kopernicus:BEFORE[SigDim2]:NEEDS[SigDim]
{
    @Body:HAS[#name[PLANET_NAME_HERE]]
    {
        @SigmaDimensions
        {
            @PARAMETER = VALUE
        }
    }
}

2. Replace PLANET_NAME_HERE with the name of the planet you want to change

3. Replace PARAMETER with the name of the parameter you want to overwrite

4. Replace VALUE with the value you want to assign to the parameter

5. You can edit as many parameters as you want

6. Save the .cfg file anywhere in your KSP GameData folder

7. Do not mess this up. Everything will break.

PQSCity_Groups

PQSCity_Groups
{
}

This is the root node, you can add as many as you want, and they can be modified using ModuleManager patches.

The PQSCity_Groups root node contains the groups definitions:

  • GROUP

    PQSCity_Groups
{
    GROUP
    {
    }
}

    This node is used to define a group, you can add as many GROUP nodes as you want.

    Every GROUP node contains four general settings and three nodes:

    • name, <string>, required

      The name of the group

    • body, <string>, required

      The name of the body on which the group is found

    • debug, <bool>, default value = false

    When 'true' fills the file output_log.txt with debug information


    NOTE: Groups with the same name found on the same body will be merged and considered as one.


    • CENTER

      PQSCity_Groups
{
    GROUP
    {
        CENTER
        {
        }
    }
}

      This node is used to define the center of the group.

      The center can be defined in many different ways, the first valid option will be chosen.

      • CentralPQSCity, <string>, the name of the central PQSCity mod
      • CentralPQSCity2, <string>, the name of the central PQSCity2 mod
      • CentralPosition, <Vector3>, the position of the center defined in a 3D space
      • CentralLAT, <double>, the latitude of the center (requires CentralLON)
      • CentralLON, <double>, the longitude of the center (requires CentralLAT)


      NOTE:

      If the node CENTER is not defined, or the positions defined are not valid, the central position will be defined as the position of the first valid PQSMod of the group


    • MODS

      PQSCity_Groups
{
    GROUP
    {
        MODS
        {
        }
    }
}

      This node is used to list all PQSMods included in the group.

      The PQSMods that are currently supported are:

      • PQSCity, <string>, the name of the PQSCity mod
      • PQSCity2, <string>, the name of the PQSCity2 mod


    • MOVE

      PQSCity_Groups
{
    GROUP
    {
        MOVE
        {
        }
    }
}

      This node is used to define a new central position,

      all mods in the group will be moved around this new center

      The new center can be defined in many different ways, the first valid option will be chosen.

      • CentralPQSCity, <string>, the name of the new central PQSCity mod
      • CentralPQSCity2, <string>, the name of the new central PQSCity2 mod
      • CentralPosition, <Vector3>, the position of the new center defined in a 3D space
      • CentralLAT, <double>, the latitude of the new center (requires CentralLON)
      • CentralLON, <double>, the longitude of the new center (requires CentralLAT)

      In addition to the position of the new center, it is possible to define:

      • Rotate, <double>, angle in degrees, the whole group will be rotated around the center
      • fixAltitude, <double>, meters, added to the altitude of each mod in the group
      • originalAltitude, <double>, meters, needed if the base is designed for a different planet


      NOTE:

      1- If the positions defined for the new center are not valid the group will not be affected

      2- Groups centered around the KSC should not be moved using this feature,
           use the SpaceCenter feature from Kopernicus