WARP¶

CONTENTS

TimeWarp structure
Suffixes
Backward Compatible Time Warping

TimeWarp structure ¶

structure TimeWarp¶

TimeWarp allows you to control and query the KSP game’s time warping abilities. You can obtain the TimeWarp structure by using the TimeWarp suffix of kuniverse.

Members and Methods¶
Suffix	Type	Get/Set	Description
`RATELIST`	`List` of `Scalar` values	Get	returns either `RAILSRATELIST` or `PHYSICSRATELIST` depending on which matches the current mode.
`RAILSRATELIST`	`List` of `Scalar` values	Get	The list of allowed multiplier rates for on-rails-warp modes.
`PHYSICSRATELIST`	`List` of `Scalar` values	Get	The list of allowed multiplier rates for physics-warp modes.
`MODE`	`String`	Get/Set	Time warp mode. values are “PHYSICS” or “RAILS”.
`WARP`	`Scalar`	Get/Set	Time warp integer index. Values go 0,1,2,3, etc.
`RATE`	`Scalar`	Get/Set	The current multiplier timescale rate (i.e. 100 for 100x warp)
`WARPTO`	None	Callable method	Call to warp forward to a known timestamp.
`CANCELWARP`	None	Callable method	Cancel current warping (including `WARPTO`)
`PHYSICSDELTAT`	`SCALAR`	Get	Physics Delta-T. How much time should pass between ticks.
`ISSETTLED`	`Boolean`	Get	True once the actual rate finally arrives at the commanded rate.

Suffixes ¶

TimeWarp:RATELIST¶

Access:	Get
Type:	`Scalar`

If MODE is “PHYSICS”, this will return PHYSICSRATELIST. If MODE is “RAILS”, this will return RAILSRATELIST.

It’s always the list that goes with the current warping mode.

TimeWarp:RAILSRATELIST¶

Access:	Get
Type:	`List` of `Scalar` values

The list of the legal values that the game lets you set the warp rate to when in “on rails” warping mode (“normal” time warp).

(As of this writing of the documents, the values come out like the table below, but the base KSP game could change these at any time. The following table is not a guarantee.)

RAILS WARP RATE LIST¶
WARP	RATE
0	1x
1	5x
2	10x
3	50x
4	100x
5	1000x
6	10000x
7	100000x

TimeWarp:PHYSICSRATELIST¶

Access:	Get
Type:	`List` of `Scalar` values

The list of the legal values that the game lets you set the warp rate to when in “physics warp” warping mode.

(As of this writing of the documents, the values come out like the table below, but the base KSP game could change these at any time. The following table is not a guarantee.)

PHYSICS WARP RATE LIST¶
WARP	RATE
0	1x
1	2x
2	3x
3	4x

TimeWarp:MODE¶

Access:	Get/Set
Type:	`String`

The string value indicating whether we are in “PHYSICS” or “RAILS” warping mode right now. You can set this value to change which warp mode the game will perform.

(Any experienced player of KSP should be aware of what the difference between physics warp and “time warp” (rails) is. In “physics” warp, all the normal things work, and the game simulates the entire physics engine with longer coarser delta-T time steps to achieve a faster simulation rate. In “rails” warp, many of the calculations are not working, the vessel is not controllable, and the game calculates positions of objects based on the Keplerian elliptical parameters only.)

TimeWarp:WARP¶

Access:	Get/Set
Type:	`Scalar`

Time warp as an integer index. In the tables listed above for RAILSRATELIST and PHYSICSRATELIST, this is the number on the lefthand side of those tables. (i.e. if MODE is “RAILS” and RATE is 50, then that means WARP is 3.)

If you set either WARP or RATE, the other will change along with it to agree with it. (See the full explanation in RATE below).

TimeWarp:RATE¶

Access:	Get/Set
Type:	`Scalar`

The current multiplier timescale rate (i.e. 1000 if current rate is 1000x as much as normal, etc).

If you have just changed the time warp, it takes a few moments for the game to “catch up” and achieve the desired warp rate. You can query this value to find out what the current rate is the game is operating under during this physics tick. It often takes almost a whole second of game time to finally arrive at the destination rate.

When you set the :RATE equal to a new value, then instead of directly setting the rate to that value, kOS will set the WARP to whatever value it would need to have to end up with that rate. The rate itself won’t change right away. For example, the following two commands are equivalent:

// This will eventually give you a rate of 100, after several
// update ticks have passed, but not right away:
set kuniverse:timewarp:warp to 4.

// This will *also* do the same thing, and not set the rate
// to 100 right away, but instead tells kOS indirectly
// to set the WARP to 4, so as to target a destination
// rate of 100.
set kuniverse:timewarp:rate to 100.

