setName

From Bohemia Interactive Community
Revision as of 11:24, 13 May 2022 by Lou Montana (talk | contribs) (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Sets the name of a location or a person. In Arma 3 this can be used to set name of a person but only in single player.
Groups:
Unit IdentityLocations

Syntax 1

Syntax:
unit setName name
Parameters:
unit: Object
name: String
Return Value:
Nothing

Syntax 2

Syntax:
unit setName [name, firstName, lastName]
Parameters:
unit: Object
name: String
firstName: String
lastName: String
Return Value:
Nothing

Syntax 3

Syntax:
location setName name
Parameters:
location: Location
name: String
Return Value:
Nothing

Examples

Example 1:
myLocation setName "My Location Name";
Example 2:
player setName "New Name";
Example 3:
player setName ["Ben Kerry","Ben","Kerry"];

Additional Information

See also:
name nameSound setNameSound setIdentity

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Posted on September 19, 2013‎
Druid
Support of a person as the first parameter from Arma 3 v. 1.02.
Posted on April 12, 2014
Waffle SS.
Seems to have no effect on players in Multiplayer. (Arma 3 v1.00)
Posted on August 18, 2014
Pierre MGI
Only last name will appear in command bar i.e. this setname _mynameArray will display _mynameArray select 2. If setname is used with a string : this setname "blah", nothing occurs in command bar and default randomized name is displayed.

Dealing with the units' names in a script, _x (in a foreach units group, for example) will return the "object" as B ALFA 4-1:2 or the name written in ai unit name field in editor (if exists). This context is rather a "variable name" for each object (ai) than an "identity name" as given via setname function.