<RetVar/IF><RefObj> find all sector within <Var/Number> jumps: Only known sectors=...

This forum serves as MSCI Reference at EGOSOFT. It's Read-Only for non MSCI Group members.

Moderators: Scripting / Modding Moderators, MSCI Moderators

User avatar
X2-Illuminatus
Moderator (Deutsch)
Moderator (Deutsch)
Posts: 25128
Joined: Sun, 2. Apr 06, 16:38
x4

<RetVar/IF><RefObj> find all sector within <Var/Number> jumps: Only known sectors=...

Post by X2-Illuminatus »

[skip|else] if [not]|while [not]| <RetVar/IF><RefObj> find all sectors within <Var/Number> jumps: Only known sectors=<Var/Number>


[skip|else] if [not]|while [not]| = The possible 'Conditional' statements that can be used with this command.
<RetVar/IF> = Use a variable, if the command should return information. If a variable is used, it will contain an array filled with the sectors within the specified jump range.
<RefObj> = A variable containing a sector.
<Var/Number> = A positive number or a variable containing it.
<Var/Number> = A TRUE or FALSE value or its representing number 1 or 0.


This command returns an array containg the sectors that can be reached by the as <Var/Number> selected (or less) number of jumps starting from the as <RefObj> selected sector. If the "Only known sectors"-value is set to TRUE, only sectors that are already visible on the universe map will be returned.


Example:

$sector= get sector from universe index: x=1, y=3
$sector.arr=$sector -> find all sectors within 1 jumps: Only known sectors=[FALSE]
write to player logbook $sector.arr
return null

This will save all sectors that are no or one jump away from Argon Prime in the array $sector.arr and writes it to the logbook. In the unmodifed game the output will be: ARRAY ( Home of Light, Ringo Moon, Argon Prime, The Wall, Herron's Nebula )


Command Location:
User avatar
X2-Illuminatus
Moderator (Deutsch)
Moderator (Deutsch)
Posts: 25128
Joined: Sun, 2. Apr 06, 16:38
x4

[TiP][49] 304987

Post by X2-Illuminatus »

[skip|else] if [not]|while [not]| <RetVar/IF><RefObj> find all sectors within <Var/Number> jumps: Only known sectors=<Var/Number>


[skip|else] if [not]|while [not]| = Die möglichen bedingten Anweisungen, die mit diesem Befehl genutzt werden können.
<RetVar/IF> = Nutze eine Variable, wenn der Befehl eine Information zurückgeben soll. Wenn eine Variable genutzt wird, wird sie ein Array gefüllt mit Sektoren in der angegebenen Sprungreichweite enthalten.
<RefObj> = Eine Variable, die einen Sektor enthält.
<Var/Number> = Eine positive Zahl oder eine Variable, die diese enthält.
<Var/Number> = Ein TRUE (wahr) oder FALSE (falsch) Wert oder seine entsprechende Ziffer 1 oder 0.


Dieser Befehl gibt ein Array zurück, das die Sektoren enthält, die man in einer Entfernung von <Var/Number> (oder weniger) Sprüngen ausgehend von dem als <RefObj> ausgewählten Sektor erreichen kann. Wenn der "Only known sectors"-Wert auf TRUE (wahr) gesetzt ist, werden nur die Sektoren zurückgegeben, die bereits auf der Universumskarte sichtbar sind.


Beispiel:

$sector= get sector from universe index: x=1, y=3
$sector.arr=$sector -> find all sectors within 1 jumps: Only known sectors=[FALSE]
write to player logbook $sector.arr
return null

Dies speichert alle Sektoren, die keinen oder einen Sprung von Argon Prime entfernt sind, im Array $sector.arr und schreibt es ins Logbuch. Im unmodifizierten Spiel würde die Ausgabe, wie folgt, aussehen: ARRAY ( Heimat des Lichts, Ringo Mond, Argon Prime, Linie der Energie, Herron's Nebel )


Zu finden unter:

Return to “MSCI Reference”