Osiris/API/CharacterAssignToUser - Revision history

Tinkerer at 15:13, 19 December 2017

2017-12-19T15:13:39Z

← Older revision		Revision as of 15:13, 19 December 2017
Line 13:		Line 13:
	* [[Osiris/API/CharacterReservedUserIDChanged\|CharacterReservedUserIDChanged]]		* [[Osiris/API/CharacterReservedUserIDChanged\|CharacterReservedUserIDChanged]]

	[[Category:Osiris Calls]]		[[Category:Osiris Calls\|CharacterAssignToUser]]

Tinkerer at 18:47, 29 November 2017

2017-11-29T18:47:22Z

← Older revision		Revision as of 18:47, 29 November 2017
Line 6:		Line 6:
	* 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'''.		* 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.		* Characters can also be assigned to users by the game engine itself when they connect to a game or when someone else disconnects.
	* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.
	===== See Also =====		===== See Also =====
	* [[Osiris/API/CharacterGetReservedUserID\|CharacterGetReservedUserID]]		* [[Osiris/API/CharacterGetReservedUserID\|CharacterGetReservedUserID]]

Tinkerer at 18:46, 29 November 2017

2017-11-29T18:46:59Z

← Older revision		Revision as of 18:46, 29 November 2017
Line 5:		Line 5:
	===== 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'''.		* 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.		* Characters can also be assigned to users by the game engine itself when they connect to a game or when someone else disconnects.
	* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.
	===== See Also =====		===== See Also =====

Tinkerer at 13:12, 29 November 2017

2017-11-29T13:12:39Z

← Older revision		Revision as of 13:12, 29 November 2017
Line 4:		Line 4:
	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]].		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 ~~Osiris/API/CharacterIsPlayer\|~~player-controlled character, or if it is already assigned to the user with ID '''_UserID'''.		* 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.		* Characters can also be assigned to users by the game engine itself when they connect to a game.
	* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.

Tinkerer: CharacterAssignToUser also moves the character to the user's party, and documented when this routine fails

2017-11-29T13:12:18Z

CharacterAssignToUser also moves the character to the user's party, and documented when this routine fails

← Older revision		Revision as of 13:12, 29 November 2017
Line 2:		Line 2:
	* call '''CharacterAssignToUser'''(''(INTEGER)'''''_UserID''', ''(CHARACTERGUID)'''''_Character''')		* 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 Osiris/API/CharacterIsPlayer\|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.		* Characters can also be assigned to users by the game engine itself when they connect to a game.
	* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.

Tinkerer at 22:45, 28 November 2017

2017-11-28T22:45:44Z

← Older revision		Revision as of 22:45, 28 November 2017
Line 1:		Line 1:
	===== Full Definition(s) =====		===== Full Definition(s) =====
	* call '''CharacterAssignToUser'''(~~'''''[in]'~~''(INTEGER)'''''_UserID''',~~'''''[in]'~~''(CHARACTERGUID)'''''_Character''')		* 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 player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.

Tinkerer at 13:15, 28 November 2017

2017-11-28T13:15:24Z

← Older revision		Revision as of 13:15, 28 November 2017
Line 8:		Line 8:
	===== 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]]

Tinkerer at 13:08, 28 November 2017

2017-11-28T13:08:10Z

← Older revision		Revision as of 13:08, 28 November 2017
Line 4:		Line 4:
	Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.		Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.
	===== Notes =====		===== Notes =====
			* Characters can also be assigned to users by the game engine itself when they connect to a game.
	* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.
	===== See Also =====		===== See Also =====
Line 9:		Line 10:
	* [[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]]

Tinkerer at 11:50, 28 November 2017

2017-11-28T11:50:38Z

← Older revision		Revision as of 11:50, 28 November 2017
Line 4:		Line 4:
	Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.		Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.
	===== Notes =====		===== Notes =====
	* ~~UserIDs~~ are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* User IDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.
	===== See Also =====		===== See Also =====
	* [[Osiris/API/CharacterGetReservedUserID\|CharacterGetReservedUserID]]		* [[Osiris/API/CharacterGetReservedUserID\|CharacterGetReservedUserID]]

Tinkerer: Link to API page that explains what a user is

2017-11-28T11:50:25Z

Link to API page that explains what a user is

← Older revision		Revision as of 11:50, 28 November 2017
Line 2:		Line 2:
	* call '''CharacterAssignToUser'''('''''[in]'''(INTEGER)'''''_UserID''','''''[in]'''(CHARACTERGUID)'''''_Character''')		* call '''CharacterAssignToUser'''('''''[in]'''(INTEGER)'''''_UserID''','''''[in]'''(CHARACTERGUID)'''''_Character''')
	===== Description =====		===== Description =====
	Assigns control over the player-controlled character '''_Character''' to the user with ID '''_UserID'''.		Assigns control over the player-controlled character '''_Character''' to the [[Osiris/API/CharacterGetReservedUserID\|user]] with ID '''_UserID'''.
	===== Notes =====		===== Notes =====
	* UserIDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.		* UserIDs are volatile: they can change at any time, in particular when loading a saved game, or when someone disconnects and reconnects. Never store this value in a database. Only use it immediately after requesting it, within the same frame.

← Older revision		Revision as of 13:15, 28 November 2017
Line 8:		Line 8:
	===== 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]]