The Dark Side - Revision history

Cholmondely: /* Tips */ Added Cody's tip about the Config folder

2025-12-28T18:16:25Z

‎Tips: Added Cody's tip about the Config folder

Cholmondely: Added McLane's tip

2025-03-31T11:58:26Z

Added McLane's tip

Cholmondely: /* Javascript */ Added DAJT's initial thread about this

2024-05-28T14:59:59Z

‎Javascript: Added DAJT's initial thread about this

Cholmondely: Added links to tools

2024-04-10T08:50:16Z

Added links to tools

Phkb: Updating BB links

2024-03-18T14:27:21Z

Updating BB links

Phkb: Updating BB links

2024-02-29T03:35:20Z

Updating BB links

Cholmondely: /* Links */ Tweaks

2024-01-07T12:25:40Z

‎Links: Tweaks

Cholmondely: Added dire warning

2023-12-27T10:28:49Z

Added dire warning

Cholmondely: Added a little more

2023-06-29T19:20:29Z

Added a little more

Cholmondely: /* Links */ Added another link

2023-04-10T02:46:59Z

‎Links: Added another link

← Older revision		Revision as of 18:16, 28 December 2025
Line 63:		Line 63:
	But I still have opened one browser window with more than a dozen tabs of the most important JS documentation pages, shipdata.plist, and the AI documentation all the time. One window for the boards, one window for the Elite Wiki, permanently. I guess other OXP creators have a similar setup. [https://bb.oolite.space/viewtopic.php?p=142154#p142154 Commander McLane, 2011]		But I still have opened one browser window with more than a dozen tabs of the most important JS documentation pages, shipdata.plist, and the AI documentation all the time. One window for the boards, one window for the Elite Wiki, permanently. I guess other OXP creators have a similar setup. [https://bb.oolite.space/viewtopic.php?p=142154#p142154 Commander McLane, 2011]

		+	The [[OXP_howto#Structure\|Config folder]] is very useful. Create a brand new one inside your [[OXP#Locating_your_AddOns_folder\|AddOns folder]] and then try copying the core [[Planetinfo.plist\|planetinfo.plist]] into it, then tinker with the star numbers - like this, perhaps:
		+
		+
		+	"universal" =
		+	{
		+	ambient_level = 0.025;
		+	//cloud_alpha = 0.000000;
		+	//nebula_count_multiplier = 0;
		+	star_count_multiplier = 56;
		+	//sky_rgb_colors = "0.9 1.0 1.0 1.0 1.0 0.7";
		+	sky_color_1 = (0.6,0.7,1);
		+	sky_color_2 = (1.0,0.8,0.4);
		+	stations_require_docking_clearance = no;
		+	sun_distance_multiplier = 5;
		+	};
		+
		+	You can copy all sorts of core plists/scripts/AIs ''etc'' into there - a [[Descriptions.plist\|descriptions.plist]], for example - and tinker to your hearts content, and it will change how your game works/looks without permanently affecting the core [[Property list\|.plists]]. [[User:Cody\|Cody]], 2021

	== Links ==		== Links ==

@@ Line 57: / Line 57: @@
 By [[User:LittleBear‎|LittleBear‎]] in [https://bb.oolite.space/viewtopic.php?f=2&t=2619 Any benefits in flying near/with other ships?] (2006) Note that this is all in "[[Legacy Scripting]]".
 </div>
 == Links ==

@@ Line 96: / Line 96: @@
 *[[Scripting Oolite with JavaScript]] - contains a note about what your computer does with the JavaScript, followed by a long essay about Oolite's version of Javascript
 *Phkb has a helpful intro to mission.oxp javascript [https://bb.oolite.space/viewtopic.php?p=277713#p277713 here] with a commentary [https://bb.oolite.space/viewtopic.php?p=278061#p278061 here] (2021)
 == Tools ==

@@ Line 96: / Line 96: @@
 *[[Scripting Oolite with JavaScript]] - contains a note about what your computer does with the JavaScript, followed by a long essay about Oolite's version of Javascript
 *Phkb has a helpful intro to mission.oxp javascript [https://bb.oolite.space/viewtopic.php?p=277713#p277713 here] with a commentary [https://bb.oolite.space/viewtopic.php?p=278061#p278061 here] (2021)
 == Reference ==

@@ Line 61: / Line 61: @@
 *See '''The Embrace of the Dark Side''' in the ''Applied Theology'' section on the page for the [[Church of Giles the Creator]]
 *[https://bb.oolite.space/viewtopic.php?f=4&t=17487 Forgot to play?] Programming vs Playing (2015)
-*[http://oolite.bb.oolite.space/viewtopic.php?f=7&t=18416 How many of you OXP authors are programmers?] (2016+)
+*[https://bb.oolite.space/viewtopic.php?f=7&t=18416 How many of you OXP authors are programmers?] (2016+)
 === Finding things ===
@@ Line 93: / Line 93: @@
 :[[Legacy Scripting|OpenStep]] is more manageable for beginners. Javascript less so.
 *[[Oolite Javascript basics]] - an introductory essay by [[User:Massively Locked|Massively Locked]]
-*[http://oolite.bb.oolite.space/viewtopic.php?f=4&t=13235 if (player.ship.dockedStation.isMainStation)] - major discussion on a single line of code (2012)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=13235 if (player.ship.dockedStation.isMainStation)] - major discussion on a single line of code (2012)
 *[[Scripting Oolite with JavaScript]] - contains a note about what your computer does with the JavaScript, followed by a long essay about Oolite's version of Javascript
 *Phkb has a helpful intro to mission.oxp javascript [https://bb.oolite.space/viewtopic.php?p=277713#p277713 here] with a commentary [https://bb.oolite.space/viewtopic.php?p=278061#p278061 here] (2021)

@@ Line 13: / Line 13: @@
 == The Perils of the Dark Side ==
-From the [http://aegidian.org/bb/viewtopic.php?p=219408#p219408 Tales from the spacelanes...] thread (2014):
+From the [https://bb.oolite.space/viewtopic.php?p=219408#p219408 Tales from the spacelanes...] thread (2014):
   Bugger this game is taking over my life!! The funny thing is that between wings3d, photoshop, reading 500 wiki pages about the JS commands for plists and now thoughts of a cockpit console.. well I realised that its been almost a week since i actually played the game as a game instead of test flying the model I'm trying to get working.. lol  '''spud42'''
@@ Line 55: / Line 55: @@
 Obviously it's Giles's code that does all this, but us players can write AIs that the code will follow. You then assign this to a new ship you have built to make it behave as you want. If you want your ship to be a typical pirate / policeship / miner / escort ''etc'', then you just give it one of the native AIs. Fiddling with Oolite is almost as much fun as playing it!
-By [[User:LittleBear‎|LittleBear‎]] in [http://www.aegidian.org/bb/viewtopic.php?f=2&t=2619 Any benefits in flying near/with other ships?] (2006) Note that this is all in "[[Legacy Scripting]]".
+By [[User:LittleBear‎|LittleBear‎]] in [https://bb.oolite.space/viewtopic.php?f=2&t=2619 Any benefits in flying near/with other ships?] (2006) Note that this is all in "[[Legacy Scripting]]".
 </div>
 == Links ==
 *See '''The Embrace of the Dark Side''' in the ''Applied Theology'' section on the page for the [[Church of Giles the Creator]]
-*[http://aegidian.org/bb/viewtopic.php?f=4&t=17487 Forgot to play?] Programming vs Playing (2015)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=17487 Forgot to play?] Programming vs Playing (2015)
-*[http://oolite.aegidian.org/bb/viewtopic.php?f=7&t=18416 How many of you OXP authors are programmers?] (2016+)
+*[http://oolite.bb.oolite.space/viewtopic.php?f=7&t=18416 How many of you OXP authors are programmers?] (2016+)
 === Finding things ===
@@ Line 68: / Line 68: @@
 *[[:Category:Oolite JavaScript Reference]]
 *[[:Category:Oolite scripting]]
-*And Commander McLane's post (taken from [http://www.aegidian.org/bb/viewtopic.php?p=133164#p133164 here] (2011))
+*And Commander McLane's post (taken from [https://bb.oolite.space/viewtopic.php?p=133164#p133164 here] (2011))
 Smivs was asking for help:
   For an OXP idea I'm working on, I have an asteroid as a sub-entity of a ship - the idea is it's a space wreck and the asteroid has hit the ship at low speed and the ship is now 'crunched' onto the asteroid. So far so good. However I want to be able to salvage stuff from the ship by destroying it. Again so far so good. The problem is that sometimes the asteroid breaks into boulders during this and sometimes it doesn't. I would like to guarantee that the asteroid breaks into about 4-5 boulders every time.
@@ Line 82: / Line 82: @@
   For a boulder it would be a '''ship''', because it is a ship which spawns the boulder. Therefore the reference page you need is [[Oolite JavaScript Reference: Ship]], and indeed that is where you find the "<tt>spawn()</tt>" method. The hint is in the word you type at the beginning of your command (in this case it is "<tt>this.ship.</tt>").
-  If you follow [http://www.aegidian.org/bb/viewtopic.php?p=133150#p133150 Thargoid's advice], you may consult two pages. As indicated by the word "<tt>system.</tt>" at the beginning of the command, it manipulates the '''system''' object. The reference page for that is [[Oolite JavaScript Reference: System]]. That is where you find everything about the "<tt>addShips()</tt>" method. Later you see the word "<tt>ship.</tt>" again, which indicates that "<tt>position</tt>" is again a property of the '''ship''', so you would search for it on [[Oolite JavaScript Reference: Ship]] again. Only that this time you would not find it there. It happens that '''ship''' is one of the sub-classes of '''entity''' (other sub-classes are for instance '''sun''' or '''planet'''), and ''all'' entities have a position. Therefore you find the "<tt>position</tt>" property in [[Oolite_JavaScript_Reference:_Entity]].
+  If you follow [https://bb.oolite.space/viewtopic.php?p=133150#p133150 Thargoid's advice], you may consult two pages. As indicated by the word "<tt>system.</tt>" at the beginning of the command, it manipulates the '''system''' object. The reference page for that is [[Oolite JavaScript Reference: System]]. That is where you find everything about the "<tt>addShips()</tt>" method. Later you see the word "<tt>ship.</tt>" again, which indicates that "<tt>position</tt>" is again a property of the '''ship''', so you would search for it on [[Oolite JavaScript Reference: Ship]] again. Only that this time you would not find it there. It happens that '''ship''' is one of the sub-classes of '''entity''' (other sub-classes are for instance '''sun''' or '''planet'''), and ''all'' entities have a position. Therefore you find the "<tt>position</tt>" property in [[Oolite_JavaScript_Reference:_Entity]].
   If you would want to manipulate the '''player ship''', your starting point would be [[Oolite JavaScript Reference: PlayerShip]]. However, this covers only all things which are "<tt>unique</tt>" to a player ship. For all other aspects a '''player ship''' is only a sub-class of '''ship''', which is only a sub-class of '''entity'''. Therefore you would have to consult one of those pages if you want to manipulate for instance the player ship's "<tt>speed</tt>" (shared by all '''ships''') or "<tt>position</tt>" (shared by all '''entities''').
 === Useful Links ===
-*[http://aegidian.org/bb/viewtopic.php?f=8&t=7861 What "can" be changed without re-compiling?] (2010-date) - for what oxp's ''cannot do'' see the 2021-2 posts
+*[https://bb.oolite.space/viewtopic.php?f=8&t=7861 What "can" be changed without re-compiling?] (2010-date) - for what oxp's ''cannot do'' see the 2021-2 posts
 *[https://www.shamusyoung.com/twentysidedtale/?p=3519 Getting Started with Programming] by Shamus Young (died June 2022) - a broad introduction to the issues.
@@ Line 93: / Line 93: @@
 :[[Legacy Scripting|OpenStep]] is more manageable for beginners. Javascript less so.
 *[[Oolite Javascript basics]] - an introductory essay by [[User:Massively Locked|Massively Locked]]
-*[http://oolite.aegidian.org/bb/viewtopic.php?f=4&t=13235 if (player.ship.dockedStation.isMainStation)] - major discussion on a single line of code (2012)
+*[http://oolite.bb.oolite.space/viewtopic.php?f=4&t=13235 if (player.ship.dockedStation.isMainStation)] - major discussion on a single line of code (2012)
 *[[Scripting Oolite with JavaScript]] - contains a note about what your computer does with the JavaScript, followed by a long essay about Oolite's version of Javascript
-*Phkb has a helpful intro to mission.oxp javascript [http://www.aegidian.org/bb/viewtopic.php?p=277713#p277713 here] with a commentary [http://www.aegidian.org/bb/viewtopic.php?p=278061#p278061 here] (2021)
+*Phkb has a helpful intro to mission.oxp javascript [https://bb.oolite.space/viewtopic.php?p=277713#p277713 here] with a commentary [https://bb.oolite.space/viewtopic.php?p=278061#p278061 here] (2021)
 == Reference ==

@@ Line 1: / Line 1: @@
 [[File:2560px-Two women operating ENIAC (full resolution).jpg|800px]]
-<br><br><br><br><br><br><br><br><br>
+<br>
 "Modding" or tweaking and writing OXPs - and eventually maybe even tampering with the [[Vanilla game]] code if you get to be good enough!
 Sneak a peek at [[How to tweak OXZ's]] ... and see where it leads you! One of [[Giles Williams|Aegidian/Giles]]'s desires was to use Oolite to teach people how to code.
@@ Line 9: / Line 11: @@
 Oolite itself (the Vanilla game code, not the oxp's) is currently written in Objective-C (72.5%), C (19%), and JavaScript (7%) with fragments in other stuff.
-== Understanding what really goes on ==
+From the [http://aegidian.org/bb/viewtopic.php?p=219408#p219408 Tales from the spacelanes...] thread (2014):
   So I'm on my way to Erlaza, I decide to fly in along the main route and see what I can pick up along the way and the first thing I meet is a Boa with four escorts. Now it strikes me that if I join them I might see a bit more action but at the same time I wouldn't have to deal with it entirely on my own. Sure enough, within minutes there's a Fer-de-Lance shooting at us.