summaryrefslogtreecommitdiff
path: root/doc/admin_packet.txt
blob: d40c8a370103a5cad904fec5178e467aee040ab3 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
===========================================================================
===========================================================================
                     DETAIL OF ADMINISTRATION PACKETS
---------------------------------------------------------------------------
---------------------------------------------------------------------------

===========================================================================
	COMMON PACKETS FOR ALL SERVERS
---------------------------------------------------------------------------
S 7530 (void)
	It's a request to obtain the version of the server.
	Answer packet: 0x7531.

R 7531 <major_version>.B <minor_version>.B <revision>.B <release_flag>.B <official_flag>.B <server_type>.B <mod_version>.w
	It's the reply to a request about the server version (0x7530).
	It gives the information about the version of the server.
	release_flag : 0 = release, 1 = debug
	official_flag: 0 = official, 1 = mod
	server_type: 1 = login, 2 = char, 4 = inter, 8 = map (add all values if the server have more than 1 type)

S 7532 (void)
	End of connection (no reply is sended back)

===========================================================================
	ADMINISTRATION PACKETS OF THE LOGIN-SERVER
---------------------------------------------------------------------------

NB: All information about an account can be obtain by an administration packet, except the password.
	The login-server will never send back the password af an account.
	If someone sniffs the password from the login-server, he can not obtain it.
	But, it exists a packet to check the password.
	It's to secure the password.

CONNECTION SYSTEM IN ADMINSTRATION MODE

S 7918 <encrypt_flag>.w <administration_password>.24(16)B
	It's a request to obtain an (administration) connection on the login-server.
	The packet size changes according to the encrypted password or not.
	A non-encrypted password is sended with 24 bytes (plain text with NULL terminate),
		and an encrypted password is sended with 16 bytes.
	Answer packet: 0x7919.
	encrypt_flag: 0 = plain text, 1 = md5 (key + password), 2 = md5 (password + key)

R 7919 <flag>.B
	It's the reply to a request for an (administration) connection (0x7918).
	Flag: 0 = accepted, 1 = refused

S 791a (void)
	It's a request to obtain the encrypted key. This key is used to create the encrypted password.
	This packet must be called before the packet 0x7918 if you want connect you with an encrypted password.
	The reply is the packet 0x01dc, as like a player sends a connection request with the packet 0x01db.

PACKETS OF ADMINISTRATION MODE

R 791f (void)
	Ready signal (no reply is sended back). NOT USED.

S 7920 <start_id>.l <end_id>.l
	It's a request to obtain an accounts list.
	start_id: 0 for begining of the list, or presumed start id value of the first account.
	end_id: 0 to go until the last id, or the upper id limit value that you want.
	        If 'end_id' is lower to 'start_id', you give no limit for the last id.
	Answer packet: 0x7921.

R 7921 <length>.w { <account_id>.l <GM_level>.B <account_name>.24B <sex>.B <count>.l <state>.l }.38B*
	It's tje reply packet of the packet 0x7920.
	It gives an accounts list.
	If you receive at least an account, you must do an additional request (packet 0x7920 begining with the last received account id +1)
		to be sure that you receive all asked accounts, because this packet is limited in size when it sends information.
	if <state> is 7, there are 2 possibilities: banishement or state{Your are Prohibited to log in until %s}.

S 7930 <account_name>.24B <password>.24B <sex>.B <E-mail>.40B
	It's a request to create a new account.
	If e-mail is not valid, the e-mail is replaced by the default e-mail (a@a.com).
		The default e-mail is like no e-mail to protect your characters against a deletion.
	Answer packet: 0x7931.

R 7931 <account_id>.l <account_name>.24B
	It's the reply to an account creation (0x7930).
	If the account_id value is -1, the login-server fails to create the new account
		(an account already exists with the same name, the request is invalid, etc.).
	Otherwise, the account_id is the id of the new account.

S 7932 <account_name>.24B
	It's a request to delete an account.
	Answer packet: 0x7933.

