Configuration - Geocube101/Iota-Modular-Jump-Gates GitHub Wiki

The configuration file can be found in the world's local storage folder. This page covers each of the options and what they do. Most of the block specific options have an entry for both large and small grid variants. Those will be excluded here for simplicity

Capacitor Configuration


MaxCapacitorChargeMW

The maximum possible charge this capacitor can hold in megawatts.

Default: 1000 Large, 200 Small
Can Be NaN/INF: False/False
Range: [1,INF)

MaxCapacitorChargeRateMW

The maximum possible rate of charge of this capacitor in megawatts per second.

Default: 12.5 Large, 2.5 Small
Can Be NaN/INF: False/False
Range: [0,INF)

CapacitorChargeEfficiency

The power transfer efficiency of capacitors when charging.

Default: 0.95 Large, 0.8 Small
Can Be NaN/INF: False/False
Range: [0,1]

CapacitorDischargeEfficiency

The power transfer efficiency of capacitors when discharging.

Default: 0.75 Large, 0.5 Small
Can Be NaN/INF: False/False
Range: [0,1]

Drive Configuration


DriveRaycastDistance

The maximum distance (in meters) a drive can raycast to check gate intersections.

Default: 250 Large, 50 Small
Can Be NaN/INF: False/False
Range: [0, INF)

DriveRaycastWidth

The maximum offset (in meters) in which drive raycast rays are considered to be overlapping.

Default: 2.5 Large, 0.5 Small
Can Be NaN/INF: False/False
Range: [0, INF)

MaxDriveChargeMW

The maximum possible charge this drive can hold in megawatts.

Default: 100 Large, 25 Small
Can Be NaN/INF: False/False
Range: [1,INF)

MaxDriveChargeRateMW

The maximum possible rate of charge of this drive in megawatts per second.

Default: 10 Large, 2 Small
Can Be NaN/INF: False/False
Range: [0,INF)

DriveIdleInputWattageMW

The base power draw of drives in megawatts when idle.

This is the value used when this drive is not part of a jump gate or this drive's jump gate is not outbound.

Default: 50 Large, 15 Small
Can Be NaN/INF: False/False
Range: (0,INF)

DriveActiveInputWattageMW

The base power draw of drives in megawatts when active.

This is the value used when this drive's jump gate is outbound.

Default: 75 Large, 45 Small
Can Be NaN/INF: False/False
Range: (0,INF)

DriveChargeEfficiency

The power transfer efficiency of drives when charging.

Default: 0.99 Large, 0.95 Small
Can Be NaN/INF: False/False
Range: [0,1]

Jump Gate Configuration


MinimumJumpDistance

The minimum distance (in meters) below which a destination cannot be jumped to by a gate.
Should not be larger than MaximumJumpDistance.

Default: 5000 Large, 2500 Small
Can Be NaN/INF: False/True
Range: [0,INF]

MaximumJumpDistance

The maximum distance (in meters) above which a destination cannot be jumped to by a gate.
Should not be smaller than MinimumJumpDistance.

Default: +INF Large, +INF Small
Can Be NaN/INF: False/True
Range: [0,INF]

UntetheredJumpEnergyCost

The factor by which to multiply the calculated power usage for untethered jumps.
GPS coordinates and beacons are considered untethered.

Default: 1.05 Large, 1.10 Small
Can Be NaN/INF: False/True
Range: [0,INF]

GateDistanceScaleExponent

The exponent directly responsible for calculating the ratio between distance and gate size.
This value is calculated using "MaxJumpGate50Distance" and setting it manually has no effect.
For calculating maximum distance given gate size: DISTANCE = ((JUMP_GATE_SIZE ^ GATE_SCALE_EXPONENT) * 1000) + MINIMUM_JUMP_DISTANCE
For calculating gate size given maximum distance: JUMP_GATE_SIZE = CEIL(((DISTANCE - MINIMUM_JUMP_DISTANCE) / 1000) ^ (1 / GATE_SCALE_EXPONENT))

MaxJumpGate50Distance

The maximum jump gate reachable distance (in meters) for a 50 drive jump gate
This is used as a baseline for calculating all other jump gates' values
This value is the "Max Reasonable Distance" for a jump gate with 50 drives.
A gate's reasonable distance is the maximum distance a jump gate can jump such that it's power factor doesn't exceed 1

Default: 100,000,000 Large, 20,000,000 Small
Can Be NaN/INF: False/False
Range: [0,INF)

GatePowerFactorExponent

The exponent 'b' used for power factor calculations: (a * x - a) ^ b + 1
Where:

  • a = The gate's power falloff factor
  • x = The gate's distance ratio
  • b = This value (1 is linear)
    Specifies how quickly the power factor changes given how close a large grid gate is to its reasonable distance
    Should not be less than 1 (though it is possible, the math may get weird)

Default: 3 Large, 3 Small
Can Be NaN/INF: False/False
Range: [0,INF)

