Shipyard.plist - Revision history

Cholmondely: /* Links */ Tweak

2026-06-18T17:21:13Z

‎Links: Tweak

Phkb: Updating BB links

2024-02-29T03:25:37Z

Updating BB links

Cholmondely: /* Links */ Added another

2023-06-08T13:27:22Z

‎Links: Added another

Cholmondely: /* Links */ Added another

2023-06-07T20:11:02Z

‎Links: Added another

Cholmondely: Added Cim's post

2023-05-31T23:55:07Z

Added Cim's post

Cholmondely: Added Links

2023-03-06T10:50:54Z

Added Links

Phkb at 02:31, 29 January 2018

2018-01-29T02:31:17Z

Cim: 1.79 property

2013-10-05T17:24:55Z

1.79 property

Cim: /* chance */ Add condition_script

2012-07-25T21:06:08Z

‎chance: Add condition_script

JazHaz at 20:47, 23 March 2010

2010-03-23T20:47:21Z

@@ Line 133: / Line 133: @@
 *[https://bb.oolite.space/viewtopic.php?f=4&t=17126 Where's my ship?] (2014)
 *[https://bb.oolite.space/viewtopic.php?f=6&t=17131 Shipyard generation] (2014)
-*[https://bb.oolite.space/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, etc.] (Redspear, 2017). Doneon  through a ''script.js file'', not the Shipyard.plist!
+*[https://bb.oolite.space/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, ''etc''.] (Redspear, 2017). Done  through a ''script.js file'', not the Shipyard.plist! See his [[Weapon Laws OXP]].
 *[https://bb.oolite.space/viewtopic.php?f=4&t=16337&start=255 Forcing a sale] ''script.js file'', Montana05, 2020 (there is more further in various Nov 6th posts)
 *[https://bb.oolite.space/viewtopic.php?p=272280#p272280 Forcing a sale at Lave at the game start] ''script.js file'', Dybal, 2020

@@ Line 19: / Line 19: @@
 It works pretty well for strict Oolite - with only 10 player-buyable ships, that's plenty of chances for each to come up, and higher-tech systems have fuller shipyards.
-If you add tens or hundreds of OXP player-flyable ships, the chances of any particular ship being there are minimal. It's easy to stop a ship showing up - condition script, low chance value, high tech level - but impossible to guarantee its appearance. ([http://aegidian.org/bb/viewtopic.php?p=289424#p289424 Cim (2023)])
+If you add tens or hundreds of OXP player-flyable ships, the chances of any particular ship being there are minimal. It's easy to stop a ship showing up - condition script, low chance value, high tech level - but impossible to guarantee its appearance. ([https://bb.oolite.space/viewtopic.php?p=289424#p289424 Cim (2023)])
 == chance ==
@@ Line 131: / Line 131: @@
 == Links ==
-*[http://www.aegidian.org/bb/viewtopic.php?f=4&t=17126 Where's my ship?] (2014)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=17126 Where's my ship?] (2014)
-*[http://aegidian.org/bb/viewtopic.php?f=6&t=17131 Shipyard generation] (2014)
+*[https://bb.oolite.space/viewtopic.php?f=6&t=17131 Shipyard generation] (2014)
-*[http://aegidian.org/bb/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, etc.] (Redspear, 2017). Doneon  through a ''script.js file'', not the Shipyard.plist!
+*[https://bb.oolite.space/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, etc.] (Redspear, 2017). Doneon  through a ''script.js file'', not the Shipyard.plist!
-*[http://aegidian.org/bb/viewtopic.php?f=4&t=16337&start=255 Forcing a sale] ''script.js file'', Montana05, 2020 (there is more further in various Nov 6th posts)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=16337&start=255 Forcing a sale] ''script.js file'', Montana05, 2020 (there is more further in various Nov 6th posts)
-*[http://aegidian.org/bb/viewtopic.php?p=272280#p272280 Forcing a sale at Lave at the game start] ''script.js file'', Dybal, 2020
+*[https://bb.oolite.space/viewtopic.php?p=272280#p272280 Forcing a sale at Lave at the game start] ''script.js file'', Dybal, 2020
 ----
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 133: / Line 133: @@
 *[http://www.aegidian.org/bb/viewtopic.php?f=4&t=17126 Where's my ship?] (2014)
 *[http://aegidian.org/bb/viewtopic.php?f=6&t=17131 Shipyard generation] (2014)
-*[http://aegidian.org/bb/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, etc.] (Redspear, 2017). Done through a script.js file, not the Shipyard.plist!
+*[http://aegidian.org/bb/viewtopic.php?p=256148#p256148 How to restrict sales to govt types, economy types, etc.] (Redspear, 2017). Doneon  through a ''script.js file'', not the Shipyard.plist!
 ----
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

@@ Line 133: / Line 133: @@
 *[http://www.aegidian.org/bb/viewtopic.php?f=4&t=17126 Where's my ship?] (2014)
 *[http://aegidian.org/bb/viewtopic.php?f=6&t=17131 Shipyard generation] (2014)
 ----
 [[Category:Oolite]]
 [[Category:Oolite scripting]]

← Older revision		Revision as of 23:55, 31 May 2023
Line 1:		Line 1:
	'''shipyard.[[plist]]''' provides Oolite with the information necessary to equip a player-purchaseable ship.		'''shipyard.[[plist]]''' provides Oolite with the information necessary to equip a player-purchaseable ship.

		+
		+	== Overview ==
		+	How the selection of ships for the F3F3 shipyard actually works:
		+
		+	It's long, and takes a bizarre way around - basically, to avoid having to store the shipyard anywhere persistent, it randomly generates it to a fixed seed algorithm every time it's looked at, but it's conceptually relatively simple.
		+
		+	The shipyard has 256 potential slots. For each slot:
		+	* pick a random entry from the entire list of player available ships (excluding those which fail condition scripts)
		+	* determine an "on sale date" for that slot based on a long loop
		+	* if the slot isn't on sale in its 30-day window based on the current time, leave it blank - so the shipyard will gradually rotate stock as you leave and return. This is on a roughly 200-day cycle, so only about 40 slots are actually active at any time.
		+	* if the ship which would fill the slot is higher tech than the station (or system if the station doesn't have a tech level defined), leave it blank
		+	* if the ship's "chance" in shipyard.plist is <1, roll against that for another chance to leave the slot blank
		+	* if all of the above allows the slot to be filled, potentially give the ship some random weapon upgrades and bonus equipment
		+
		+	Having established which of the slots contain ships, remove all the duplicates in ship+equipment from the list so it doesn't contain 5 identical stock Adders.
		+
		+	It works pretty well for strict Oolite - with only 10 player-buyable ships, that's plenty of chances for each to come up, and higher-tech systems have fuller shipyards.
		+
		+	If you add tens or hundreds of OXP player-flyable ships, the chances of any particular ship being there are minimal. It's easy to stop a ship showing up - condition script, low chance value, high tech level - but impossible to guarantee its appearance. ([http://aegidian.org/bb/viewtopic.php?p=289424#p289424 Cim (2023)])

	== chance ==		== chance ==

@@ Line 9: / Line 9: @@
 ==condition_script==
-''Available from Oolite 1.77 onwards''
+{{oolite-prop-added|1.77}}
 This option specifies a Javascript file which controls the addition of this ship. The <code>allowOfferShip</code> function in that [[Oolite_JavaScript_Reference:_Condition_scripts|condition script]] will then be tested before the ship is offered for sale. Several ship types can share a condition script.
@@ Line 38: / Line 38: @@
 == renovation_multiplier ==
-From 1.79 onwards, this number may be used to make the ship more expensive or cheaper to maintain. The usual cost of purchasing ship maintenance is approximately 1% of the ship's total value (including equipment) though this varies a little with the amount of maintenance needed. The maintenance price will be multiplied by this number (if omitted, default 1)
+{{oolite-prop-added|1.79}}
 Example:

← Older revision		Revision as of 17:24, 5 October 2013
Line 37:		Line 37:
	<integer>65000</integer>		<integer>65000</integer>

		+	== renovation_multiplier ==
		+	From 1.79 onwards, this number may be used to make the ship more expensive or cheaper to maintain. The usual cost of purchasing ship maintenance is approximately 1% of the ship's total value (including equipment) though this varies a little with the amount of maintenance needed. The maintenance price will be multiplied by this number (if omitted, default 1)
		+
		+	Example:
		+	// prototype technology is hard to maintain
		+	renovation_multiplier = "3.5";

	== standard_equipment ==		== standard_equipment ==

@@ Line 6: / Line 6: @@
 Example:
-  <key>chance</key>
+  chance = 0.25;
-  <real>0.25</real>
 == optional_equipment ==

← Older revision		Revision as of 20:47, 23 March 2010
Line 1:		Line 1:
−	'''shipyard.plist''' provides Oolite with the information necessary to equip a player-purchaseable ship.	+	'''shipyard.[[plist]]''' provides Oolite with the information necessary to equip a player-purchaseable ship.