Oolite Javascript Reference: PriorityAI Documentation - Revision history

Cim: /* behaviourWaitHere */ 1.81

2015-01-24T14:33:54Z

‎behaviourWaitHere: 1.81

Cim: /* conditionPatrolIsOver */ 1.81 improvement

2015-01-11T12:24:15Z

‎conditionPatrolIsOver: 1.81 improvement

Spara: Corrected "oolite_scanResultsSpecific" to "oolite_scanResultSpecific"

2014-12-01T12:27:09Z

Corrected "oolite_scanResultsSpecific" to "oolite_scanResultSpecific"

Cim: moved Oolite PriorityAI Documentation to Oolite Javascript Reference: PriorityAI Documentation: Consistency

2014-09-13T15:20:01Z

moved Oolite PriorityAI Documentation to Oolite Javascript Reference: PriorityAI Documentation: Consistency

Spara: /* conditionHasSelectedStation */ changed planet to station

2014-08-13T16:11:59Z

‎conditionHasSelectedStation: changed planet to station

Phasted: /* conditionMissileNeedsLaunchEvasion */

2014-08-01T03:01:06Z

‎conditionMissileNeedsLaunchEvasion

Phasted: /* Basic structure */

2014-08-01T02:53:03Z

‎Basic structure

Cim: /* Docking components */ Document last-minute additional handler

2014-07-05T12:46:38Z

‎Docking components: Document last-minute additional handler

Cim: /* Standard Communications Roles */ Add escape pods

2014-06-01T11:13:46Z

‎Standard Communications Roles: Add escape pods

Cim: /* Flag Parameters */ new flag

2014-05-25T09:50:49Z

‎Flag Parameters: new flag

@@ Line 396: / Line 396: @@
  function '''behaviourTumble'''()
 Start tumbling. Unlike most behaviours, this one does not include the standard responses, so you will need to manually request a reconsideration of priorities if one is needed.
 === Missile behaviours ===

@@ Line 787: / Line 787: @@
  function '''conditionPatrolIsOver'''() : Boolean
 The ship's patrol is over (either due to distance travelled or a need to re-arm and repair). Note that the distance threshold is relatively low, so for ships on long patrol routes between system bodies this function should only be called when reaching appropriate waypoints.
 ==== <code>conditionWitchspaceEntryRequested</code> ====

@@ Line 604: / Line 604: @@
 === Scanning conditions ===
-These conditions check the ship's latest scan ([[#configurationCheckScanner|configurationCheckScanner]]) for ships meeting particular requirements. If a ship is found, it will be placed in the "oolite_scanResultsSpecific" parameter, in addition to the condition returning true.
+These conditions check the ship's latest scan ([[#configurationCheckScanner|configurationCheckScanner]]) for ships meeting particular requirements. If a ship is found, it will be placed in the "oolite_scanResultSpecific" parameter, in addition to the condition returning true.
 ==== <code>conditionScannerContainsAssassinationTarget</code> ====

@@ Line 532: / Line 532: @@
 ==== <code>conditionHasSelectedStation</code> ====
  function '''conditionHasSelectedStation'''() : Boolean
-The ship has a valid planet in the "oolite_selectedStation" parameter.
+The ship has a valid station in the "oolite_selectedStation" parameter.
 ==== <code>conditionHomeStationExists</code> ====

@@ Line 770: / Line 770: @@
  this.shipSpawned = function()
+ {
- 	/* Launch correction when fired at target in aft arc */
+   /* Launch correction when fired at target in aft arc */
- 	if (this.ship.target && this.ship.target.position.subtract(this.ship.position).direction().dot(this.ship.vectorForward) < -0.8)
+   var s = this.ship;
+   if(s.target && s.target.position.subtract(s.position).direction().dot(s.vectorForward) < -0.8)
- 		this.oolite_priorityai.setParameter("oolite_flag_launchAdjustMissile",true);
+     this.oolite_priorityai.setParameter("oolite_flag_launchAdjustMissile",true);
+ }

← Older revision	Revision as of 15:20, 13 September 2014
(No difference)

← Older revision		Revision as of 02:53, 1 August 2014
Line 183:		Line 183:

	Example of simple behaviour: (from thargoid AI)		Example of simple behaviour: (from thargoid AI)
