set_ship_text


The set_ship_text mission scripting command can be used to change various text properties of an existing named object.  Contrary to what the name of the command implies, this can be applied to more than just ships, but typically can only change their name.  The value of any optional attribute that is omitted will not be changed.

 

Attribute

Valid Values

Optional?

Description

name

text 

 

Name of object to update.  This can be any type of named object.

newname

text 

Optional

Name to change it to.

race

text

Optional

Text of race.  Only applies to enemies, neutrals, and generic meshes.

class

text

Optional

Text of class.  Only applies to enemies, neutrals, and generic meshs.

desc

text

Optional

Description the science console sees after one scan.  Only applies to enemies, neutrals, and generic meshes.

scan_desc

text

Optional

Description the science console sees after two scans.  Only applies to enemies, neutrals, and generic meshes.

hailtext

text

Optional

Text this ship will reply with when comms "hails" them.  Only applies to enemies and neutrals.

 

The following table explains attributes of various types of named objects:

Type  Name visible? Scannable? Hailable?
station  Y -
player  -
enemy  Y
neutral  Y
anomaly  always "ANOM" -
blackHole  -
monster  -
genericMesh Y Y -