Equipment.plist - Revision history

Cholmondely: Added "OXPs to synchronise with"

2026-07-05T15:52:25Z

Added "OXPs to synchronise with"

Cholmondely: Added cim's post on installation_time=0

2026-07-05T13:54:50Z

Added cim's post on installation_time=0

Cholmondely: Added in Cim on F3/F5 "sort order"

2026-07-05T13:27:11Z

Added in Cim on F3/F5 "sort order"

Cholmondely: /* Links */ Added another

2026-06-04T23:36:53Z

‎Links: Added another

Cholmondely: /* Links */ Added another

2026-04-20T11:18:37Z

‎Links: Added another

Cholmondely: /* Links */ Added another

2026-03-13T11:06:50Z

‎Links: Added another

Cholmondely: Added cim's 2015 notes on equipment availability.

2025-03-19T07:30:28Z

Added cim's 2015 notes on equipment availability.

Phkb: Updating BB links

2024-02-29T01:39:33Z

Updating BB links

Cholmondely: /* Altering availability & pricing of equipment at specific stations */ Tweaked picture caption

2024-02-06T09:34:16Z

‎Altering availability & pricing of equipment at specific stations: Tweaked picture caption

Cholmondely: /* Loadout by Category OXP */ Updated Sort Order

2024-02-06T09:30:52Z

‎Loadout by Category OXP: Updated Sort Order

@@ Line 1,527: / Line 1,527: @@
 }}
 </div>
 == Links ==

@@ Line 120: / Line 120: @@
 * "<code>fast_affinity_defensive</code>" and "<code>fast_affinity_offensive</code>" are added in 1.79. These keys are ignored unless the equipment has a "script" file. If the equipment has a script file, then if set these keys make the equipment preferentially assigned to the "fast activation" keys ('0' and 'tab' in the default keys). This automatic assignment only happens if the equipment is bought while the current fast equipment assignment is blank (or is for equipment not currently installed). Generally these keys should only be set for equipment which might need to be activated quickly in an emergency.
 * "<code>installation_time</code>" and "<code>repair_time</code>" are added in 1.81. Value is number of seconds. These override the default time (one second per decicredit plus 10 minutes) to purchase an equipment item from the F3 screen. If only <code>installation_time</code> is specified, the repair time will be half of that. If only <code>repair_time</code> is specified, the installation time will be the default from the cost.
 * "<code>provides</code>" is added in 1.81, and is an array of equipment keys. This allows OXP equipment to provide some functionality from core equipment (or in theory other OXP equipment though this would need to be managed carefully between the OXPs). For example, a "navigation computer" might have <code>"provides" = ("EQ_DOCK_COMP","EQ_ADVANCED_COMPASS");</code>, and while this equipment was installed the player would get the benefits of those items even if they were not currently fitted. The default value is an empty array, though equipment is always considered to provide its own equipment key. While any string may be added here, only the following items have any in-game effect in the core game:

