Docking Instructions - Revision history

Cholmondely: Links!

2021-01-22T11:07:14Z

Links!

Debresser: Page moved. No need for _ in links.

2016-01-16T20:35:00Z

Page moved. No need for _ in links.

Cim: /* Stage 3 */

2012-07-14T11:52:47Z

‎Stage 3

Cim: /* Stage 2 */

2012-07-14T11:51:07Z

‎Stage 2

Makarius: introduction extended a little

2007-10-10T09:33:58Z

introduction extended a little

Eric Walch: /* Stage 2 */

2007-10-09T12:00:08Z

‎Stage 2

Eric Walch: /* Stage 2 */

2007-10-09T11:59:33Z

‎Stage 2

Eric Walch at 11:54, 9 October 2007

2007-10-09T11:54:45Z

Eric Walch at 19:15, 8 October 2007

2007-10-08T19:15:03Z

Eric Walch: Docking AI info

2007-10-07T19:44:46Z

Docking AI info

New page

The command "requestDockingCoordinates" looks for the nearest station and guides the ship to its docking port.

If no station in the system exist it returns: NO_STATION_FOUND

The command "recallDockingInstructions" uses the previously found station and retransmit the last instructions.

Both commands are alike but the first time requestDockingCoordinates must be used.

If an other ship is in launching status it returns: TRY_AGAIN_LATER

If the ship is moving to fast or is turning to fast with a non-rotating station it returns: HOLD_POSITION

If the ship is already to close to give accurate coordinates (<1000 meter) it returns: BACK_OFF

If the ship is still to far away to give accurate coordinates (>12500 meter) it returns: APPROACH

If none of the above is valid and the ship has not moved much, approach coordinates in front of the dockingport are calculated and it returns: APPROACH_COORDINATES

The actual value of the coordinates depends on the distance to the dockingport.

Return to [[OXP howto AI]]

