Get the station where the <ship> is docked at

[Joubarbe]

Hi,

Simple question : I'd like to get the $station where the playership is docked at, to retrieve its ID code. Is there a built-in function for that ? I can't find it...

Thanks.

[Cronos988]

It might be <RefObj> -> get environment. This should give you either the sector or the object RefObj is in.

[Joubarbe]

Ok thanks, I just need to test if the playership is docked before get environment.

[Jack08]

if you spesifically want the player ship, then you can use

Code: Select all

$playerEnvironment = [PLAYERSHIP]->get environment
if $playerEnvironment->is of class {Station}
  * We are docked at $playerEnvironment
end

or

if [PLAYERSHIP]->is docked
  $playerEnvironment = [PLAYERSHIP]->get environment
end

Both are acceptable, choose whichever you prefer - the second however has less instructions if the check were to fail, the first lets you use the environment in an else case if you want to do something if he is not docked, in this case the Environment would be the players sector. If you replace [PLAYERSHIP] with a argument for example $Ship, you can use the same code for any arbitrary ship passed to the script.

[Guest]

... if the script runs on the playership, you can use simply the constant [DOCKEDAT]

[Joubarbe]

Thank you

[Litcube]

... if the script runs on the playership, you can use simply the constant [DOCKEDAT]

DOCKEDAT at works for any ship as long as the current script is being run on said ship. In other words, DOCKEDAT, HOMEBASE, etc. all refer to the THIS object.