If you set the rate to a value that isn’t on the allowed list that the KSP game interface normally lets you pick, then kOS will pick whichever WARP value will get you closest to the requested rate. For example:

// If you do any of these, then the effect is the same:
set kuniverse:timewarp:rate to 89.
set kuniverse:timewarp:rate to 145.
set kuniverse:timewarp:rate to 100.
// Because the game only allows permanent rates of 1,5,10,50,100,1000, etc.
// A rate of 100 was the closest match it could allow.

Note, the game is actually capable of warping at arbitrary rates in between these values, and it does so temporarily when transitioning to a new warp rate, but it doesn’t allow you to hold the rate at those in-between values indefintiely.

TimeWarp:WARPTO(timestamp)¶

Access:	Method
Parameters:	timestamp – `Scalar`
Returns:	None

Call this method to warp time forward to a universal time stamp. The argument you pass in should be a universal timestamp in seconds. Example: To warp 120 seconds into the future: kuniverse:timewarp:warpto(time:seconds + 120).

Obviously this alters the values of WARP and RATE while the warping is happening.

TimeWarp:CANCELWARP()¶

Access:	Method
Returns:	None

Call this method to cancel any active warp. This will both interupt any current automated warp (such as one using WARPTO or the “Warp Here” user interface) and a manual warp setting (as if you had used the SET WARP TO 0. command).

TimeWarp:PHYSICSDELTAT¶

Access:	Get
Type:	`Scalar`

Physics Delta-T. How much time should pass between ticks. Note this is not the actual time that has passed. For that you should query time:seconds regularly and store the timestamps it returns, and compare those timestamps. This value is just the “expected” physics delta-T that you should get if everything is running smoothly and your computer can keep up with everything the game is doing.

This value changes depending on your physics warp. Note, if you query it during on-rails warping, it can return some very strange values you shouldn’t trust.

TimeWarp:ISSETTLED¶

Access:	Get
Type:	`Boolean`

When you have just changed the warp speed, the game takes time to “catch up” and achieve the new desired speed. (i.e. if you change your rate from 100x up to 1000x, and you look at the screen, you will see the numbers in the display saying things like “Warp 123x” then “Warp 344x” then “Warp 432x”, etc. There are several “ticks” during which the warp hasn’t yet achieved the desired 1000x level.) This can take a “long” time in computer terms to happen.

You can query this value to find out whether or not the actual warp rate has finally settled on the desired amount yet.

For example:

set kuniverse:timewarp:mode to "RAILS".
set kuniverse:timewarp:rate to 1000.
print "starting to change warp".
until kuniverse:timewarp:issettled {
    print "rate = " + round(rate,1).
    wait 0.
}
print "warp is now 1000x".

// The above would output something like this to the screen:
starting to change warp.
rate = 113.5
rate = 143.2
rate = 213.1
rate = 233.2
rate = 250.0
rate = 264.1
rate = 301.5
rate = 320.5
rate = 361.5
rate = 391.3
rate = 421.5
rate = 430.0
rate = 450.5
rate = 471.5
rate = 490.1
rate = 501.5
rate = 613.5
rate = 643.2
rate = 713.1
rate = 733.2
rate = 750.0
rate = 764.1
rate = 801.5
rate = 820.5
rate = 861.5
rate = 891.3
rate = 921.5
rate = 930.0
rate = 950.5
rate = 971.5
rate = 990.1
rate = 1000
warp is now 1000x.

Backward Compatible Time Warping ¶

Time warping is accomplished using the TimeWarp structure described above on this page.

But, for backward compatibility, the following shortcut bound names exist as aliases for the functionality in the TimeWarp structure.

WARPMODE¶

This is identical to MODE above.

// These two do the same thing:
SET WARPMODE TO "PHYSICS".
SET KUNIVERSE:TIMEWARP:MODE TO "PHYSICS".

// These two do the same thing:
SET WARPMODE TO "RAILS".
SET KUNIVERSE:TIMEWARP:MODE TO "RAILS".

WARP¶

This is identical to WARP above.

// These do the same thing:
SET WARP TO 3.
SET KUNIVERSE:TIMEWARP:WARP to 3.

WARPTO(timestamp)¶

This is identical to WARPTO above.

// These two do the same thing:
WARPTO(time:seconds + 60*60). // warp 1 hour into the future.
KUNIVERSE:TIMEWARP:WARPTO(time:seconds + 60*60).

WARP¶

TimeWarp structure¶

Suffixes¶

Backward Compatible Time Warping¶

TimeWarp structure ¶

Suffixes ¶

Backward Compatible Time Warping ¶