Commands: player

Returns the action state of a player.
ACTION 0 means that the player is standing on the ground or walking. Other action states mean that he is either jumping or flying through the air.

Returns the ALLIANCE (= color) of PLAYER.
ALLIANCE is a value from 1 to 8. All players with the same ALLIANCE are friends, players with different ALLIANCE are enemies.

The command returns 0 if it failed to get the alliance (for example if PLAYER does not exist).

Each alliance has its own color (R,G,B):

Returns if the player can be controlled (1) or not (0). Default is 1. It will only be 0 if the command playercontrol has been used to deactivate player control.

Returns the direction of PLAYER either as -1 for left or as 1 for right.

Returns the health of PLAYER.
Values smaller than 1 mean that PLAYER is dead.
A value of -2147483648 means that PLAYER drowned.

Returns the current weapon rotation angle of PLAYER.

Checks if a STATE of a PLAYER is active or not. Returns either 1 for an active state or 0 for an inactive state.

States are:
state_poisoned
state_confused
state_frozen
state_sleeping
state_invisible

Returns the TEAM of PLAYER.
The team ID can range from 0 to 7 (there's a maximum of 8 teams).

Returns a string with the weapon Lua table of the currently selected weapon of the active player.

Returns if the player can switch the weapon (1) or not (0). Default is 1. It will only be 0 if the command playerweaponswitch has been used to deactivate weapon switching.

Returns the X coordinate/position of PLAYER.

Returns the x speed of PLAYER (flying speed).

Returns the Y coordinate/position of PLAYER.

Returns the y speed of PLAYER (flying speed).

(De-)activates the player control. The player will only be controlled if playercontrol is set to 1. The game sets playercontrol to 1 automatically on the start of each turn.
Disable playercontrol if you want to create weapons which can be controlled after launching.

Returns the ID of the player who is currently controlled.

Decreases the health of PLAYER by DAMAGE.

Forces the game to render the player with a certain frame, no matter if he is falling/walking/standing/...

Most important frames are:
0 - standing (with arms)
1 - walking frame 1 / standing (no arms)
2 - walking frame 2 (no arms)
3 - jumping (with arms)
4 - falling (with arms)

Note: The frame will be forced for the next render only. You have to call this command continuously to keep that frame. Therefore you should call this command in a draw-function!

Increases the health of PLAYER by HEAL.

Sets the position of a player to the (X|Y) coordinate.

Pushs a certain player with the speeds PUSH X and PUSH Y.
Use ABSOLUTE 1 to set the values. Use ABSOLUTE 0 to add the values to the current speed values.
Use PUSH OTHERS to control if this push is able to move other players on contact or not.

For comparison:
A normal jump equals a push with X=3, Y=-3.
A back jump equals a push with X=1,Y=-5.
(the X speed depends on the player direction of course and can also be -3 or -1 for that reason)

Enables (SET=1) or disables (SET=0) a STATE of PLAYER.

States are:
state_poisoned
state_confused
state_frozen
state_sleeping
state_invisible

Passes the control to PLAYER.
PLAYER has to be a player who is in the same team as the current player and who is still living.

Returns a table/array which contains the IDs of players in the game. The index starts at 1!

For MODE you can use these values:
0 - list of all players
1 - list of team-members of current player
2 - list of allied players of current player (same and other teams)
3 - list of enemies of current player

Note that all modes - besides mode 0 - exclude the current player (this means that the current player will not appear in the list).

By default all dead players are included. You can exclude them by setting INC DEAD to 0.

(De-)activates the possibility to switch the weapon. Weapon switching is only possible if this is set to 1. The game sets playerweaponswitch to 1 automatically on the start of each turn.
This command can be very useful for game modes or missions!