<RetVar/IF> <RefObj> get homesector

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

Moderators: Scripting / Modding Moderators, MSCI Moderators

Locked
User avatar
Serial Kicked
Posts: 3823
Joined: Fri, 12. Aug 05, 20:46
x3tc

<RetVar/IF> <RefObj> get homesector

Post by Serial Kicked » Wed, 8. Sep 10, 22:21

[skip|else] if [not]|while [not]|<RetVar> = <RefObj> -> get homesector


[skip|else] if [not]|while [not]| = Possible 'conditional' statements that can be used
<RetVar> = variable where the requested information is put
<RefObj> = The object you want to check


Returns the homesector of the specified <RefObj>. If <RefObj> doesn't have a homesector or doesn't exist, it will return null.

The homesector is only relevant on NPC ships controlled by default vanilla job scripts. It usually points to the sector where the ship spawned. As an example it is used by the patrol scripts to prevent ships from going too far away from their homesector.


Example
  • if $ship -> get homesector
    | write to logbook "the ship has a homesector"
    end
Command Location:

Alex Vanderbilt
Winner X3 Sektorquest
Posts: 2127
Joined: Thu, 4. May 06, 12:07
x3tc

[TiP][49] 286499

Post by Alex Vanderbilt » Fri, 24. Sep 10, 10:54

[skip|else] if [not]|while [not]| <RetVar> = <RefObj> -> get homesector


[skip|else] if [not]|while [not]| = Eine mögliche Bedingung, die mit diesem Kommando verwendet werden kann.
<RetVar> = Die Variable, in die die Informationen abgelegt werden.
<RefObj> = Das Objekt, das Du überprüfen willst.

Der Heimatsektor eines bestimmten <RefObj> wird zurückgegeben. Für den Fall, dass <RefObj> keinen Heimatsektor hat oder nicht existiert, wird null zurückgegeben.

Der Heimatsektor ist nur für NPC-Schiffe von Interesse, die von Standard-Job-Skripten kontrolliert werden. Der Heimatsektor ist dabei normalerweise der Sektor, in dem das Schiff zum ersten Mal aufgetaucht ist. Beispielsweise wird der Heimatsektor für Patrouillenskripte verwendet, um zu vermeiden, dass sich die Schiffe zu weit von ihrem Ausgangspunkt, dem Heimatsektor, entfernen.

Beispiel:

if $ship -> get homesector
| write to logbook "Das Schiff hat einen Heimatsektor."
end

Hier wird abgefragt, ob $ship -> einen Heimatsektor hat und wenn ja, wird eine Nachricht in das Logbuch geschrieben.


Zu finden unter:

User avatar
Capux
Posts: 2456
Joined: Sat, 31. Oct 09, 21:17
x4

[34]286499

Post by Capux » Tue, 28. Sep 10, 20:32

[skip|else] if [not]|while [not]| <RetVar> = <RefObj> -> get homesector


[skip|else] if [not]|while [not]| = Istruzione condizionale che può essere usata
<RetVar> = Varaibile dove viene salvata l'informazione richiesta
<RefObj> = L'oggetto da cui prendi l'informazione richiesta.


Restuitisce il settore base di <RefObj>. Se <RefObj> non ha un settore base o non esiste, il comano restituisce null.

Il settore base è rilevante solo per le navi NPC controllate dagli script di default della versione vanilla. Solitamente punta al settore dove la nave è stata generata (o spawnata). Per esempio è usato dagli script per le pattuglie per impedire alle navi di andare troppo lontano dal settore dove sono state create.


Esempio
if $ship -> get homesector
| write to logbook "the ship has a homesector"
end


Posizione dell'istruzione nella lista:

Locked

Return to “MSCI Reference”