SetElementSyncer: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
{{Server function}}
{{Server function}}
__NOTOC__  
__NOTOC__  
This function can be used to change the syncer ([[player]]) of an element. The function can be also used to remove element's syncer.
This function can be used to change the syncer ([[player]]) of an element. The function can be also used to remove an element's syncer.


Using the function to change an elements syncer will only last as long as the element is within syncable range of the player. (i.e. It is streamed in for that player). As soon as it becomes impossible for your chosen player to sync the element, another player will be automatically selected, and your setting will be lost. With vehicles, the last passenger to leave a vehicle will be selected as the syncer and override any setting you may have made.
Please note that using this function to change an element's syncer will only last as long as the element is within syncable range of the player. (i.e. It is streamed in for that player). As soon as it becomes impossible for your chosen player to sync the element, another player will be automatically selected, and your setting will be lost. With vehicles, the last occupant to leave a vehicle will be selected as the syncer and override any setting you may have made.


Using the function to turn off an elements syncer, means no player will be assigned to syncing the element. That will not be changed until setElementSyncer is called again.
Using this function to remove an element's syncer, means no player will be assigned to syncing the element. That will not be changed until setElementSyncer is called again.
It should be noted that certain network changes to an element do not require a syncer. Things such as destroying an element or explicitly setting the elements position (in a server side script), will still be updated on all clients regardless of this setting.
It should also be noted that certain network changes to an element do not require a syncer. Actions such as destroying an element or explicitly setting the element's position (in a server side script), will still be updated on all clients regardless of this setting.


==Syntax==  
==Syntax==  
Line 16: Line 16:
===Required Arguments===  
===Required Arguments===  
*'''theElement:''' The [[element]] whose syncer you wish to change.
*'''theElement:''' The [[element]] whose syncer you wish to change.
*'''thePlayer:''' The [[player]] who should be the new syncer of the element. If set to [[false]], this element will not have a syncer. If set to [[true]], the most relevant player will become the elements syncer.
*'''thePlayer:''' The [[player]] who should be the new syncer of the element. If set to [[false]], this element will not have a syncer. If set to [[true]], the most relevant player will become the element's syncer.


===Returns===
===Returns===
Returns ''true'' if the syncer was changed succesfully, ''false'' otherwise.
Returns ''true'' if the syncer was changed successfully, ''false'' otherwise.


==Example==  
==Example==  

Revision as of 20:47, 26 April 2010

This function can be used to change the syncer (player) of an element. The function can be also used to remove an element's syncer.

Please note that using this function to change an element's syncer will only last as long as the element is within syncable range of the player. (i.e. It is streamed in for that player). As soon as it becomes impossible for your chosen player to sync the element, another player will be automatically selected, and your setting will be lost. With vehicles, the last occupant to leave a vehicle will be selected as the syncer and override any setting you may have made.

Using this function to remove an element's syncer, means no player will be assigned to syncing the element. That will not be changed until setElementSyncer is called again. It should also be noted that certain network changes to an element do not require a syncer. Actions such as destroying an element or explicitly setting the element's position (in a server side script), will still be updated on all clients regardless of this setting.

Syntax

bool setElementSyncer ( element theElement, player thePlayer )

Required Arguments

  • theElement: The element whose syncer you wish to change.
  • thePlayer: The player who should be the new syncer of the element. If set to false, this element will not have a syncer. If set to true, the most relevant player will become the element's syncer.

Returns

Returns true if the syncer was changed successfully, false otherwise.

Example

Click to collapse [-]
Server
-- TODO

See Also

Shared


Retrieved from "https://wiki.multitheftauto.com/wiki/SetElementSyncer?oldid=23126"