City17
4 years
returns reference to local player, as such it always points to yourself. Every other player in the game gets his player respectively.
Do not use this function until you understand it fully and know how to avoid desyncs! Always test your map in LAN multiplayer after changing code around it.
Warcraft 3 has the lock-step network/execution model. This means the game simulation and code run on all players' computers with the exact same data at any point in time. Look at this example:
This function is always used when you want something only to happen to a certain player. However if you aren't careful, you will cause a desync: where one player's game state is different from everybody else!
For example, you can apply camera position locally, this is how [jassdoc]SetCameraPositionForPlayer[/jassdoc] works:
Basic rule: anything that's only visual (like unit color) will not desync... unless your code relies on the exact value later in the game: if cameraX is 123 then ... different players will have different camera positions here.
On the other hand, manipulating handles or creating units locally, changing their health, attack, invisibility etc. - anything that changes the game will desync:
Do not use this function until you understand it fully and know how to avoid desyncs! Always test your map in LAN multiplayer after changing code around it.
Warcraft 3 has the lock-step network/execution model. This means the game simulation and code run on all players' computers with the exact same data at any point in time. Look at this example:
Code (lua) Select
1 function whoami_command()
2 -- all players know who entered this command, equal value on every computer3 local player_who_entered_command = GetTriggerPlayer()
4 -- this always points to you!5 local myself = GetLocalPlayer()
6 7 local command_player_name = GetPlayerName(player_who_entered_command)
8 local my_player_name = GetPlayerName(myself)
9 -- everybody will see this player's name10 DisplayTextToForce(GetPlayersAll(), "Player ".. command_player_name .." entered the whoami command!")
11 -- everybody will see their own name!12 DisplayTextToForce(GetPlayersAll(), "But my name is: ".. my_player_name)
13 end
This function is always used when you want something only to happen to a certain player. However if you aren't careful, you will cause a desync: where one player's game state is different from everybody else!
For example, you can apply camera position locally, this is how [jassdoc]SetCameraPositionForPlayer[/jassdoc] works:
Code (jass) Select
1 if (GetLocalPlayer() == whichPlayer) then
2 // Use only local code (no net traffic) within this block to avoid desyncs.3 call SetCameraPosition(x, y)
4 endif
Basic rule: anything that's only visual (like unit color) will not desync... unless your code relies on the exact value later in the game: if cameraX is 123 then ... different players will have different camera positions here.
On the other hand, manipulating handles or creating units locally, changing their health, attack, invisibility etc. - anything that changes the game will desync:
Code (jass) Select
1 if (GetLocalPlayer() == whichPlayer) then
2 // INSTANTLY DESYNCS! The unit was only killed on one player's screen! Others think it's alive3 KillUnit(someUnit)
4 endif