Difference between revisions of "MK8 Network Protocol"

From MK8
Jump to navigation Jump to search
(Created page with "This page describes the '''network protocol''' used by Mario Kart 8. It is very incomplete at this moment. {{textbox|red center|In Progress|This article is managed by Leser...")
 
m
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
This page describes the '''network protocol''' used by Mario Kart 8. It is very incomplete at this moment.
 
This page describes the '''network protocol''' used by Mario Kart 8. It is very incomplete at this moment.
−
 
−
{{textbox|red center|In Progress|This article is managed by [[Leseratte]] and will grow slowly. Feel free to edit typos and grammatical or speech issues. If you have additional information, please complete this page.}}
 
  
 
__TOC__
 
__TOC__
Line 7: Line 5:
 
== General description ==
 
== General description ==
  
−
The [[Mario Kart 8]] traffic starts with a name resolution. Other than MKWii, MK8 only looks up one domain (api-eu.olv.nintendo.net) which has multiple IP addresses with a TTL of 60:  
+
The [[Mario Kart 8]] traffic starts with a name resolution. The loginserver (api-eu.olv.nintendo.net) has multiple IP addresses with a TTL of 60:  
  
 
* 54.72.185.220
 
* 54.72.185.220
Line 15: Line 13:
 
and maybe some more
 
and maybe some more
  
−
Maybe the olv-server returns some IPs of the other servers, but it's SSL-encrypted and the server does not listen on HTTP.  
+
First the game connects the Nintendoservers, while racing, all WiiUs communicate directly to each other.
  
−
First the game connects the Nintendoserver, while racing, all WiiUs communicate directly to each other.
+
All P2P packets have a header, a payload and a checksum
  
−
All p2p packets have a header, and most of them have a payload (data) and a checksum
+
== The P2P headers ==
 +
 
 +
There are two different headers: One header at the beginning of each packet ...
  
 
<pre>
 
<pre>
−
typedef struct p2p_header
+
typedef struct udp_main_header_t
 
{
 
{
−
   /*00*/  u32 id;         // always 32ab.9864
+
   /*00*/  u32 game_magic; // always 32ab.9864
−
   /*04*/  u16 unknown_04; // mostly 0x0100
+
   /*04*/  u32 unknown_04; // ?
−
   /*06*/  u16         unknown_06;     // mostly 0x0000
+
   /*08*/  u16 timer; // Timer. Increases each 1/100 sec.
−
  /*08*/  u16 sequence_id; // any upcounting number. Number of answer is one higher than question
+
}
−
   /*0a*/  u16 sequence_id2;   // another sequence number. sometimes empty (0x0000)
+
__attribute__ ((packed)) udp_main_header_t;
−
   /*0c*/  u16 unknown_0c;
+
</pre>
−
   /*0e*/  u16         length;         // indicates the length of the data part (without header and checksum)
+
 
−
   /*10*/  u32         unknown_10;     // mostly 0x00000000.
+
... and one at the beginning of each record. A packet may contain multiple records.
−
   /*14*/  u16          unknown_14;
+
 
−
  /*16*/   u16          unknown_16
+
<pre>
−
   /*18*/  u32         unknown_18;
+
typedef struct udp_sub_header_t
−
   /*1c*/  u32         unknown_1c;     // always 0x00000000
+
   /*0a*/  u16 unknown_0a; // sequence id 2 or empty
−
  /*1e*/
+
   /*0c*/  u16 unknown_0c; // maybe client slot (0 to b), if unknown_0a not empty?
 +
   /*0e*/  u16 data_length; // little endian, data length without headers and checksum
 +
   /*10*/  u32 receiver_slots; // Used slot bitmask of receiver (one or two bits set)
 +
                                        // 0x0001 -> slot 0; 0x0200 -> slot 9; 0x0000 -> no slot assigned
 +
   /*14*/  u32 sender_pid; // profile ID / any unique ID of sender
 +
   /*18*/  u32 unknown_18; // ?
 +
   /*1c*/  u32 unknown_1c; // always 0x00000000
 
}
 
}
 +
__attribute__ ((packed)) udp_sub_header_t;
 
</pre>
 
</pre>
  
−
After the header, there is some data (sometimes empty), and after the data there mostly follows a 16-byte-checksum which looks like a MD5 hash.
+
After the main header there may follow one or more sub headers including data, after all records there is a 16-byte-checksum which looks like a MD5 hash.
 +
 
 +
== Record types ==
 +
 
 +
* [[MK8_Network_Protocol/USERINFO|USERINFO]]
 +
 
 +
[[Category:Network Protocol|!]]
 +
[[mkw:MKWii Network Protocol]]

Latest revision as of 16:53, 21 February 2017

This page describes the network protocol used by Mario Kart 8. It is very incomplete at this moment.

General description

The Mario Kart 8 traffic starts with a name resolution. The loginserver (api-eu.olv.nintendo.net) has multiple IP addresses with a TTL of 60:

  • 54.72.185.220
  • 54.229.32.160
  • 54.246.156.135
  • 176.34.135.172

and maybe some more

First the game connects the Nintendoservers, while racing, all WiiUs communicate directly to each other.

All P2P packets have a header, a payload and a checksum

The P2P headers

There are two different headers: One header at the beginning of each packet ... 

typedef struct udp_main_header_t
{
  /*00*/   u32		game_magic;	// always 32ab.9864
  /*04*/   u32		unknown_04;	// ?
  /*08*/   u16		timer;		// Timer. Increases each 1/100 sec.
}
__attribute__ ((packed)) udp_main_header_t;

... and one at the beginning of each record. A packet may contain multiple records. 

typedef struct udp_sub_header_t
  /*0a*/   u16		unknown_0a;	// sequence id 2 or empty
  /*0c*/   u16		unknown_0c; 	// maybe client slot (0 to b), if unknown_0a not empty?
  /*0e*/   u16		data_length; 	// little endian, data length without headers and checksum
  /*10*/   u32		receiver_slots;	// Used slot bitmask of receiver (one or two bits set)
                                        // 0x0001 -> slot 0; 0x0200 -> slot 9; 0x0000 -> no slot assigned
  /*14*/   u32		sender_pid; 	// profile ID / any unique ID of sender
  /*18*/   u32		unknown_18; 	// ?
  /*1c*/   u32		unknown_1c; 	// always 0x00000000
}
__attribute__ ((packed)) udp_sub_header_t;

After the main header there may follow one or more sub headers including data, after all records there is a 16-byte-checksum which looks like a MD5 hash.

Record types

mkw:MKWii Network Protocol

Retrieved from "https://mk8.tockdom.com/w/index.php?title=MK8_Network_Protocol&oldid=3010"