Osiris/API/CharacterIsPlayer: Difference between revisions

From Divinity Engine Wiki
Jump to navigation Jump to search
(Osiris Core APIs)
 
mNo edit summary
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
===== Full Definition(s) =====
===== Full Definition(s) =====
* query '''CharacterIsPlayer'''('''''[in]'''(CHARACTERGUID)'''''_Character''', '''''[out]'''''(INTEGER)'''_Bool''')
* query '''CharacterIsPlayer'''('''''[in]'''(CHARACTERGUID)'''''_Character''', '''''[out]'''(INTEGER)'''''_Bool''')
===== Description =====
===== Description =====
Returns whether '''_Character''' is ''player-controlled''.
Returns whether '''_Character''' is ''player-controlled''.
===== Return Values =====
===== Return Values =====
* '''Success/Failure''': Fails if '''_Character''' does not exist'''.'''
* '''Success/Failure''': Fails if '''_Character''' does not exist.
* '''_Bool''': '''1''' if '''_Character''' is ''player-controlled'', '''0''' if not'''.'''
* '''_Bool''': '''1''' if '''_Character''' is ''player-controlled'', '''0''' if not.
===== Notes =====
===== Notes =====
* Apart from avatars and recruited companions, ''player-controlled'' characters also include summons and followers.
* ''Player-controlled'' characters include:
** Avatars: character chosen during character creation
** Recruited companions: NPCs turned into players afterwards through [[Osiris/API/CharacterMakePlayer|CharacterMakePlayer]]
** [[Osiris/API/CharacterIsSummon|Summons]] by other player-controlled characters
** [[Osiris/API/CharacterAddToPlayerCharacter|Party followers]] of player-controlled characters
* ''Player-controlled'' characters explicitly do ''not'' include [[Osiris/API/CharacterFollowCharacter|regular followers]].
===== See Also =====
===== See Also =====
* [[Osiris/API/CharacterIsPartyFollower]]
* [[Osiris/API/CharacterAddToPlayerCharacter|CharacterAddToPlayerCharacter]]
* [[Osiris/API/CharacterIsSummon]]
* [[Osiris/API/CharacterGetOwner|CharacterGetOwner]]
* [[Osiris/API/CharacterFollowCharacter]]
* [[Osiris/API/CharacterIsControlled|CharacterIsControlled]]
* [[Osiris/API/CharacterIsPartyFollower|CharacterIsPartyFollower]]
* [[Osiris/API/CharacterIsPartyMember|CharacterIsPartyMember]]
* [[Osiris/API/CharacterIsSummon|CharacterIsSummon]]
   
   
[[Category:Osiris Queries]]
[[Category:Osiris Queries|CharacterIsPlayer]]

Latest revision as of 13:26, 28 January 2019

Full Definition(s)
  • query CharacterIsPlayer([in](CHARACTERGUID)_Character, [out](INTEGER)_Bool)
Description

Returns whether _Character is player-controlled.

Return Values
  • Success/Failure: Fails if _Character does not exist.
  • _Bool: 1 if _Character is player-controlled, 0 if not.
Notes
  • Player-controlled characters include:
    • Avatars: character chosen during character creation
    • Recruited companions: NPCs turned into players afterwards through CharacterMakePlayer
    • Summons by other player-controlled characters
    • Party followers of player-controlled characters
  • Player-controlled characters explicitly do not include regular followers.
See Also