GatePowerFalloffFactor

The value 'a' used for power factor calculations on jump gates: (a * x - a) ^ b + 1
Where:

  • a = This value
  • x = The gate's distance ratio
  • b = The gate's power factor exponent (1 is linear)
    Specifies the narrowness of the curve, higher values result in a narrower curve
    Negative values flip power curve - closer distances cost more

Default: 1 Large, 1 Small
Can Be NaN/INF: False/False
Range: (-INF,INF)

GateKilowattPerKilogram

The power (in kilowatts) required gate to jump one kilogram of mass

Default: 0.1 Large, 0.25 Small
Can Be NaN/INF: False/False
Range: [0,INF)

GateRandomOffsetPerKilometer

The maximum distance (in kilometers) per kilometer of travel an endpoint can be offset by if untethered
Example: Jumping 100 kilometers with this value at 0.01 means a random offset of 1 kilometer from the endpoint

Default: 0.01 Large, 0.05 Small
Can Be NaN/INF: False/False
Range: [0,INF)

GateKilometerOffsetPerUnitG

The maximum distance (in kilometers) per unit of gravity 'g' an endpoint will be offset by if untethered
Example: Jumping to 5g gravity with this value at 1 will offset the destination 5 kilometers toward the gravity source if untethered

Default: 5 Large, 10 Small
Can Be NaN/INF: False/False
Range: (-INF,INF)

IgnoreDockedGrids

If false, grids docked to the jump gate inside it's jump space will have constraints (landing gear, connectors, etc...) destroyed during jump
If true, grids docked will be ignored

Default: false
Can Be NaN/INF: NA
Range: NA

ChargingDriveEffectorForceN

The force (in Newtons) applied to every drive in a jump gate away from the jump node when the gate is charging.

Default: 1000 Large, 250 Small
Can Be NaN/INF: False/False
Range: (-INF,INF)

MaxConcurrentJumps

The maximum number of total jumps that are allowed at a time.
Useful for servers trying to limit their CPU usage.
Set to 0 for infinite concurrent jumps.

Default: 50 if server, 0 otherwise
Can Be NaN/INF: NA
Range: [0,4294967295]

ConfineUntetheredSpread

Whether ships jumping to an untethered destination have randomness applied to each ship or once per the entire fleet.

Default: false
Can Be NaN/INF: NA
Range: NA

Construct Configuration


RequireGridCommLink

If true, gates can only see other gates connected via antennas or part of the same construct.

Default: true
Can Be NaN/INF: NA
Range: NA

MaxTotalGatesPerConstruct

The maximum number of jump gates a single construct can have.< br /> Useful for servers trying to limit their CPU usage.
Set to 0 for infinite gates per construct.

Default: 3 if server, 0 otherwise
Can Be NaN/INF: NA
Range: [0,4294967295]

MaxLargeGatesPerConstruct

The maximum number of large grid jump gates a single construct can have.< br /> Useful for servers trying to limit their CPU usage.
Set to 0 for infinite gates per construct.

Default: 3 if server, 0 otherwise
Can Be NaN/INF: NA
Range: [0,4294967295]

MaxSmallGatesPerConstruct

The maximum number of small grid jump gates a single construct can have.< br /> Useful for servers trying to limit their CPU usage.
Set to 0 for infinite gates per construct.

Default: 3 if server, 0 otherwise
Can Be NaN/INF: NA
Range: [0,4294967295]

General Configuration


DebugLogVerbosity

Sets the verbosity level of debug information in the log file.

Default: 3
Can Be NaN/INF: NA
Range: [0,5]

DrawSyncDistance

The maximum distance (in meters) in which clients will be shown debug draw and gate particles.

Default: 5000
Can Be NaN/INF: False/True
Range: [500,INF]

LenientJumps

If false, grids partially outside the jump space will be sheared.
When false, a warning will appear indicating if a grid is partially outside the jump space. At the conclusion of the charging animation, all marked blocks will be destroyed, the grid split, and the part within the jump space will be jumped.

Default: true
Can Be NaN/INF: NA
Range: NA

HighlightShearBlocks

If true, highlights blocks that will be sheared by the jump space.

Default: true
Can Be NaN/INF: NA
Range: NA

SafeJumps

If false, untethered jumps will have randomness applied to endpoint.
SEE: GeneralConfiguration/RandomOffsetPerKilometer

Default: false
Can Be NaN/INF: NA
Range: NA

ConcurrentGridUpdateThreads

The number of concurrent threads to use for construct updates

Default: 3 if server, 1 otherwise
Can Be NaN/INF: NA
Range: [0,255]

SyphonReactorPower

If true, allows jump gates to pull power directly from the reactor if instantaneous power is insufficient.

Default: true
Can Be NaN/INF: NA
Range: NA

⚠️ **GitHub.com Fallback** ⚠️