rswiki-book/135-Protocol.mediawiki

342 lines
8.9 KiB
Plaintext
Raw Normal View History

2012-11-07 08:54:36 -05:00
[[Category RSC]]
This page refers to the RSC #135 client revision.
== '''Packet structure''' ==
?
== '''Login''' ==
2012-11-08 13:03:07 -05:00
(The login protocol documentation is currently a work in progress. Below you will find a partially refactored version of the login method found in the 135 client.)
<pre>
try {
username = user;
user = jagex.Util.formatString(user, 20);
password = pass;
pass = jagex.Util.formatString(pass, 20);
if (user.trim().length() == 0) {
drawMessage(messageTable[0], messageTable[1]);
return;
}
if (reconnecting)
d(messageTable[2], messageTable[3]);
else
drawMessage(messageTable[6], messageTable[7]);
if (appletStarted())
stream = new SocketStream(host, this, port);
else
stream = new SocketStream(host, null, port);
stream.oe = xc;
int ssk = stream.readInt32();
serverSessionID = ssk;
System.out.println("Session id: " + ssk);
if (reconnecting)
stream.beginFrame(19);
else
stream.beginFrame(0);
stream.putInt16(wc);
stream.putInt64(jagex.Util.longForName(user));
stream.putLineRSA(pass, ssk, pd, qd);
stream.putInt32(getSessionID());
stream.flush();
stream.read();
int response = stream.read();
System.out.println("Login response: " + response);
if (response == 0) {
ed = 0;
e_();
return;
}
if (response == 1) {
ed = 0;
a();
return;
}
if (reconnecting) {
user = "";
pass = "";
f();
return;
}
if (response == 3) {
drawMessage(messageTable[10], messageTable[11]);
return;
}
if (response == 4) {
drawMessage(messageTable[4], messageTable[5]);
return;
}
if (response == 5) {
drawMessage(messageTable[16], messageTable[17]);
return;
}
if (response == 6) {
drawMessage(messageTable[18], messageTable[19]);
return;
}
if (response == 7) {
drawMessage(messageTable[20], messageTable[21]);
return;
}
if (response == 11) {
drawMessage(messageTable[22], messageTable[23]);
return;
}
if (response == 12) {
drawMessage(messageTable[24], messageTable[25]);
return;
}
if (response == 13) {
drawMessage(messageTable[14], messageTable[15]);
return;
}
if (response == 14) {
drawMessage(messageTable[8], messageTable[9]);
sd = 1500;
return;
}
if (response == 15) {
drawMessage(messageTable[26], messageTable[27]);
return;
}
if (response == 16) {
drawMessage(messageTable[28], messageTable[29]);
return;
} else {
drawMessage(messageTable[12], messageTable[13]);
return;
}
} catch (Exception exception) {
System.out.println(String.valueOf(exception));
}
if (ed > 0) {
try {
Thread.sleep(5000L);
} catch (Exception _ex) {
}
ed--;
login(username, password, reconnecting);
}
if (reconnecting) {
username = "";
password = "";
f();
} else {
drawMessage(messageTable[12], messageTable[13]);
}</pre>
2012-11-07 08:54:36 -05:00
2012-11-08 13:00:57 -05:00
== '''Reference''' ==
2012-11-08 12:55:34 -05:00
A lot of times, Util.longForName is referenced in the packets following:
<pre>
public static long longForName(String arg0) {
String s = "";
for (int i = 0; i < arg0.length(); i++) {
char c = arg0.charAt(i);
if (c >= 'a' && c <= 'z')
s = s + c;
else if (c >= 'A' && c <= 'Z')
s = s + (char) ((c + 97) - 65);
else if (c >= '0' && c <= '9')
s = s + c;
else
s = s + ' ';
}
s = s.trim();
if (s.length() > 12)
s = s.substring(0, 12);
long l = 0L;
for (int j = 0; j < s.length(); j++) {
char c1 = s.charAt(j);
l *= 37L;
if (c1 >= 'a' && c1 <= 'z')
l += (1 + c1) - 97;
else if (c1 >= '0' && c1 <= '9')
l += (27 + c1) - 48;
}
return l;
}
</pre>
2012-11-08 13:05:25 -05:00
In the 135 client, messages that are to be drawn on the login screen are stored in an array. This makes it a bit tedious to understand what messages are being drawn. Here is the message table:
<pre>
static {
messageTable = new String[50];
messageTable[0] = "You must enter both a username";
messageTable[1] = "and a password - Please try again";
messageTable[2] = "Connection lost! Please wait...";
messageTable[3] = "Attempting to re-establish";
messageTable[4] = "That username is already in use.";
messageTable[5] = "Wait 60 seconds then retry";
messageTable[6] = "Please wait...";
messageTable[7] = "Connecting to server";
messageTable[8] = "Sorry! The server is currently full.";
messageTable[9] = "Please try again later";
messageTable[10] = "Invalid username or password.";
messageTable[11] = "Try again, or create a new account";
messageTable[12] = "Sorry! Unable to connect to server.";
messageTable[13] = "Check your internet settings";
messageTable[14] = "Username already taken.";
messageTable[15] = "Please choose another username";
messageTable[16] = "The client has been updated.";
messageTable[17] = "Please reload this page";
messageTable[18] = "You may only use 1 character at once.";
messageTable[19] = "Your ip-address is already in use";
messageTable[20] = "Login attempts exceeded!";
messageTable[21] = "Please try again in 5 minutes";
messageTable[22] = "Account has been temporarily disabled";
messageTable[23] = "for cheating or abuse";
messageTable[24] = "Account has been permanently disabled";
messageTable[25] = "for cheating or abuse";
messageTable[26] = "You need a members account";
messageTable[27] = "to login to this server";
messageTable[28] = "Please login to a members server";
messageTable[29] = "to access member-only features";
}
</pre>
2012-11-08 13:00:57 -05:00
== '''Packets''' ==
Some 135 packets are documented ahead. First you will find the packets' body, then you will find a table (for easier reading)
=== '''Incoming Data''' ===
2012-11-07 08:54:36 -05:00
'''TODO:'''
<pre>
</pre>
2012-11-08 13:00:57 -05:00
=== '''Outgoing Data''' ===
2012-11-07 08:54:36 -05:00
<pre>
2012-11-08 12:58:29 -05:00
(ns rsc.rsc135.packets
(:require [jagex.Util])
2012-11-07 08:54:36 -05:00
(:use [jagex.client.SocketStream]))
2012-11-10 08:43:16 -05:00
;; Opcode: 1
(defn disconnect [stream]
(doto stream
(.begin-packet1)
(.flush)))
2012-11-07 08:54:36 -05:00
;; Opcode: 2
(defn newplayer [stream]
(doto stream
(.begin-packet 2)
(.put-int16 ???)
(.put-int64 (Util/long-for-name username))
(.put-int16 referrerid)
(.putline-rsa password server-session-id key-a key-b) ; keys for RSA?
(.flush)
(.read) ; newplayer response
(.end-packet)))
;; Opcode: 6
2012-11-07 09:52:56 -05:00
(defn logout [stream]
2012-11-07 08:54:36 -05:00
(doto stream
(.begin-packet 6)
(.end-packet)))
2012-11-08 11:05:41 -05:00
;; Opcode: 7
(defn send-command [stream command] ; sends command to server e.g ::home, command arg is (.substring command 2)
(doto stream
2012-11-08 12:46:13 -05:00
(.begin-packet 7)
2012-11-08 11:05:41 -05:00
(.putline command)
(.end-packet)))
2012-11-07 08:54:36 -05:00
;; Opcode: 10
(defn report-abuse [stream username]
(let [name (.substring username 12)
2012-11-08 10:53:03 -05:00
l5 (Util/long-for-name name)]
2012-11-07 08:54:36 -05:00
(doto stream
(.begin-packet 10)
(.put-int64 l5)
(.end-packet))))
2012-11-07 17:16:38 -05:00
;; Opcode: 26
(defn add-friend [stream name] ; name is string represenation of username
(doto stream
(.begin-packet 26)
(.put-int64 (Util/long-for-name name)
(.end-packet)))
2012-11-07 08:54:36 -05:00
;; Opcode: 27
2012-11-07 17:16:38 -05:00
(defn remove-friend [stream name] ; name is long represenation of username (i.e Util/long-for-name username)
2012-11-07 08:54:36 -05:00
(doto stream
(.begin-packet 27)
(.put-int64 name)
(.end-packet)))
2012-11-07 17:16:38 -05:00
2012-11-08 10:51:40 -05:00
;; Opcode: 28
;; name is long representation of username, message is byte representation of message (.getBytes message), length is length of message (maximum length is 200)
(defn send-message [stream name message length]
2012-11-08 10:53:03 -05:00
(doto stream
(.begin-packet 28)
(.put-int64 username)
(.read-bytes message 0 length)
(.end-packet)))
2012-11-08 10:51:40 -05:00
2012-11-07 17:16:38 -05:00
;; Opcode: 29
(defn add-ignore [stream username] ; username is string representation of username
2012-11-08 12:55:34 -05:00
(let [name (Util/long-for-name username)]
2012-11-07 17:16:38 -05:00
(doto stream
(.begin-packet 29)
(.put-int64 name)
(.end-packet))))
2012-11-07 08:54:36 -05:00
</pre>
2012-11-08 12:10:49 -05:00
{| class="wikitable"
2012-11-08 12:01:18 -05:00
|+ Outgoing Packets
2012-11-08 11:56:46 -05:00
|-
2012-11-08 12:01:18 -05:00
! Name
! Opcode
! Payload
2012-11-08 12:08:49 -05:00
! Description
2012-11-08 11:56:46 -05:00
|-
2012-11-10 08:43:16 -05:00
! Disconnect
| 1 ||
* None
| Sends the disconnect packet.
|-
2012-11-08 12:05:17 -05:00
! Newplayer (Registration)
| 2 ||
2012-11-08 12:51:37 -05:00
* Short - Unknown
* Long - Long represenation of username
* Short - Referrer ID
2012-11-08 12:05:17 -05:00
** Integer.parseInt(getParameter("referrerid"));
2012-11-08 12:51:37 -05:00
* Line-RSA - Password, server session ID, bigintegers
2012-11-08 12:08:49 -05:00
| Registers a new user (probably not used in private servers)
|-
! Logout
| 6 ||
2012-11-08 12:10:49 -05:00
* None
2012-11-08 12:08:49 -05:00
| Sends the logout packet to the server
2012-11-08 12:05:53 -05:00
|-
2012-11-08 12:51:37 -05:00
! Execute Command
2012-11-08 12:46:13 -05:00
| 7 ||
* String - The command
| Sends a command to the server to be executed
|-
2012-11-08 12:51:37 -05:00
! Report Abuse
| 10 ||
* Long - The long representation of the username of the user to report
| Sends an abuse report to the server
|-
! Add Friend
2012-11-08 12:01:18 -05:00
| 26 ||
2012-11-08 12:05:17 -05:00
* Long - long represenation of username
2012-11-08 12:08:49 -05:00
| Adds a user to your friends list
2012-11-08 12:51:37 -05:00
|-
! Remove Friend
| 27 ||
* Long - The long representation of the username of the user to report
| Removes a user from your friends list
|-
! Send Message
| 28 ||
* Long - The long representation of the username of the user to send the message to
* Byte[] - A byte array containing the bytes of the message to send to the user
| Sends a message to the specified user
|-
! Ignore User
| 29 ||
* Long - The long representation of the username of the user to ignore
| Adds a user to your ignore list
2012-11-08 12:01:18 -05:00
|}