Difference between revisions of "Osiris/API/CharacterRecruitCharacter"
From Divinity Engine Wiki
m (Clarify that summons and party followers also join the new party) |
m |
||
| Line 2: | Line 2: | ||
* call '''CharacterRecruitCharacter'''('''''[in]'''(CHARACTERGUID)'''''_TargetCharacter''','''''[in]'''(CHARACTERGUID)'''''_OwnerCharacter''') | * call '''CharacterRecruitCharacter'''('''''[in]'''(CHARACTERGUID)'''''_TargetCharacter''','''''[in]'''(CHARACTERGUID)'''''_OwnerCharacter''') | ||
===== Description ===== | ===== Description ===== | ||
| − | Turns NPC '''_TargetCharacter''' into a player-controlled character. The character will be assigned to the [[Osiris/API/CharacterGetReservedUserID|user]] that hosts the game, and hence also to their [[Osiris/API/AddToParty|party]] | + | Turns NPC '''_TargetCharacter''' into a [[Osiris/API/CharacterIsPlayer|player-controlled character]]. The character will be assigned to the [[Osiris/API/CharacterGetReservedUserID|user]] that hosts the game, and hence also to their [[Osiris/API/AddToParty|party]]. It will appear in the portrait list after '''_OwnerCharacter'''. |
===== Notes ===== | ===== Notes ===== | ||
* If '''_TargetCharacter''' is already a player-controlled character, this call does nothing. In particular, in that case it will not change the party assignment of '''_TargetCharacter'''. | * If '''_TargetCharacter''' is already a player-controlled character, this call does nothing. In particular, in that case it will not change the party assignment of '''_TargetCharacter'''. | ||
Revision as of 23:43, 28 November 2017
Full Definition(s)
- call CharacterRecruitCharacter([in](CHARACTERGUID)_TargetCharacter,[in](CHARACTERGUID)_OwnerCharacter)
Description
Turns NPC _TargetCharacter into a player-controlled character. The character will be assigned to the user that hosts the game, and hence also to their party. It will appear in the portrait list after _OwnerCharacter.
Notes
- If _TargetCharacter is already a player-controlled character, this call does nothing. In particular, in that case it will not change the party assignment of _TargetCharacter.
- Any summons and party followers of _TargetCharacter will also move to _TargetCharacter's new party.
