Oolite JavaScript Reference: Ship - Revision history

Cholmondely: /* scannerDisplayColor1 */ Added a_c's tip

2026-07-16T18:30:15Z

‎scannerDisplayColor1: Added a_c's tip

Cholmondely: /* autoWeapons */ Added note on skilled NPCs

2025-07-25T07:21:11Z

‎autoWeapons: Added note on skilled NPCs

Phkb: /* setMaterials */

2025-05-25T05:53:51Z

‎setMaterials

Phkb: Updating BB links

2024-02-29T02:19:14Z

Updating BB links

Cholmondely: /* equipmentStatus */ Added link

2024-01-14T13:53:39Z

‎equipmentStatus: Added link

Phkb: /* canAwardEquipment */

2023-12-13T23:56:32Z

‎canAwardEquipment

Cholmondely: /* maxSpeed */ Added note on ship.cruiseSpeed

2023-10-09T07:43:19Z

‎maxSpeed: Added note on ship.cruiseSpeed

Phkb: /* target */

2023-09-19T09:35:59Z

‎target

Phkb: /* missileLoadTime */

2023-09-19T09:35:39Z

‎missileLoadTime

Phkb: /* lightsActive */

2023-09-19T09:35:17Z

‎lightsActive

@@ Line 655: / Line 655: @@
   '''scannerDisplayColor1''' : [[Materials in Oolite#Colour specifiers|Colour specifier]] (read/write)
 The first of two colours used by the ship’s scanner “lollipop”. When read, this will always be an array of four numbers in the range 0..1 (representing red, green, blue and alpha components). Any colour specifier format may be assigned to it. Assigning <code>null</code> will restore the value from [[shipdata.plist]], or the default value for the ship’s scan class.
 '''See also:''' <code>[[#scannerDisplayColor2|scannerDisplayColor2]]</code>, <code>[[#scannerHostileDisplayColor1|scannerHostileDisplayColor1]]</code>

@@ Line 70: / Line 70: @@
 {{oolite-prop-added|1.79}}
   '''autoWeapons''' : Boolean (read-only)
-The value of the <code>"auto_weapons"</code> shipdata key. If this is <code>true</code>, the ship's provider has given permission for scripts (such as the system populator) to alter the properties of this ship to better fit into scenarios or roles. If this is <code>false</code>, the ship's provider would prefer you not to alter the properties of this ship but to use it as-is.
+The value of the <code>"auto_weapons"</code> shipdata key. If this is <code>true</code>, the ship's provider has given permission for scripts (such as the system populator, or [[Skilled NPCs OXP]]) to alter the properties of this ship to better fit into scenarios or roles. If this is <code>false</code>, the ship's provider would prefer you not to alter the properties of this ship but to use it as-is.
 See [https://bb.oolite.space/viewtopic.php?p=235800#p235800 here] for more detail

@@ Line 1,276: / Line 1,276: @@
 '''Example:'''
   this.ship.setMaterials({"my_ship_diffuse.png": { diffuse_map: "my_ship_damaged_diffuse.png" }});
-−
 '''See also:''' <code>[[#setShaders|setShaders()]]</code>, <code>[[#getMaterials|getMaterials()]]</code>

@@ Line 72: / Line 72: @@
 The value of the <code>"auto_weapons"</code> shipdata key. If this is <code>true</code>, the ship's provider has given permission for scripts (such as the system populator) to alter the properties of this ship to better fit into scenarios or roles. If this is <code>false</code>, the ship's provider would prefer you not to alter the properties of this ship but to use it as-is.
-See [http://aegidian.org/bb/viewtopic.php?p=235800#p235800 here] for more detail
+See [https://bb.oolite.space/viewtopic.php?p=235800#p235800 here] for more detail
 === <code>beaconCode</code> ===
@@ Line 504: / Line 504: @@
 The ship’s maximum speed under normal power. Note that <code>[[#speed|speed]]</code> may exceed this when the [[Witch Fuel Injectors]] or [[Torus Drive]] are in use.
-Note: there is also a read-only '''cruiseSpeed''' - see [http://aegidian.org/bb/viewtopic.php?f=3&t=20655 stale ship.cruiseSpeed] (2020) - set at 80% of the vanilla game code's maxSpeed.
+Note: there is also a read-only '''cruiseSpeed''' - see [https://bb.oolite.space/viewtopic.php?f=3&t=20655 stale ship.cruiseSpeed] (2020) - set at 80% of the vanilla game code's maxSpeed.
 === <code>maxThrust</code> ===
@@ Line 992: / Line 992: @@
 to allow equipments which allow fitting multiple to be queried. If multiple equipments can be fitted, not setting the 'multiple' parameter will return the 'best' state of all items of that type.
-'''See also:''' <code>[[#setEquipmentStatus|setEquipmentStatus()]]</code> & [http://www.aegidian.org/bb/viewtopic.php?f=3&t=17879 When equipment gets damaged, what happens to it? (2015)]
+'''See also:''' <code>[[#setEquipmentStatus|setEquipmentStatus()]]</code> & [https://bb.oolite.space/viewtopic.php?f=3&t=17879 When equipment gets damaged, what happens to it? (2015)]
 === <code>exitAI</code> ===
@@ Line 1,387: / Line 1,387: @@
   log ("test", shipdata ["name"])
-'''See also''': [http://www.aegidian.org/bb/viewtopic.php?p=274534#p274534 bulletin board post by Tsoj]
+'''See also''': [https://bb.oolite.space/viewtopic.php?p=274534#p274534 bulletin board post by Tsoj]
 ==See also==

@@ Line 992: / Line 992: @@
 to allow equipments which allow fitting multiple to be queried. If multiple equipments can be fitted, not setting the 'multiple' parameter will return the 'best' state of all items of that type.
-'''See also:''' <code>[[#setEquipmentStatus|setEquipmentStatus()]]</code>
+'''See also:''' <code>[[#setEquipmentStatus|setEquipmentStatus()]]</code> & [http://www.aegidian.org/bb/viewtopic.php?f=3&t=17879 When equipment gets damaged, what happens to it? (2015)]
 === <code>exitAI</code> ===

@@ Line 878: / Line 878: @@
 === <code>canAwardEquipment</code> ===
-  function '''canAwardEquipment'''(equipmentType : [[Oolite JavaScript Reference: EquipmentInfo#Equipment Expressions|equipmentInfoExpression]]) : Boolean
+  function '''canAwardEquipment'''(equipmentType : [[Oolite JavaScript Reference: EquipmentInfo#Equipment Expressions|equipmentInfoExpression]][, context: string]) : Boolean
 Tests whether it is possible to add a given equipment type. This command takes the conditions for offering inside equipment.plist into account. Returns <code>true</code> if <code>[[#awardEquipment|awardEquipment()]]</code> is expected to succeed, <code>false</code> otherwise.
 '''See also:''' <code>[[#awardEquipment|awardEquipment()]]</code>

@@ Line 745: / Line 745: @@
 === <code>target</code> ===
-  '''target''' : Ship (read-write)
+  '''target''' : Ship (read/write)
 The ship’s primary target, i.e. the entity it will attempt to shoot at. This value is automatically co-ordinated between a ship and its subentities.

@@ Line 520: / Line 520: @@
 === <code>missileLoadTime</code> ===
-  '''missileLoadTime''' : Number (read-write nonnegative)
+  '''missileLoadTime''' : Number (read/write nonnegative)
 The minimum amount of time between two missiles. The corresponding ''[[shipdata.plist]]'' key is <code>missile_load_time</code>.

@@ Line 467: / Line 467: @@
 === <code>lightsActive</code> ===
-  '''lightsActive''' : Boolean (read-write)
+  '''lightsActive''' : Boolean (read/write)
 Setting this property to <code>true</code> turns on all the entity’s flashers, and setting it to <code>false</code> turns them off. Setting it sets the <code>lightsActive</code> property for all subentities, but subentities’ setting can also be manipulated separately. In addition to affecting flashers, the value can be used by shaders.