−	{	+	{
−	preconfiguration: ai.configurationCheckScanner,	+	preconfiguration: ai.configurationCheckScanner,
−	condition: ai.conditionScannerContainsNonThargoid,	+	condition: ai.conditionScannerContainsNonThargoid,
−	configuration: ai.configurationAcquireScannedTarget,	+	configuration: ai.configurationAcquireScannedTarget,
−	behaviour: ai.behaviourDestroyCurrentTarget,	+	behaviour: ai.behaviourDestroyCurrentTarget,
−	reconsider: 1	+	reconsider: 1
−	},	+	},

	Example of branch usage: (from police AI)		Example of branch usage: (from police AI)
−	{	+	{
−	/* The group leader leads the patrol */	+	/* The group leader leads the patrol */
−	condition: ai.conditionIsGroupLeader,	+	condition: ai.conditionIsGroupLeader,
−	truebranch: [	+	truebranch: [
−	/* Nothing interesting here. Patrol for a bit */	+	/* Nothing interesting here. Patrol for a bit */
−	{	+	{
−	condition: ai.conditionHasWaypoint,	+	condition: ai.conditionHasWaypoint,
−	configuration: ai.configurationSetDestinationToWaypoint,	+	configuration: ai.configurationSetDestinationToWaypoint,
−	behaviour: ai.behaviourApproachDestination,	+	behaviour: ai.behaviourApproachDestination,
−	reconsider: 30	+	reconsider: 30
−	},	+	},
−	/* No patrol route set up. Make one */	+	/* No patrol route set up. Make one */
−	{	+	{
−	configuration: ai.configurationSetWaypoint,	+	configuration: ai.configurationSetWaypoint,
−	behaviour: ai.behaviourApproachDestination,	+	behaviour: ai.behaviourApproachDestination,
−	reconsider: 30	+	reconsider: 30
−	}	+	}
−	],	+	],
−	/* Other ships in the group will set themselves up	+	/* Other ships in the group will set themselves up
−	* as escorts if possible, or looser followers if	+	* as escorts if possible, or looser followers if
−	* not */	+	* not */
−	falsebranch: [	+	falsebranch: [
−	{	+	{
−	preconfiguration: ai.configurationEscortGroupLeader,	+	preconfiguration: ai.configurationEscortGroupLeader,
−	condition: ai.conditionIsEscorting,	+	condition: ai.conditionIsEscorting,
−	behaviour: ai.behaviourEscortMothership,	+	behaviour: ai.behaviourEscortMothership,
−	reconsider: 30	+	reconsider: 30
−	},	+	},
−	/* if we can't set up as an escort */	+	/* if we can't set up as an escort */
−	{	+	{
−	behaviour: ai.behaviourFollowGroupLeader,	+	behaviour: ai.behaviourFollowGroupLeader,
−	reconsider: 15	+	reconsider: 15
−	}	+	}
−	]	+	]
−	}	+	}

	The AI Library provides a selection of standard condition,		The AI Library provides a selection of standard condition,
	configuration and behaviour functions for us in AIs, but you can also		configuration and behaviour functions for us in AIs, but you can also
	write your own.		write your own.
−	/* Ship is unstable and may explode under stress */	+	/* Ship is unstable and may explode under stress */
−	{	+	{
−	condition: function()	+	condition: function()
−	{	+	{
−	return Math.random() < 0.01; // 1% chance per evaluation	+	return Math.random() < 0.01; // 1% chance per evaluation
−	}	+	}
−	behaviour: function()	+	behaviour: function()
−	{	+	{
−	this.ship.explode();	+	this.ship.explode();
−	}	+	}
−	}	+	}

	=== Evaluation context ===		=== Evaluation context ===

@@ Line 1,120: / Line 1,120: @@
  responseComponent_docking_shipAchievedDesiredRange
  responseComponent_docking_stationWithdrewDockingClearance
 ==== Escort components ====

@@ Line 1,596: / Line 1,596: @@
 * '''assassin''' - assassins
 * '''defenseShip''' - defense ships
 * '''escort''' - escorts
 * '''hermit''' - rock hermits. If no personalities are defined for this role, "station" will be used instead.

@@ Line 110: / Line 110: @@
  oolite_flag_fightsNearHostileStations
  oolite_flag_fleesPreemptively
  oolite_flag_listenForDistressCall
  oolite_flag_markOffenders