Osiris/API/CharacterRecruitCharacter: Difference between revisions

From Divinity Engine Wiki
Jump to navigation Jump to search
(CharacterRecruitCharacter)
 
No edit summary
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
===== Full Definition(s) =====
===== Full Definition(s) =====
* call '''CharacterRecruitCharacter'''(''(CHARACTERGUID)'''''_TargetCharacter''',''(CHARACTERGUID)'''''_OwnerCharacter''')
* call '''CharacterRecruitCharacter'''(''(CHARACTERGUID)'''''_TargetCharacter''', ''(CHARACTERGUID)'''''_OwnerCharacter''')
===== Description =====
===== Description =====
Turns NPC '''_TargetCharacter''' into a player-controlled character. The character will be assigned to the user that hosts the game, and will appear in the portrait list after '''_OwnerCharacter'''.
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'''.
* Any [[Osiris/API/CharacterIsSummon|summons]] and [[Osiris/API/CharacterAddToParty|party followers]] of '''_TargetCharacter''' will also move to '''_TargetCharacter''''s new party.
* Player characters must be global characters.
===== See Also =====
===== See Also =====
* [[Osiris/API/CharacterRecruitCharacter|CharacterMakePlayer]]
* [[Osiris/API/CharacterAddToParty|CharacterAddToParty]]
* [[Osiris/API/CharacterAssignToUser|CharacterAssignToUser]]
[[Category:Osiris Calls]]
* [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]]
* [[Osiris/API/CharacterMakePlayer|CharacterMakePlayer]]
 
[[Category:Osiris Calls|CharacterRecruitCharacter]]

Latest revision as of 15:07, 11 October 2018

Full Definition(s)
  • call CharacterRecruitCharacter((CHARACTERGUID)_TargetCharacter, (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.
  • Player characters must be global characters.
See Also