R 7933 <account_id>.l <account_name>.24B
	It's the reply to an account deletion (0x7932).
	If the account_id value is -1, the login-server fails to delete the account (the account doesn't exist).
	Otherwise, the account_id is the id of the deleted account.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7934 <account_name>.24B <password>.24B
	It's a request to modify the password of an account.
	Answer packet: 0x7935.

R 7935 <account_id>.l <account_name>.24B
	It's the reply to an password modification (0x7934).
	If the account_id value is -1, the login-server fails to modify the password (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have modified the password.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7936 <account_name>.24B <state>.l <error_message>.20B
	It's a request to modify the state of an account.
	State: It's the state like the packet 0x006a +1.
	Error_message: it's the message of the error code #6 = Your are Prohibited to login until <error_message> (packet 0x006a).
		If state is 7 (6+1), the error_message is saved in the account.
		For another state, the error_message is deleted (voided) in the account.
	Answer packet: 0x7937.

R 7937 <account_id>.l <account_name>.24B <state>.l
	It's the reply to a state modification (0x7936).
	If the account_id value is -1, the login-server fails to modify the state (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have modified the state.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7938 (void)
	It's a request to obtain information about the servers connected to the login-server (servers list with details)
	Answer packet: 0x7939.

R 7939 <length>.w {<IP>.l <port>.w <server_name>.20B <#_of_users>.w <maintenance>.w <new>.w}.32B*
	It's the reply to an request to obtain servers information (0x7938).
	It returns all information about the servers connected on the login-server.

S 793a <account_name>.24B <password>.24B
	It's a request to test a password. REMEMBER: Never create a packet to send the password from the login-server.
	Answer packet: 0x793b.

S 793b <account_id>.l <account_name>.24B
	It's the reply to a password check (0x793a).
	If the account_id value is -1, the login-server doesn't valid the password (the account doesn't exist or the password is not the correct one).
	Otherwise, the account_id is the id of the account that the login-server have checked the password.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 793c <account_name>.24B <sex>.B
	It's a request to modify the sex of an account.
	Answer packet: 0x793d.

R 793d <account_id>.l <account_name>.24B
	It's the reply to a request to modify a sex (0x793c).
	If the account_id value is -1, the login-server fails to modify the sex (the account doesn't exist or the sex is already the good sex).
	Otherwise, the account_id is the id of the account that the login-server have modified the sex.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 793e <account_name>.24B <GM_level>.B
	It's a request to modify the GM level of an account.
	Answer packet: 0x793f.

R 793f <account_id>.l <account_name>.24B
	It's the reply to a request to modify a GM level (0x793e).
	If the account_id value is -1, the login-server fails to modify the GM level (the account doesn't exist, or GM_account file can not be modified or the GM level is already the good sex).
	Otherwise, the account_id is the id of the account that the login-server have modified the GM level.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7940 <account_name>.24B <e-mail>.40B
	It's a request to modify the email of an account.
	Answer packet: 0x7941.

R 7941 <account_id>.l <account_name>.24B
	It's the reply to a request to modify an email (0x7940).
	If the account_id value is -1, the login-server fails to modify the e-mail (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have modified the email.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7942 <account_name>.24B <length_of_memo>.w <memo>.(length_of_memo)B
	It's a request to modify the memo of an account.
	The length can be 0 to have a void memo.
	Answer packet: 0x7943.

R 7943 <account_id>.l <account_name>.24B
	It's the reply to an request to modify a memo (0x7942).
	If the account_id value is -1, the login-server fails to modify the memo (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have modified the memo.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7944 <account_name>.24B
	It's a request to obtain (by the name) the id of an account.
	Answer packet: 0x7945.

R 7945 <account_id>.l <account_name>.24B
	It's the reply to an request (by the name) to obtain an account id (0x7944).
	If the account_id value is -1, the login-server fails to obtain the account id (the account doesn't exist).
	Otherwise, the account_id is the id of the found account.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 7946 <account_id>.l
	It's a request to obtain (by the id) the name of an account.
	Answer packet: 0x7947.

R 7947 <account_id>.l <account_name>.24B
	It's the reply to an request (by the id) to obtain an account name (0x7946).
	If the account_name value is "" (void), the login-server fails to obtain the account name (the account id doesn't exist).
	Otherwise, the account_name is the name of the found account.

S 7948 <account_name>.24B <validity>.l
	It's a request to set the validity date of an account.
	This packet fixes an absolute validity time.
	Answer packet: 0x7949.

R 7949 <account_id>.l <account_name>.24B <validity>.l
	It's the reply to an request to set the validity date of an account (0x7948).
	If the account_id value is -1, the login-server fails to set the validity date (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have fixed the validity date.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 794a <account_name>.24B <end_date_of_banishment>.l
	It's a request to set the final date of a banishment of an account.
	This packet fixes an absolute time for the end of the banishment.
	Answer packet: 0x794b.

R 794b <account_id>.l <account_name>.24B <end_date_of_banishment>.l
	It's the reply to an request to set the final date of a banishment of an account (0x794a).
	If the account_id value is -1, the login-server fails to set the final date of a banishment (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have fixed the final date of a banishment.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).

S 794c <account_name>.24B <+/-years_modification>.w <+/-months_modification>.w <+/-days_modification>.w <+/-hours_modification>.w <+/-minutes_modification>.w <+/-seconds_modification>.w
	It's a request to adjust the final date of a banishment of an account.
	This packet modifies the final date of a banishment by add/sustract of some parameters.
	If you adjust a non-banished account, you fix a banishment with actual time + adjustments.
	Answer packet: 0x794d.

R 794d <account_id>.l <account_name>.24B <end_date_of_banishment>.l
	It's the reply to an request to adjust the final date of a banishment of an account (0x794c).
	If the account_id value is -1, the login-server fails to adjust the final date of a banishment (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have adjusted the final date of a banishment.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).
	Note: if value is impossible, the returned value is the (unchanged) value of the final date of the banishment.

S 794e <broadcast_type>.W <length_of_message>.L <message>.(length_of_message)B
	It's a request to send a broadcast to all map-servers.
	The length can not be 0.
	broadcast_type:
	  0: normal (yellow)
	  0x10: blue
	Answer packet: 794f.

R 794f <answaer>.W
	It's the reply to an request to send a broadcast to all map-servers (794e).
	If the answer value is -1, the login-server fails to send the message (no char-server are conected).
	Otherwise, the answer is 0.

S 7950 <account_name>.24B <+/-years_modification>.w <+/-months_modification>.w <+/-days_modification>.w <+/-hours_modification>.w <+/-minutes_modification>.w <+/-seconds_modification>.w
	It's a request to adjust the validity date of an account.
	This packet modifies the validity date by add/sustract of some parameters.
	You can not adjust an unlimited validity date.
	Answer packet: 0x7951.

R 7951 <account_id>.l <account_name>.24B <validity>.l
	It's the reply to an request to adjust the validity date of an account (0x7950).
	If the account_id value is -1, the login-server fails to adjust the validity date (the account doesn't exist).
	Otherwise, the account_id is the id of the account that the login-server have found to try the adjustement of the validity date.
		The login-server returns the correct sensitive case account_name (use strcmpi to compare).
		If the returned validity date is 0, the login-server haven't modify the validity date (the account have an unlimited validity,
			the modification is impossible because the new date is too far in the future, etc...).
		If the returned validity date is not 0, it's the new validity date of the account.

S 7952 <account_name>.24B
	It's a request (by name) to obtain complete information about an account.
	Answer packet: 0x7953.

R 7953 <account_id>.l <GM_level>.B <account_name>.24B <sex>.B <count>.l <state>.l <error_message>.20B <last_login_time>.24B <last_authorised_login_ip>.16B <email>.40B <validity_date>.l <until_ban_date>.l <length_of_memo>.w <memo>.(length_of_memo)B
	It's the reply to an request to obtain complete information about an account (0x7952 and 0x7954).
	It sends all informations about an account.
	Reply of 0x7952:
		If the account_id value is -1, the login-server fails to found the account (the account doesn't exist).
		Otherwise, the account_id is the id of the found account.
			The login-server returns the correct sensitive case account_name (use strcmpi to compare).
	Reply of 0x7954:
		If the account_name value is "" (void), the login-server fails to found the account (the account id doesn't exist).
		Otherwise, the account_name is the name of the found account.

S 7954 <account_id>.l
	It's a request (by id) to obtain complete information about an account.
	Answer packet: 0x7953.

S 7955
	It's a request to re-load GM file definition.
	Answer packet: NONE.