Oolite JavaScript Reference: SystemInfo - Revision history

Cholmondely: /* Musings */ Added Wildeblood's follow-up comment

2026-06-05T13:20:47Z

‎Musings: Added Wildeblood's follow-up comment

Cholmondely: Added some examples

2026-03-06T08:46:23Z

Added some examples

Cholmondely: Added Wildeblood's comment

2026-03-05T14:51:36Z

Added Wildeblood's comment

Wildeblood: /* setProperty / / setInterstellarProperty */ tweaked

2025-05-07T07:18:56Z

‎setProperty: ‎setInterstellarProperty: tweaked

Wildeblood: Undo revision 85531 by Wildeblood (talk)

2025-05-07T07:15:55Z

Undo revision 85531 by Wildeblood (talk)

Wildeblood: /* setProperty */

2025-05-07T07:13:55Z

‎setProperty

Wildeblood: /* system.info.sun_color */ Removed this well-meaning, but on the wrong page, note.

2025-05-07T06:58:26Z

‎system.info.sun_color: Removed this well-meaning, but on the wrong page, note.

Phkb: Updating BB links

2024-02-29T02:19:32Z

Updating BB links

Cholmondely: Added note on "system.info.sun_color"

2023-03-07T17:54:42Z

Added note on "system.info.sun_color"

Massively Locked: /* galaxyID */ added link

2022-11-08T13:02:44Z

‎galaxyID: added link

