Difference between revisions of "Osiris/API/CharacterAssignToUser"
From Divinity Engine Wiki
m (Link to API page that explains what a user is) |
m |
||
(8 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
===== Full Definition(s) ===== | ===== Full Definition(s) ===== | ||
− | * call '''CharacterAssignToUser'''( | + | * call '''CharacterAssignToUser'''(''(INTEGER)'''''_UserID''', ''(CHARACTERGUID)'''''_Character''') |
===== Description ===== | ===== Description ===== | ||
− | Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID|user]] with ID '''_UserID'''. | + | Assigns control over the [[Osiris/API/CharacterIsPlayer|player-controlled character]] '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID|user]] with ID '''_UserID'''. The character will also be moved to the new user's [[Osiris/API/AddToParty|party]]. |
===== Notes ===== | ===== Notes ===== | ||
− | * | + | * This routine does nothing if '''_Character''' is '''NULL''', if it's not a player-controlled character, or if it is already assigned to the user with ID '''_UserID'''. |
+ | * Characters can also be assigned to users by the game engine itself when they connect to a game or when someone else disconnects. | ||
===== See Also ===== | ===== See Also ===== | ||
* [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]] | * [[Osiris/API/CharacterGetReservedUserID|CharacterGetReservedUserID]] | ||
+ | * [[Osiris/API/CharacterMakeNPC|CharacterMakeNPC]] | ||
* [[Osiris/API/CharacterMakePlayer|CharacterMakePlayer]] | * [[Osiris/API/CharacterMakePlayer|CharacterMakePlayer]] | ||
* [[Osiris/API/CharacterRecruitCharacter|CharacterRecruitCharacter]] | * [[Osiris/API/CharacterRecruitCharacter|CharacterRecruitCharacter]] | ||
− | + | * [[Osiris/API/CharacterReservedUserIDChanged|CharacterReservedUserIDChanged]] | |
− | [[Category:Osiris Calls]] | + | |
+ | [[Category:Osiris Calls|CharacterAssignToUser]] |
Latest revision as of 16:13, 19 December 2017
Full Definition(s)
- call CharacterAssignToUser((INTEGER)_UserID, (CHARACTERGUID)_Character)
Description
Assigns control over the player-controlled character _Character to the user with ID _UserID. The character will also be moved to the new user's party.
Notes
- This routine does nothing if _Character is NULL, if it's not a player-controlled character, or if it is already assigned to the user with ID _UserID.
- Characters can also be assigned to users by the game engine itself when they connect to a game or when someone else disconnects.