Equipment.plist - Revision history

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

Cholmondely: Added in Phkb's "Loadout by Category" OXP

2024-02-06T08:48:58Z

Added in Phkb's "Loadout by Category" OXP

Show changes

Cholmondely: /* Equipment Structure */ Minor tweaks.

2024-02-06T08:09:43Z

‎Equipment Structure: Minor tweaks.

Cholmondely: /* Links */ Added more

2024-01-10T08:45:34Z

‎Links: Added more

Phkb at 23:48, 13 December 2023

2023-12-13T23:48:15Z

@@ 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.

@@ Line 1,528: / Line 1,528: @@
 *[[Oolite JavaScript Reference: Equipment scripts]] are used to handle primable equipment activations.
 *[[Oolite JavaScript Reference: Condition scripts]] used to set conditions on the appearance of ships & equipment beyond the basics possible in [[shipdata.plist]], [[shipyard.plist]], [[shiplibrary.plist]] and equipment.plist
+*[https://github.com/OoliteProject/oolite/blob/83bc901498397895d3f9451930a5a6db8dbe22ab/Resources/Config/equipment.plist#L184 The Vanilla Game equipment.plist]
 === 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)

← 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 166: / Line 166: @@
 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.
-[[File:Reordering-headers.png|thumb|right|300px|[[Loadout by Category]] on "nightly" v.1.91's F3 Ship Outfitting Screen<br> The red "selling" lines come the [[Equipment 'Sell Item' Color]] OXP]]
+[[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 ==
 Phkb's [[Loadout by Category]] OXP orders the equipment lists on both the F3 Ship Outfitting screen and the F5 Commander information screen.

@@ 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

@@ Line 20: / Line 20: @@
+  )
-) The first entry is an integer that determines the technical level from which the equipment can be bought. A level of 99 has a special meaning. Only this value can be changed by script. ''Please note that the number displayed on the system data screen is one higher than the system's tech level, so to make equipment available at a displayed TL:10 and above in game, enter 9 here''.
+) The first entry is an integer that determines the technical level from which the equipment can be bought. The TL is one higher than the number - so the "1" here is TL2. And a "9" here would be TL10. A level of 99 has a special meaning. Only this value can be changed by script.
-Repairs can take place at tech levels one lower than the purchase level, and occasionally equipment will be offered at systems of a slightly lower tech level than the number given here.
+Repairs can take place at tech levels one lower than the purchase TL. Occasionally equipment will be offered at systems of a slightly lower tech level than the number given here.
-) The second entry is the costs of the equipment in tenths of a credit.
+) The second entry is the cost of the equipment in tenths of a credit. So "300" here is 30₢.
 ) This is a string that shows the name of the equipment as seen by the player.
@@ Line 105: / Line 105: @@
   	// your code
+  }
+Since Oolite v.1.77, the 'b' key is added for primeable equipment. Whenever 'b' is pressed, the "mode" event handler of the primed equipment is executed.
   this.mode = function ()
+  {
@@ Line 140: / Line 139: @@
 ** "EQ_WORMHOLE_SCANNER": allows targeting and scanning of witchspace wormholes
-* "hide_values" is added in 1.91, and will hide the cost and install time values from showing on the F3 Shit 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.
 === Creating laser weapons ===

@@ Line 176: / Line 176: @@
 [[Category:Updated JavaScript features in Oolite 1.81]]
 [[Category:Updated JavaScript features in Oolite 1.89]]
 [[Category:Oolite]]
 [[Category:Oolite scripting]]