← Older revision		Revision as of 13:20, 5 June 2026
Line 121:		Line 121:

	Take the eight government types. Add a government_precise property, then go Dewey decimal in there, specifying in excruciating detail precisely what sub-type of communism Vetitice enjoys. [https://bb.oolite.space/viewtopic.php?p=304290#p304290 Wildeblood (2026)]		Take the eight government types. Add a government_precise property, then go Dewey decimal in there, specifying in excruciating detail precisely what sub-type of communism Vetitice enjoys. [https://bb.oolite.space/viewtopic.php?p=304290#p304290 Wildeblood (2026)]
		+
		+
		+	Or "suppose a hypothetical OXP automated an aspect of the game, and you the player were happy with this in most cases, but not in all cases. Suppose you wanted finer control, in certain systems? You could add a custom property to your planetinfo.plist, something like aita_veto for system 0, 96, which the automation script could check, and be assured that no robot would be choosing your top-hats for you. Hypothetically. This puts system-specific data where it belongs, in systemInfo. [https://bb.oolite.space/viewtopic.php?p=305917#p305917 Wildeblood (2026)]

	=== Examples ===		=== Examples ===

← Older revision		Revision as of 08:46, 6 March 2026
Line 121:		Line 121:

	Take the eight government types. Add a government_precise property, then go Dewey decimal in there, specifying in excruciating detail precisely what sub-type of communism Vetitice enjoys. [https://bb.oolite.space/viewtopic.php?p=304290#p304290 Wildeblood (2026)]		Take the eight government types. Add a government_precise property, then go Dewey decimal in there, specifying in excruciating detail precisely what sub-type of communism Vetitice enjoys. [https://bb.oolite.space/viewtopic.php?p=304290#p304290 Wildeblood (2026)]
		+
		+	=== Examples ===
		+	Root around in the java-scripted entrails of the [[Diplomancy OXP]], the [[World Builder]] OXP, [[Smugglers - The Galactic Underworld]] and many others.

	[[Category:Oolite JavaScript Reference]]		[[Category:Oolite JavaScript Reference]]

← Older revision		Revision as of 14:51, 5 March 2026
Line 115:		Line 115:
	Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.		Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.

		+	== Musings ==
		+	"... there's a lot of unused potential in SystemInfo that has been waiting to be discovered for years"
		+
		+	"It's persistent storage that is much better organized than missionVariables. You can store arbitrary data in there, not just the official properties. If you want to add a property like average_house_price for your real estate agent OXP, you can do that. And once created, that data can be used by several OXPs using the layering, which missionVariables doesn't have.
		+
		+	Take the eight government types. Add a government_precise property, then go Dewey decimal in there, specifying in excruciating detail precisely what sub-type of communism Vetitice enjoys. [https://bb.oolite.space/viewtopic.php?p=304290#p304290 Wildeblood (2026)]

	[[Category:Oolite JavaScript Reference]]		[[Category:Oolite JavaScript Reference]]

@@ Line 72: / Line 72: @@
 === <code>setProperty</code> ===
 {{oolite-method-added|1.81}}
-  function '''setProperty'''(layer: Number, key : String, value: String [, manifest: String])
+  function '''setProperty'''(layer : Number, property : String, value : String [, manifest : String])
 This lets you set properties with more control than provided by writing directly to <code>systemInfo.property</code>. <code>layer</code> is the layer from 0 to 3 that the change should be applied at, as in [[planetinfo.plist]]. Layer 2 is the default layer for Javascript-initiated changes, but 3 may be used for changes absolutely crucial for OXP functionality.
@@ Line 109: / Line 109: @@
 === <code>setInterstellarProperty</code> ===
 {{oolite-method-added|1.81}}
-  function '''setInterstellarProperty'''(galaxy : Number, fromsystem : Number, tosystem : Number, layer: Number, key : String, value: String, [, manifest: String])
+  function '''setInterstellarProperty'''(galaxy : Number, fromsystem : Number, tosystem : Number, layer : Number, property : String, value : String, [, manifest : String])
 This is similar to [[#setProperty|setProperty]] but for setting properties of interstellar space regions. Changes made to the current interstellar space region will only take effect if the player leaves and returns.

@@ Line 72: / Line 72: @@
 === <code>setProperty</code> ===
 {{oolite-method-added|1.81}}
-  function '''setProperty'''(layer: Number, property: String, value: String [, manifest: String])
+  function '''setProperty'''(layer: Number, key : String, value: String [, manifest: String])
 This lets you set properties with more control than provided by writing directly to <code>systemInfo.property</code>. <code>layer</code> is the layer from 0 to 3 that the change should be applied at, as in [[planetinfo.plist]]. Layer 2 is the default layer for Javascript-initiated changes, but 3 may be used for changes absolutely crucial for OXP functionality.

← Older revision		Revision as of 06:58, 7 May 2025
Line 115:		Line 115:
	Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.		Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.

−	~~== <code>system.info.sun_color</code> ==~~
−	~~I'm just a dumb pilot, but the 2018 posts [https://bb.oolite.space/viewtopic.php?p=265497#p265497 here] state that this is a way of changing the sun's colour.~~
−	~~''Eg'':~~
−
−	~~system.info.sun_color="1.0 0.6 0.3"~~
−	~~system.info.sun_color="50 38 185"~~
−	~~system.info.sun_color="yellowColor"~~
−
−	~~for RGB, HSB and named colours~~

	[[Category:Oolite JavaScript Reference]]		[[Category:Oolite JavaScript Reference]]

@@ Line 116: / Line 116: @@
 == <code>system.info.sun_color</code> ==
-I'm just a dumb pilot, but the 2018 posts [http://aegidian.org/bb/viewtopic.php?p=265497#p265497 here] state that this is a way of changing the sun's colour.
+I'm just a dumb pilot, but the 2018 posts [https://bb.oolite.space/viewtopic.php?p=265497#p265497 here] state that this is a way of changing the sun's colour.
 ''Eg'':

← Older revision		Revision as of 17:54, 7 March 2023
Line 114:		Line 114:

	Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.		Note that the order of fromsystem (the last real system visited) and tosystem (the target of the latest jump) is significant - 0,7,55 is Lave to Leesti; 0,55,7 is Leesti to Lave. In many cases setting the same change for both directions may be necessary.
		+
		+	== <code>system.info.sun_color</code> ==
		+	I'm just a dumb pilot, but the 2018 posts [http://aegidian.org/bb/viewtopic.php?p=265497#p265497 here] state that this is a way of changing the sun's colour.
		+	''Eg'':
		+
		+	system.info.sun_color="1.0 0.6 0.3"
		+	system.info.sun_color="50 38 185"
		+	system.info.sun_color="yellowColor"
		+
		+	for RGB, HSB and named colours

	[[Category:Oolite JavaScript Reference]]		[[Category:Oolite JavaScript Reference]]

@@ Line 19: / Line 19: @@
   '''galaxyID''' : Number (read-only nonnegative integer)
 The ID number of the galaxy.
 === <code>internalCoordinates</code> ===