… | |
… | |
20 | Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
20 | Foundation, Inc. 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
21 | --> |
21 | --> |
22 | </head> |
22 | </head> |
23 | <body> |
23 | <body> |
24 | |
24 | |
25 | <h1>$Revision: 1.45 $</h1> |
25 | <h1>$Revision: 1.46 $</h1> |
26 | |
26 | |
27 | <h1>KGS Protocol Description</h1> |
27 | <h1>KGS Protocol Description</h1> |
28 | |
28 | |
29 | <p>This XML document describes the KGS protocol. It is also used |
29 | <p>This XML document describes the KGS protocol. It is also used |
30 | to automatically generate the perl parser for all the messages and |
30 | to automatically generate the perl parser for all the messages and |
… | |
… | |
1793 | </td> |
1793 | </td> |
1794 | </tr> |
1794 | </tr> |
1795 | </table> |
1795 | </table> |
1796 | |
1796 | |
1797 | <h4> |
1797 | <h4> |
|
|
1798 | <a name="C031b"></a>ORIGIN: CLIENT; |
|
|
1799 | MESSAGE: unknown_031b</h4> |
|
|
1800 | NUMERIC TYPE (hex): 031b<p> |
|
|
1801 | <p> |
|
|
1802 | Most probably has something to do witht he open games list or |
|
|
1803 | maybe sth. else. |
|
|
1804 | 00000: 20202020 20202020 20202020 20202036 6 |
|
|
1805 | 00010: 42001b03 51010000 00000000 00000000 B...Q........... |
|
|
1806 | </p> |
|
|
1807 | </p> |
|
|
1808 | <table border="1" width="100%"> |
|
|
1809 | <tr> |
|
|
1810 | <th width="10%">NAME</th> |
|
|
1811 | <th width="8%">TYPE</th> |
|
|
1812 | <th width="4%">VALUE</th> |
|
|
1813 | <th>DESCRIPTION</th> |
|
|
1814 | <th width="10%">GUARD</th> |
|
|
1815 | </tr> |
|
|
1816 | <tr> |
|
|
1817 | <td>channel</td> |
|
|
1818 | <td>U16</td> |
|
|
1819 | <td> </td> |
|
|
1820 | <td> |
|
|
1821 | |
|
|
1822 | |
|
|
1823 | </td> |
|
|
1824 | <td> |
|
|
1825 | <b></b> |
|
|
1826 | |
|
|
1827 | </td> |
|
|
1828 | </tr> |
|
|
1829 | </table> |
|
|
1830 | |
|
|
1831 | <h4> |
1798 | <a name="C0413"></a>ORIGIN: CLIENT; |
1832 | <a name="C0413"></a>ORIGIN: CLIENT; |
1799 | MESSAGE: req_game_record</h4> |
1833 | MESSAGE: req_game_record</h4> |
1800 | NUMERIC TYPE (hex): 0413<p> |
1834 | NUMERIC TYPE (hex): 0413<p> |
1801 | <p>Requests part of the users game record to be sent. Results in a <a href="#S0414">game_record(0414)</a> or maybe a timeout.</p> |
1835 | <p>Requests part of the users game record to be sent. Results in a <a href="#S0414">game_record(0414)</a> or maybe a timeout.</p> |
1802 | </p> |
1836 | </p> |
… | |
… | |
2809 | </td> |
2843 | </td> |
2810 | </tr> |
2844 | </tr> |
2811 | <tr> |
2845 | <tr> |
2812 | <td>name</td> |
2846 | <td>name</td> |
2813 | <td>username</td> |
2847 | <td>username</td> |
|
|
2848 | <td> </td> |
|
|
2849 | <td> |
|
|
2850 | |
|
|
2851 | |
|
|
2852 | </td> |
|
|
2853 | <td> |
|
|
2854 | <b></b> |
|
|
2855 | |
|
|
2856 | </td> |
|
|
2857 | </tr> |
|
|
2858 | </table> |
|
|
2859 | |
|
|
2860 | <h4> |
|
|
2861 | <a name="C442e"></a>ORIGIN: CLIENT; |
|
|
2862 | MESSAGE: save_game</h4> |
|
|
2863 | NUMERIC TYPE (hex): 442e<p> |
|
|
2864 | <p>Is send when a game is closed and should be saved on the gamerecord.</p> |
|
|
2865 | </p> |
|
|
2866 | <table border="1" width="100%"> |
|
|
2867 | <tr> |
|
|
2868 | <th width="10%">NAME</th> |
|
|
2869 | <th width="8%">TYPE</th> |
|
|
2870 | <th width="4%">VALUE</th> |
|
|
2871 | <th>DESCRIPTION</th> |
|
|
2872 | <th width="10%">GUARD</th> |
|
|
2873 | </tr> |
|
|
2874 | <tr> |
|
|
2875 | <td>channel</td> |
|
|
2876 | <td>U16</td> |
2814 | <td> </td> |
2877 | <td> </td> |
2815 | <td> |
2878 | <td> |
2816 | |
2879 | |
2817 | |
2880 | |
2818 | </td> |
2881 | </td> |
… | |
… | |
5549 | </table> |
5612 | </table> |
5550 | |
5613 | |
5551 | <!-- added recently --> |
5614 | <!-- added recently --> |
5552 | <h4> |
5615 | <h4> |
5553 | <a name="S043a"></a>ORIGIN: SERVER; |
5616 | <a name="S043a"></a>ORIGIN: SERVER; |
5554 | MESSAGE: unknown_43b</h4> |
5617 | MESSAGE: add_global_challenge</h4> |
5555 | NUMERIC TYPE (hex): 043a<p> |
5618 | NUMERIC TYPE (hex): 043a<p> |
5556 | Probably updates the open games list? The format is just a VERY VERY WILD GUESS. |
|
|
5557 | |
|
|
5558 | The first channel is probably a game id. |
|
|
5559 | |
|
|
5560 | </p> |
5619 | <p> |
|
|
5620 | Adds or updates a global challenge (open game list). |
|
|
5621 | </p> |
|
|
5622 | </p> |
5561 | <table border="1" width="100%"> |
5623 | <table border="1" width="100%"> |
5562 | <tr> |
5624 | <tr> |
5563 | <th width="10%">NAME</th> |
5625 | <th width="10%">NAME</th> |
5564 | <th width="8%">TYPE</th> |
5626 | <th width="8%">TYPE</th> |
5565 | <th width="4%">VALUE</th> |
5627 | <th width="4%">VALUE</th> |
… | |
… | |
6652 | </td> |
6714 | </td> |
6653 | </tr> |
6715 | </tr> |
6654 | </table> |
6716 | </table> |
6655 | |
6717 | |
6656 | <h4> |
6718 | <h4> |
6657 | <a name="C442f"></a>ORIGIN: CLIENT; |
6719 | <a name="S442f"></a>ORIGIN: SERVER; |
6658 | MESSAGE: new_game</h4> |
6720 | MESSAGE: new_game</h4> |
6659 | NUMERIC TYPE (hex): 442f<p> |
6721 | NUMERIC TYPE (hex): 442f<p> |
6660 | <p>Notifies the client that a new game has been created. This |
6722 | <p>Notifies the client that a new game has been created. This |
6661 | message is sent long *after* upd_observers etc. has been received. |
6723 | message is sent long *after* upd_games and upd_observers etc. |
6662 | *sigh*</p> |
6724 | have been received. *sigh*</p> |
6663 | </p> |
6725 | </p> |
6664 | <table border="1" width="100%"> |
6726 | <table border="1" width="100%"> |
6665 | <tr> |
6727 | <tr> |
6666 | <th width="10%">NAME</th> |
6728 | <th width="10%">NAME</th> |
6667 | <th width="8%">TYPE</th> |
6729 | <th width="8%">TYPE</th> |
… | |
… | |
6770 | </table> |
6832 | </table> |
6771 | |
6833 | |
6772 | <!-- added recently --> |
6834 | <!-- added recently --> |
6773 | <h4> |
6835 | <h4> |
6774 | <a name="S443b"></a>ORIGIN: SERVER; |
6836 | <a name="S443b"></a>ORIGIN: SERVER; |
6775 | MESSAGE: unknown_443b</h4> |
6837 | MESSAGE: del_global_challenge</h4> |
6776 | NUMERIC TYPE (hex): 443b<p> |
6838 | NUMERIC TYPE (hex): 443b<p> |
6777 | No idea yet, both id's are probably channel ids and have sth. to |
|
|
6778 | do with the open games list(?). They have never been observed to be different, btw. |
|
|
6779 | </p> |
6839 | <p> |
|
|
6840 | Remove a game from the global challenge list (open game list). |
|
|
6841 | </p> |
|
|
6842 | </p> |
6780 | <table border="1" width="100%"> |
6843 | <table border="1" width="100%"> |
6781 | <tr> |
6844 | <tr> |
6782 | <th width="10%">NAME</th> |
6845 | <th width="10%">NAME</th> |
6783 | <th width="8%">TYPE</th> |
6846 | <th width="8%">TYPE</th> |
6784 | <th width="4%">VALUE</th> |
6847 | <th width="4%">VALUE</th> |
… | |
… | |
6801 | <tr> |
6864 | <tr> |
6802 | <td>game</td> |
6865 | <td>game</td> |
6803 | <td>U16</td> |
6866 | <td>U16</td> |
6804 | <td> </td> |
6867 | <td> </td> |
6805 | <td> |
6868 | <td> |
6806 | |
6869 | |
6807 | |
6870 | |
6808 | </td> |
6871 | </td> |
6809 | <td> |
6872 | <td> |
6810 | <b></b> |
6873 | <b></b> |
6811 | |
6874 | |