← Older revision		Revision as of 11:07, 22 January 2021
Line 1:		Line 1:
−	AI-Docking Instructions for Oolite ships. ~~See the [[Pilot's Reference Manual]] for not-AI based docking or check out the [[Docking Computers\|docking computer]].~~	+	AI-Docking Instructions for Oolite ships.
		+
		+	See [[Docking]] for details (and relevant links) of how to actually manage to do it!

	=The AI of the docking ship=		=The AI of the docking ship=

@@ Line 35: / Line 35: @@
 By issuing a "requestDockingCoordinates" the ship is added on the waitinglist for being handled by the station. If the ship for some reason aborts the docking it must issue a "abortDocking" command. This removes the ship from the waiting list. If it is not done the carrier could wait indefinitely for the last ship.
-The same is true when a ship is killed in the docking procedure. e.g. by smashing into the carrier. The ship stays on the dockinglist and the carrier stays put. The carrier will eventually notice this, but it may take a while. This can be prevented by putting a "abortDocking" command into the death_actions (or [[Oolite_JavaScript_Reference:_ship_script_event_handlers#shipDied|shipDied]] event) of the ships that are on the carrier. This way it is always sure he is removed from the list. And if he was not on a list the command does nothing.
+The same is true when a ship is killed in the docking procedure. e.g. by smashing into the carrier. The ship stays on the dockinglist and the carrier stays put. The carrier will eventually notice this, but it may take a while. This can be prevented by putting a "abortDocking" command into the death_actions (or [[Oolite JavaScript Reference: Ship script event handlers#shipDied|shipDied]] event) of the ships that are on the carrier. This way it is always sure he is removed from the list. And if he was not on a list the command does nothing.
 =The AI of the station or carrier=

@@ Line 35: / Line 35: @@
 By issuing a "requestDockingCoordinates" the ship is added on the waitinglist for being handled by the station. If the ship for some reason aborts the docking it must issue a "abortDocking" command. This removes the ship from the waiting list. If it is not done the carrier could wait indefinitely for the last ship.
-The same is true when a ship is killed in the docking procedure. e.g. by smashing into the carrier. The ship stays on the dockinglist and the carrier stays put. This can be prevented by putting a "abortDocking" command into the death_actions of the ships that are on the carrier. This way it is always sure he is removed from the list. And if he was not on a list the command does nothing.
+The same is true when a ship is killed in the docking procedure. e.g. by smashing into the carrier. The ship stays on the dockinglist and the carrier stays put. The carrier will eventually notice this, but it may take a while. This can be prevented by putting a "abortDocking" command into the death_actions (or [[Oolite_JavaScript_Reference:_ship_script_event_handlers#shipDied|shipDied]] event) of the ships that are on the carrier. This way it is always sure he is removed from the list. And if he was not on a list the command does nothing.
 =The AI of the station or carrier=

@@ Line 20: / Line 20: @@
  In this stage no coordinates are given. The ship first checks if he is stationary himself and than if the ships are in the right distance from the station (between 1000 and 12500 meters).
-If an other ship is in launching status it returns: TRY_AGAIN_LATER
+If another ship is in launching status or another temporary condition preventing docking is in effect it returns: TRY_AGAIN_LATER
 If the station or carrier is moving to fast or is turning to fast with a non-rotating station it returns: HOLD_POSITION

← Older revision		Revision as of 09:33, 10 October 2007
Line 1:		Line 1:
−	Docking Instructions for Oolite ships
		+	AI-Docking Instructions for Oolite ships. See the [[Pilot's Reference Manual]] for not-AI based docking or check out the [[Docking Computers\|docking computer]].

	=The AI of the docking ship=		=The AI of the docking ship=

@@ Line 26: / Line 26: @@
 If the ship is already to close to give accurate coordinates (<1000 meter) it returns: BACK_OFF
-If the ship is still too far away to give accurate coordinates (>12500 meter) it returns: APPROACH
+If the ship is still to far away to give accurate coordinates (>12500 meter) it returns: APPROACH
 ==Stage 3==

@@ Line 1: / Line 1: @@
 If no station in the system exist it returns: NO_STATION_FOUND
 The command "recallDockingInstructions" uses the previously found station and retransmit the last instructions.
 If an other ship is in launching status it returns: TRY_AGAIN_LATER
 If the ship is already to close to give accurate coordinates (<1000 meter) it returns: BACK_OFF
 If the ship is still to far away to give accurate coordinates (>12500 meter) it returns: APPROACH
 By issuing a "requestDockingCoordinates" the ship is added on the waitinglist for being handled by the station. If the ship for some reason aborts the docking it must issue a "abortDocking" command. This removes the ship from the waiting list. If it is not done the carrier could wait indefinitely for the last ship.
@@ Line 25: / Line 31: @@
 The same is true when a ship is killed in the docking procedure. e.g. by smashing into the carrier. The ship stays on the dockinglist and the carrier stays put. This can be prevented by putting a "abortDocking" command into the death_actions of the ships that are on the carrier. This way it is always sure he is removed from the list. And if he was not on a list the command does nothing.
-==The AI of the station or carrier==
+=The AI of the station or carrier=
 Whenever a carrier receives a "requestDockingCoordinates" from a ship it goes for a standstill. This could take some time as carriers are usually heavy. In the meantime it issues a "DOCKING_REQUESTED" to his own AI. That should react to jump to a new state were the docking is handled. When the ship came to a standstill it can calculate docking coordinates and thus from this point on is starts sending coordinates tho the waiting ships. From here on it just works as a station.
 In this new state it should wait for the next two events: "DOCKING_COMPLETE" or "DOCKING_ABORTED". This event only happens when the last ship that is on the dockinglist has docked or has aborted.
 But the carrier needs not waiting till docking is ready. It can break of waiting by just giving a new moving command.
 Return to [[OXP howto AI]]

@@ Line 1: / Line 1: @@
 The command "requestDockingCoordinates" looks for the nearest station and guides the ship to its docking port.
@@ Line 19: / Line 20: @@
 The actual value of the coordinates depends on the distance to the dockingport.
 Return to [[OXP howto AI]]