@@ Line 179: / Line 179: @@
 [[File:Reordering-headers.png|thumb|right|500px|[[Loadout by Category]] on "nightly" v.1.91's F3 Ship Outfitting Screen<br> The red "selling" lines come from the [[Equipment 'Sell Item' Color]] OXP<br>The equipment space lines at the top are from [[Ship Configuration]] OXP]]
-== Loadout by Category OXP ==
+== Sort Order on F3 & F5 screens ==
 Phkb's [[Loadout by Category]] OXP orders the equipment lists on both the F3 Ship Outfitting screen and the F5 Commander information screen.
 To assign your equipment a place on these lists you need to read through his '''equipment-overrides.plist''' and see where your equipment fits - and then assign a sort_order to it.
-=== Sort Order ===
+==== Loadout by Category OXP's Sort Order ====
 ''This changes slightly for the F5 screen which has a different ordering principle''
 *Fuel

@@ Line 1,532: / Line 1,532: @@
 === Other Links ===
 *[https://bb.oolite.space/viewtopic.php?f=4&t=16265 A collection of four formulae] for mixing ''permanent'' (''eg'' unsellable) passenger berths and ''temporary'' passenger berths on a ship. (2014)
 *[[Thargoid Witchspace Drive]] is scooped and then needs installation on a high TL anarchy world before it can be used.

@@ Line 1,525: / Line 1,525: @@
 == Links ==
 *[[equipment-overrides.plist]] overwrites the entries defined in equipment-overrides.plist
 *[[Oolite JavaScript Reference: EquipmentInfo]] objects provide information about a type of equipment
 *[[Oolite JavaScript Reference: Equipment scripts]] are used to handle primable equipment activations.

← Older revision		Revision as of 07:30, 19 March 2025
Line 140:		Line 140:

	* "hide_values" is added in 1.91, and will hide the cost and install time values from showing on the F3 Ship Outfitting screen, leaving just the item name.		* "hide_values" is added in 1.91, and will hide the cost and install time values from showing on the F3 Ship Outfitting screen, leaving just the item name.
		+
		+	===Cim on some of the above (2015, [https://bb.oolite.space/viewtopic.php?p=234222#p234222 here]): ===<br>
		+	* "<code>available_to_all = false;</code> means that the equipment can only be fitted to player ships which have the item in either the Standard or Optional Equipment section of their shipyard.plist definition. Unlikely, for a random piece of OXP equipment, but not impossible. This is what's actually doing the purchase blocking in this case. (Generally I wouldn't recommend using this on OXP equipment unless you want to tie it to a playable ship in the same OXP). Exactly when this is applied to the player ship has varied between Oolite versions [1] ... you should assume that it always applies and situations where it doesn't are bugs to be reported, I think.
		+
		+	* "<code>available_to_player = false;</code> means that the equipment can't be fitted to a player ship. If you don't want to use a condition script, Ngalo is right that this is the correct property.
		+
		+	* "<code>script_info = {"oolite-barred-equipment" = "EQ_PHOTONTORP_MISSILE"};</code> when combined with oolite-conditions.js as the condition script means that the equipment can't be fitted to the ship with that script_info in its shipdata.plist, and works on player and NPC ships. In this case, this means that the missile can't mount copies of itself on its pylons as additional ammunition, which will no doubt relieve anyone it's fired at.
		+
		+	While you can stick oolite-conditions.js on OXP equipment (and perhaps you may as well if you don't need any other condition support), obviously the chance of any core or OXP ship specifically barring it is very low - you're probably better off giving the item its own OXP-specific condition script. In general, condition scripts are the solution to the problem of there being lots of equipment availability properties with overlapping and unclear effects, and in this case a custom one could be used to ensure that not only could the player not fit it, but neither could any non-Scorpax NPC.
		+
		+	* "<code>TL for NPC equipment</code> is irrelevant in the core game; set it to some reasonable value just in case some OXP is introduced which has persistent NPCs, tracks their equipment purchasing, and supports OXP equipment. TL:99 is an old magic value which allowed the TL to be changed by script (including legacy scripts) - it was never particularly appropriate for items which should never be player-accessible, for which 100 or 98 (or one of the many more specific properties) is better.

	=== Creating laser weapons ===		=== Creating laser weapons ===

@@ Line 164: / Line 164: @@
 == Altering availability & pricing of equipment at specific stations ==
-This is ''not'' under the remit of the equipment.plists - for more detail see [http://aegidian.org/bb/viewtopic.php?f=2&t=21499 Equipment-overrides :-/] (2023) - it is done through javascript.
+This is ''not'' under the remit of the equipment.plists - for more detail see [https://bb.oolite.space/viewtopic.php?f=2&t=21499 Equipment-overrides :-/] (2023) - it is done through javascript.
 [[File:Reordering-headers.png|thumb|right|500px|[[Loadout by Category]] on "nightly" v.1.91's F3 Ship Outfitting Screen<br> The red "selling" lines come from the [[Equipment 'Sell Item' Color]] OXP<br>The equipment space lines at the top are from [[Ship Configuration]] OXP]]
@@ Line 1,519: / Line 1,519: @@
 === Other Links ===
-*[http://aegidian.org/bb/viewtopic.php?f=4&t=16265 A collection of four formulae] for mixing ''permanent'' (''eg'' unsellable) passenger berths and ''temporary'' passenger berths on a ship. (2014)
+*[https://bb.oolite.space/viewtopic.php?f=4&t=16265 A collection of four formulae] for mixing ''permanent'' (''eg'' unsellable) passenger berths and ''temporary'' passenger berths on a ship. (2014)
 *[[Thargoid Witchspace Drive]] is scooped and then needs installation on a high TL anarchy world before it can be used.

@@ Line 172: / Line 172: @@
 To assign your equipment a place on these lists you need to read through his '''equipment-overrides.plist''' and see where your equipment fits - and then assign a sort_order to it.
-The categories are:
+=== Sort Order ===
-:Fuel
+''This changes slightly for the F5 screen which has a different ordering principle''
-:General/Miscellaneous
+*Fuel
-:Astrogation or Navigation
+*General/Miscellaneous
-:Laser Weapons
+*Astrogation or Navigation
-:Pylon Weapons
+*Lasers
-:Cargo/Mining
+*Missiles
-:Laser Mount Switching System
+*Energy
-:Towbar and Accessories
+*Defensive
-:Defensive
+*Shields
-:Targeting
+*Targeting
-:Shields
+*Armour
-:Energy
+*Scanners
-:Self-Repair System
+*MFDs
-:Scanners
+*Cargo/Mining
-:MFDs
+*Laser Mount Switching System
-:Escorts/Fighters
+*Towbar and Accessories
-:Documentation
+*Self-Repair System
-:Illicit
+*Escorts/Fighters
 <div class="mw-collapsible mw-collapsed"  data-expandtext="Show phkb's equipment-overrides.plist" data-collapsetext="Hide equipment-overrides.plist" style="overflow:auto;">
 {{CodeEx|codeex=
@@ Line 1,507: / Line 1,510: @@
 }}
 </div>
 == Links ==
 *[[equipment-overrides.plist]] overwrites the entries defined in equipment-overrides.plist