Package us.donut.mmc

Class Client

java.lang.Object

us.donut.mmc.Client

public class Client
extends Object

A minimal Minecraft client implementation which provides methods for server list pings, logins, and sending/receiving packets. Packet encryption and compression is handled automatically.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Client.ClientInputStream	Data from a server.
static class	Client.ClientOutputStream	Data going to a server.

Constructor Summary

Constructors

Constructor	Description
Client()	Constructs a new client.

Method Summary

Modifier and Type	Method	Description
void	disconnect()	Disconnects this client if currently connected to a server.
boolean	isConnected()	Checks if this client is connected to a server.
InboundPacket	login(Account account, String address, int port)	Executes the login process.
InboundPacket	ping(String address, int port)	Executes a server list ping.
InboundPacket	receive()	Reads a packet from the connected server (blocks until a packet is received).
void	send(OutboundPacket packet)	Sends a packet to the connected server.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Client

public Client()

Constructs a new client.

Method Detail

disconnect

public void disconnect()
                throws IOException

Disconnects this client if currently connected to a server.

Throws:

IOException

isConnected

public boolean isConnected()

Checks if this client is connected to a server.

Returns:

true if the client is connected to a server.

send

public void send(OutboundPacket packet)
          throws IOException

Sends a packet to the connected server. Packet encryption and compression is handled automatically. This method is thread safe.

Parameters:

packet - the packet to send

Throws:

IOException

receive

public InboundPacket receive()
                      throws IOException,
                             DataFormatException

Reads a packet from the connected server (blocks until a packet is received). Packet encryption and compression is handled automatically.

Returns:

the packet from the server

Throws:

IOException

DataFormatException

ping

public InboundPacket ping(String address,
                          int port)
                   throws IOException,
                          DataFormatException

Executes a server list ping.

Parameters:

address - the server address (IP or hostname)

port - the server port

Returns:

a status response packet if successful

Throws:

IOException

DataFormatException

login

public InboundPacket login(Account account,
                           String address,
                           int port)
                    throws IOException,
                           GeneralSecurityException,
                           InterruptedException,
                           DataFormatException

Executes the login process.

Parameters:

account - the account with which to login

address - the server address (IP or hostname)

port - the server port

Returns:

a login success packet if successful

Throws:

IOException

GeneralSecurityException

InterruptedException

DataFormatException