<RetVar> = <RefObj> get west warp gate

[X2-Illuminatus]

<RetVar> = <RefObj> get west warp gate


<RetVar> = A variable where the requested information is stored.
<RefObj> = A variable containing a sector.


Returns the west gate of the as <RefObj> selected sector.

Each sector in the X-Universe can have a maximum of 6 gates. Each gate in a sector has a specific id, whereby the ids 0-3 are usually reserved for north (0), south (1), west (2) and east (3) gate. The ids 4 and 5 are free to use for additional gates, for example in the HUB or the Aldrin sector (after the Aldrin Expansion plot). Note, that it's also possible to create gates with different ids - possible ids are still 0-5, but for example you could use '3' as west gate - using the create gate[/color]-command.
However, this command will always return the gate with the id = 2. If a sector has no gate with this id, the command will return 'null'.

Example:

$sector = [PLAYERSHIP] -> get sector
$gate = $sector -> get west warp gate
$destination = $gate get gate destination: return sector=[TRUE]
write to player logbook $destination
return null

Assuming the current player sector contains a west gate ( with id=2 ), this writes its destination to the logbook.


Related Commands:

[url=http://forum.egosoft.com/viewtopic.php?t=305207]<RetVar> = <RefObj> get north warp gate
<RetVar> = <RefObj> get south warp gate
<RetVar> = <RefObj> get east warp gate


Command Location:

• »» Universe and Sector Commands
  <RetVar> = <RefObj> get west warp gate

[X2-Illuminatus]

<RetVar> = <RefObj> get west warp gate


<RetVar> = Eine Variable, in der die geforderte Information gespeichert wird.
<RefObj> = Eine Variable, die einen Sektor enthält.


Gibt das Westtor des als <RefObj> ausgewählten Sektors zurück.

In jedem Sektor im X-Universum können maximal 6 Sprungtore stehen. Jedes Tor hat eine eigene Identifikationsnummer (kurz ID). Die IDs 0-3 sind dabei normalerweise für Nord (0), Süd (1), West (2) und Ost (3) Tor reserviert. Die IDs 4 und 5 können für zusätzliche Tore genutzt werden, wie zum Beispiel im HUB-Sektor oder in Aldrin (nach dem Aldrin Plot). Beachte, dass es möglich ist, Tore mit unterschiedlichen IDs mithilfe des create gate[/color]-Befehls zu erstellen - die möglichen Ids gehen zwar immernoch von 0-5, aber man könnte bspw. 3 als ID für ein Westtor nehmen.
Jedoch wird dieser Befehl immer das Tor mit der ID = 2 zurückgeben. Wenn ein Sektor kein Tor mit dieser ID hat, so wird der Rückgabewert "null" sein.


Beispiel:

$sector = [PLAYERSHIP] -> get sector
$gate = $sector -> get west warp gate
$destination = $gate get gate destination: return sector=[TRUE]
write to player logbook $destination
return null

Vorausgesetzt der aktuelle Spielersektor enthält ein Westtor ( id=2 ), wird dieses Beispiel das Ziel dieses Westtores ins Spielerlogbuch schreiben.


Verwandte Befehle:

[url=http://forum.egosoft.com/viewtopic.php?t=305207]<RetVar> = <RefObj> get north warp gate
<RetVar> = <RefObj> get south warp gate
<RetVar> = <RefObj> get east warp gate


Zu finden unter:

• »» Universe and Sector Commands
  <RetVar> = <RefObj> get west warp gate