MTA R1 remote administration protocol

From Multi Theft Auto: Wiki
Revision as of 10:59, 15 January 2012 by Winky- (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Office-calendar.png Historical: This page is retained for historical reference.

Current version

Current protocol version is R1.1.

Notes

This document outlines the network protocol for the Remote Administration system used in Multi Theft Auto : San Andreas Race Modification R1. This document is intended for people to create their own Remote Administration tools if they wish to.

No details will be given on how creation of these tools can be done, please seak outside assistance if help is required in this area. This document is only meant as a guide.

Warning

THE ADMINISTRATION SYSTEM IN MTA:SA HAS A SCHEDULED OVERHALL PLANNED FOR FUTURE RELEASES. AS A RESULT THE NETCODE IN THIS DOCUMENT WILL BE CHANGING SIGNIFICANTLY. NOTIFICATION OF THIS WILL BE GIVEN WHEN A VERSION IS RELEASED WITH ANY CHANGES.


Packet List

This is where the packet ID's are detailed. Descriptions of how the individual packets are made up will be given further down.

NOTE: Every packet sent and recieved has a byte of value 0x6D as the 1st byte. This will be denoted as ADMIN_PACKET_HEADER throughout this document.

  • ADMIN_CONNECT = 0x00
  • ADMIN_DISCONNECT = 0x01
  • ADMIN_PING = 0x02
  • ADMIN_CHAT = 0x03
  • ADMIN_PLAYER_JOIN = 0x04
  • ADMIN_PLAYER_PART = 0x05
  • ADMIN_PLAYER_LOGIN = 0x06
  • ADMIN_KICK = 0x07
  • ADMIN_BAN = 0x08
  • ADMIN_ADDBAN = 0x09
  • ADMIN_UNBAN = 0x0A
  • ADMIN_CHANGE_SERVER_PASSWORD = 0x0B
  • ADMIN_SERVER_SHUTDOWN = 0x0C
  • ADMIN_PLAYER_MUTE = 0x0D
  • ADMIN_PLAYER_FREEZE = 0x0E
  • ADMIN_PLAYER_NICK_CHANGE = 0x0F
  • ADMIN_PLAYER_DEATH = 0x10
  • ADMIN_PLAYER_PM = 0x11
  • ADMIN_RACE_LIST = 0x12
  • ADMIN_START_RACE = 0x13
  • ADMIN_SET_MAX_PLAYERS = 0x14

Packet Description Formating

This is where the packets are described. They will be covered in order of packet ID (Check the enumerations above). Full descriptions of the packets and what is sent and recieved is described.

The packet makeup key is made up of bytes sent (Hexidecimal values are given when there is not an enumeration avaliable).

Strings sent in the bytestream will be denoted like:

[ string ( description ) ]

Variable bytes sent will be denoted like:

[ byte ( description ) ]

Looped information in packets will be denoted like:

{ loop < number of times > ( makeup of each itteration of loop ) end-loop }

ADMIN_CONNECT

Description:

This is sent to the server to connect to it. The server server will respond depending on whether the attempt was successful or not.

Packet sent to server:

ADMIN_PACKET_HEADER ADMIN_CONNECT 0x01 [ string ( password ) ] 0x7C [ string ( username ) ] 0x00

Response packet from server:

If the connect attempt is successful, the following packet is recieved:

ADMIN_PACKET_HEADER ADMIN_CONNECT [ byte ( Max players ) ] [ byte ( Current max players ) ] 
0xFF { loop < Number of players > ( [ byte ( Player ID ) ] [ byte ( Player rcon level ) ] 
[ byte ( Player mute status ) ] [ byte ( Player frozen status ) ] [ byte ( 1st byte of player IP ) ] 
[ byte ( 2nd byte of player IP ) ] [ byte ( 3rd byte of player IP ) ] [ byte ( 4th byte of player IP ) ] 
[ string ( Player Name ) ] 0xFF ) end-loop } 0x00

If the connect attempt is unsucessful, the following packet is recieved:

ADMIN_PACKET_HEADER ADMIN_DISCONNECT [ byte ( Disconnect reason ) ]

Notes:

Player rcon level ranges from 0x00 to 0x05 and denotes the level of rcon the player has in the server. Player mute status is either 0x00 (muted) or 0x01 (not muted). Player frozen status is either 0x00 (frozen) or 0x01 (not frozen).

The disconnect reason has the following enumerations:

  • CONNECT_DISCONNECT = 0x00
  • CONNECT_FAILED_BAD_PASS = 0x01
  • CONNECT_CONNECTED = 0x02
  • CONNECT_TIMED_OUT = 0x03
  • CONNECT_TOO_MANY_USERS_FROM_IP = 0x04
  • CONNECT_BANNED = 0x05
  • CONNECT_NAME_IN_USE = 0x06
  • CONNECT_INVALID_VERSION = 0x07

ADMIN_DISCONNECT

Description:

This packet is sent when to disconnect from the server. The server will send a response confirming this.

Packet sent to server:

ADMIN_PACKET_HEADER ADMIN_DISCONNECT

Response packet from server:

ADMIN_PACKET_HEADER ADMIN_DISCONNECT 0x00

ADMIN_PING

Description:

This packet is sent from the server to the Remote Admin clients every second. The Remote Admin client should respond.

Packet recieved from server:

ADMIN_PACKET_HEADER ADMIN_PING

Packet sent to server in response:

ADMIN_PACKET_HEADER ADMIN_PING

ADMIN_CHAT

Description:

This is the packet that the server sends for all chat. Remote Admin clients should send this packet to chat.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_CHAT [ string ( Chat text ) ] 0x00

Packet sent from server on any chat:

ADMIN_PACKET_HEADER ADMIN_CHAT [ byte ( Player ID ) ] [ byte ( Chat type ) ] [ string ( Chat text ) ]

Notes:

Player ID will be 255 if an Admin or Console are chatting. The chat type has the following enumeration:
  • ADMIN_CONSOLE_CHAT = 0x00
  • ADMIN_ADMIN_CHAT = 0x01
  • ADMIN_PLAYER_CHAT = 0x02

ADMIN_PLAYER_JOIN

Description:

This packet is recieved from the server when a new player joins the game.

Packet recieved from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_JOIN [ byte ( Player ID ) ] [ string ( Player name ) ] 0x7C [ byte ( 1st byte of player IP ) ] 
[ byte ( 2nd byte of player IP ) ] [ byte ( 3rd byte of player IP ) ] [ byte ( 4th byte of player IP ) ]

ADMIN_PLAYER_PART

Description:

This packet is recieved from the server when a player parts.

Packet recieved from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_PART [ byte ( Player ID ) ] [ byte ( Part reason ) ]

Notes:

The part reasons have the following enumerations:

  • ADMIN_PLAYER_PARTED = 0x00
  • ADMIN_PLAYER_KICKED = 0x01
  • ADMIN_PLAYER_BANNED = 0x02
  • ADMIN_PLAYER_TIMED_OUT = 0x03

ADMIN_PLAYER_LOGIN

Description:

This packet is recieved from the server when a player logs in to rcon admin.

Packet recieved from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_LOGIN [ byte ( Player ID ) ] [ byte ( Login type ) ] [ byte ( Rcon level ) ]

Notes:

The rcon level will be between 0x00 and 0x05.

The login type has the following enumerations:

  • ADMIN_LOGIN_SUCCESS = 0x00
  • ADMIN_LOGIN_FAILED = 0x01
  • ADMIN_LOGIN_LOGGED_IN = 0x02

ADMIN_KICK

Description:

This packet is sent to the server to kick a player. The response will be a ADMIN_PLAYER_PART packet if successful.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_KICK [ byte ( Player ID ) ]

ADMIN_BAN

Description:

This packet is sent to the server to ban a player. The response will be a ADMIN_PLAYER_PART packet if successful.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_BAN [ byte ( Player ID ) ]

ADMIN_ADDBAN

Description:

This packet is sent to the server to ban an IP. The server will respond with a packet outlining the outcome.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_ADDBAN [ string ( IP ) ]

Response from server:

ADMIN_PACKET_HEADER ADMIN_ADDBAN [ byte ( Response ) ]

Notes:

The response has the following enumerations:

  • ADMIN_BAN_SUCCESS = 0x00
  • ADMIN_BAN_FAILED = 0x01

ADMIN_UNBAN

Description:

This packet is sent to the server to unban an IP. The server will respond with a packet outlining the outcome.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_UNBAN [ string ( IP ) ]

Response from server:

ADMIN_PACKET_HEADER ADMIN_UNBAN [ byte ( Response ) ]

Notes:

The response has the following enumerations:

  • ADMIN_UNBAN_SUCCESS = 0x00
  • ADMIN_UNBAN_FAILED = 0x01

ADMIN_CHANGE_SERVER_PASSWORD

Description:

This packet is sent to the server to change the server password, if it is enabled on the server. The server will respond with the outcome.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_CHANGE_SERVER_PASSWORD [ string ( New password ) ]

Response from server:

ADMIN_PACKET_HEADER ADMIN_CHANGE_SERVER_PASSWORD [ byte ( Response ) ]

Notes:

The response has the following enumerations:

  • ADMIN_SERVER_PASSWORD_CHANGED = 0x00
  • ADMIN_SERVER_PASSWORD_FAILED = 0x01
  • ADMIN_SERVER_PASSWORD_DISABLED = 0x02

ADMIN_SERVER_SHUTDOWN

Description:

This packet is sent to the server to shut it down, if enabled on the server. The packet must be sent twice within 5 seconds for this to be successful.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_SERVER_SHUTDOWN

Response from server:

ADMIN_PACKET_HEADER ADMIN_SERVER_SHUTDOWN [ byte ( Response ) ]

Notes:

The response has the following enumerations:

  • ADMIN_SERVER_SHUTDOWN_SUCCESS = 0x00
  • ADMIN_SERVER_SHUTDOWN_WAITING = 0x01
  • ADMIN_SERVER_SHUTDOWN_DISABLED = 0x02

ADMIN_PLAYER_MUTE

Description:

This packet is sent to the server to mute/unmute a player. It is also sent from the server when a player is muted/unmuted and responds to a packet with a success or failure.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_PLAYER_MUTE [ byte ( Player ID ) ] [ byte ( Mute/unmute ) ]

Notes:

The mute/unmute byte has the following enumerations:

  • ADMIN_PLAYER_MUTE = 0x00
  • ADMIN_PLAYER_UNMUTE = 0x01

Packet sent from server if successful:

ADMIN_PACKET_HEADER ADMIN_PLAYER_MUTE [ byte ( Player ID ) ] [ byte ( Muter ID ) ] [ byte ( Mute/unmute ) ]

Notes:

The muted ID is either a player ID (the player who muted the person) or it is 0xFF for a mute from the Console or 0xFE for a mute from Remote Admin. The Mute/unmute byte has the following enumerations:

  • ADMIN_MUTE_SUCCESS = 0x02
  • ADMIN_UNMUTE_SUCCESS = 0x03

Packet sent from the server if unsuccessful:

ADMIN_PACKET_HEADER ADMIN_PLAYER_MUTE [ byte ( Player ID ) ] [ byte ( Already muted/unmuted ) ]

Notes:

The already muted/unmuted byte has the following enumerations:

  • ADMIN_MUTE_FAILED = 0x00
  • ADMIN_UNMUTE_FAILED = 0x01

ADMIN_PLAYER_FREEZE

Description:

This packet is sent to the server to freeze/unfreeze a player. It is also sent from the server when a player is frozen/unfrozen and responds to a packet with a success or failure.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_PLAYER_FREEZE [ byte ( Player ID ) ] [ byte ( Freeze/unfreeze ) ]

Notes:

The freeze/unfreeze byte has the following enumerations:

  • ADMIN_PLAYER_FREEZE = 0x00
  • ADMIN_PLAYER_UNFREEZE = 0x01

Packet sent from server if successful:

ADMIN_PACKET_HEADER ADMIN_PLAYER_FREEZE [ byte ( Player ID ) ] [ byte ( Freezer ID ) ] [ byte ( Freeze/unfreeze ) ]

Notes:

The Freezer ID is either a player ID (the player who froze the person) or it is 0xFF for a freeze from the Console or 0xFE for a freeze from Remote Admin.

The Freeze/unfreeze byte has the following enumerations:

  • ADMIN_FREEZE_SUCCESS = 0x02
  • ADMIN_UNFREEZE_SUCCESS = 0x03

Packet sent from the server if unsuccessful:

ADMIN_PACKET_HEADER ADMIN_PLAYER_FREEZE [ byte ( Player ID ) ] [ byte ( Already frozen/unfrozen ) ]

Notes:

The already frozen/unfrozen byte has the following enumerations:

  • ADMIN_FREEZE_FAILED = 0x00
  • ADMIN_UNFREEZE_FAILED = 0x01

ADMIN_PLAYER_NICK_CHANGE

Description:

This packet is sent from the server when a player changes their nickname.

Packet sent from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_NICK_CHANGE [ byte ( Player ID ) ] [ string ( New nickname ) ]

ADMIN_PLAYER_DEATH

Description:

This packet is sent from the server when a player dies.

Packet sent from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_DEATH [ byte ( Player ID ) ]

ADMIN_PLAYER_PM

Description:

This packet is sent from the server when a player pm's another player.

Packet sent from server:

ADMIN_PACKET_HEADER ADMIN_PLAYER_PM [ byte ( From player ID ) ] [ byte ( To player ID ) ] [ string ( Message ) ]

ADMIN_RACE_LIST

Description:

This packet is sent with a list of all the races in the server. It is sent on join and when the list changes.

Packet sent from server:

ADMIN_PACKET_HEADER ADMIN_RACE_LIST { loop < number of races > ( [ byte ( Race ID ) ] [ string ( Race name ) ] 0xFF ) end-loop }

ADMIN_START_RACE

Description: This packet is sent to the server to start a race. It is also sent from the server when a new race starts.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_START_RACE [ byte ( Race ID ) ]

Packet sent from server:

ADMIN_PACKET_HEADER ADMIN_START_RACE [ byte ( Start type ) ] [ byte ( Race ID ) ]

Notes:

Start type has the following enumerations:

  • ADMIN_RACE_STARTED = 0x00
  • ADMIN_RACE_FAILED = 0x01
  • ADMIN_RACE_NO_PLAYERS = 0x02

ADMIN_SET_MAX_PLAYERS

Description:

This packet is sent to change the max players of the server. The server will also send a packet when the max players is changed. Note that this number cannot go over the max players in the server config, nor can it ever go above 32.

Packet sent:

ADMIN_PACKET_HEADER ADMIN_SET_MAX_PLAYERS [ byte ( Max players ) ]

Response from server:

ADMIN_PACKET_HEADER ADMIN_SET_MAX_PLAYERS [ byte ( Max players ) ]

Notes:

Max players will be 0x00 if the attempt to change them failed, otherwise it will be the hexadecimal value of the new number of max players.