com.comphenix.protocol

Class PacketType

java.lang.Object

com.comphenix.protocol.PacketType

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<PacketType>

public class PacketType
extends java.lang.Object
implements java.io.Serializable, java.lang.Comparable<PacketType>

Represents the type of a packet in a specific protocol.

Note that vanilla Minecraft reuses packet IDs per protocol (ping, game, login), so you cannot rely on IDs alone.

Author:

Kristian

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	PacketType.Handshake Packets sent during handshake.
static class	PacketType.Legacy Contains every packet Minecraft 1.6.4 packet removed in Minecraft 1.7.2.
static class	PacketType.Login Packets sent and received when logging in to the server.
static class	PacketType.Play Packets sent and received when logged into the game.
static class	PacketType.Protocol Represents the different protocol or connection states.
static class	PacketType.Sender Represents the sender of this packet type.
static class	PacketType.Status Packets sent and received when querying the server in the multiplayer menu.

Field Summary

Fields

Modifier and Type	Field and Description
static int	UNKNOWN_PACKET Represents an unknown legacy packet ID.

Constructor Summary

Constructors

Constructor and Description
PacketType(PacketType.Protocol protocol, PacketType.Sender sender, int currentId, int legacyId) Construct a new packet type.
PacketType(PacketType.Protocol protocol, PacketType.Sender sender, int currentId, int legacyId, MinecraftVersion version) Construct a new packet type.

Method Summary

Methods

Modifier and Type	Method and Description
int	compareTo(PacketType other)
boolean	equals(java.lang.Object obj)
static PacketType	findCurrent(PacketType.Protocol protocol, PacketType.Sender sender, int packetId) Retrieve a packet type from a protocol, sender and packet ID.
static PacketType	findLegacy(int packetId) Retrieve a packet type from a legacy (1.6.4 and below) packet ID.
static PacketType	findLegacy(int packetId, PacketType.Sender preference) Retrieve a packet type from a legacy (1.6.4 and below) packet ID.
static PacketType	fromClass(java.lang.Class<?> packetClass) Lookup a packet type from a packet class.
static PacketType	fromCurrent(PacketType.Protocol protocol, PacketType.Sender sender, int packetId, int legacyId) Retrieve a packet type from a protocol, sender and packet ID.
static PacketType	fromLegacy(int id, PacketType.Sender sender) Retrieve a packet type from a legacy ID.
static java.util.Collection<PacketType>	fromName(java.lang.String name) Retrieve every packet type with the given UPPER_CAMEL_CASE name.
int	getCurrentId() Retrieve the current protocol ID for this packet type.
MinecraftVersion	getCurrentVersion() Retrieve the Minecraft version for the current ID.
int	getLegacyId() Retrieve the legacy (1.6.4 or below) protocol ID of the packet type.
static ObjectEnum<PacketType>	getObjectEnum(PacketType type) Retrieve the correct object enum from a specific packet type.
java.lang.Class<?>	getPacketClass() Retrieve the equivalent packet class.
PacketType.Protocol	getProtocol() Retrieve the protocol (the connection state) the packet type belongs.
PacketType.Sender	getSender() Retrieve which sender will transmit packets of this type.
static boolean	hasClass(java.lang.Class<?> packetClass) Determine if a given class represents a packet class.
static boolean	hasCurrent(PacketType.Protocol protocol, PacketType.Sender sender, int packetId) Determine if the given packet exists.
int	hashCode()
static boolean	hasLegacy(int packetId) Determine if the given legacy packet exists.
boolean	isClient() Determine if this packet was sent by the client.
boolean	isServer() Determine if this packet was sent by the server.
boolean	isSupported() Determine if this packet is supported on the current server.
java.lang.String	name() Retrieve the declared enum name of this packet type.
static PacketType	newLegacy(PacketType.Sender sender, int legacyId) Construct a legacy packet type.
static java.util.concurrent.Future<java.lang.Boolean>	scheduleRegister(PacketType type, java.lang.String name) Register a particular packet type.
java.lang.String	toString()
static java.lang.Iterable<PacketType>	values() Find every packet type known to the current version of ProtocolLib.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

UNKNOWN_PACKET

public static final int UNKNOWN_PACKET

Represents an unknown legacy packet ID.

See Also:

Constant Field Values

Constructor Detail

PacketType

public PacketType(PacketType.Protocol protocol,
          PacketType.Sender sender,
          int currentId,
          int legacyId)

Construct a new packet type.

Parameters:

protocol - - the current protocol.

sender - - client or server.

currentId - - the current packet ID, or

legacyId - - the legacy packet ID.

PacketType

public PacketType(PacketType.Protocol protocol,
          PacketType.Sender sender,
          int currentId,
          int legacyId,
          MinecraftVersion version)

Construct a new packet type.

Parameters:

protocol - - the current protocol.

sender - - client or server.

currentId - - the current packet ID.

legacyId - - the legacy packet ID.

version - - the version of the current ID.

Method Detail

values

public static java.lang.Iterable<PacketType> values()

Find every packet type known to the current version of ProtocolLib.

Returns:

Every packet type.

findLegacy

public static PacketType findLegacy(int packetId)

Retrieve a packet type from a legacy (1.6.4 and below) packet ID.

Parameters:

packetId - - the legacy packet ID.

Returns:

The corresponding packet type.

Throws:

java.lang.IllegalArgumentException - If the legacy packet could not be found.

findLegacy

public static PacketType findLegacy(int packetId,
                    PacketType.Sender preference)

Retrieve a packet type from a legacy (1.6.4 and below) packet ID.

Parameters:

packetId - - the legacy packet ID.

preference - - the preferred sender, or NULL for any arbitrary sender.

Returns:

The corresponding packet type.

Throws:

java.lang.IllegalArgumentException - If the legacy packet could not be found.

hasLegacy

public static boolean hasLegacy(int packetId)

Determine if the given legacy packet exists.

Parameters:

packetId - - the legacy packet ID.

preference - - the sender preference.

Returns:

TRUE if it does, FALSE otherwise.

findCurrent

public static PacketType findCurrent(PacketType.Protocol protocol,
                     PacketType.Sender sender,
                     int packetId)

Retrieve a packet type from a protocol, sender and packet ID.

It is usually better to access the packet types statically, like so:

• PacketType.Play.Server.SPAWN_ENTITY

Parameters:

protocol - - the current protocol.

sender - - the sender.

packetId - - the packet ID.

Returns:

The corresponding packet type.

Throws:

java.lang.IllegalArgumentException - If the current packet could not be found.

hasCurrent

public static boolean hasCurrent(PacketType.Protocol protocol,
                 PacketType.Sender sender,
                 int packetId)

Determine if the given packet exists.

Parameters:

protocol - - the protocol.

sender - - the sender.

packetId - - the packet ID.

Returns:

TRUE if it exists, FALSE otherwise.

fromLegacy

public static PacketType fromLegacy(int id,
                    PacketType.Sender sender)

Retrieve a packet type from a legacy ID.

If no associated packet type could be found, a new will be registered under LEGACY.

Parameters:

id - - the legacy ID.

sender - - the sender of the packet, or NULL if unknown.

Returns:

The packet type.

Throws:

java.lang.IllegalArgumentException - If the sender is NULL and the packet doesn't exist.

fromCurrent

public static PacketType fromCurrent(PacketType.Protocol protocol,
                     PacketType.Sender sender,
                     int packetId,
                     int legacyId)

Retrieve a packet type from a protocol, sender and packet ID.

The packet will automatically be registered if its missing.

Parameters:

protocol - - the current protocol.

sender - - the sender.

packetId - - the packet ID. Can be UNKNOWN_PACKET.

legacyId - - the legacy packet ID. Can be UNKNOWN_PACKET.

Returns:

The corresponding packet type.

fromClass

public static PacketType fromClass(java.lang.Class<?> packetClass)

Lookup a packet type from a packet class.

Parameters:

packetClass - - the packet class.

Returns:

The corresponding packet type, or NULL if not found.

fromName

public static java.util.Collection<PacketType> fromName(java.lang.String name)

Retrieve every packet type with the given UPPER_CAMEL_CASE name.

Note that the collection is unmodiable.

Parameters:

name - - the name.

Returns:

Every packet type, or an empty collection.

hasClass

public static boolean hasClass(java.lang.Class<?> packetClass)

Determine if a given class represents a packet class.

Parameters:

packetClass - - the class to lookup.

Returns:

TRUE if this is a packet class, FALSE otherwise.

scheduleRegister

public static java.util.concurrent.Future<java.lang.Boolean> scheduleRegister(PacketType type,
                                                              java.lang.String name)

Register a particular packet type.

Note that the registration will be performed on the main thread.

Parameters:

type - - the type to register.

name - - the name of the packet.

Returns:

A future telling us if our instance was registered.

getObjectEnum

public static ObjectEnum<PacketType> getObjectEnum(PacketType type)

Retrieve the correct object enum from a specific packet type.

Parameters:

type - - the packet type.

Returns:

The corresponding object enum.

newLegacy

public static PacketType newLegacy(PacketType.Sender sender,
                   int legacyId)

Construct a legacy packet type.

Parameters:

sender - - client or server.

legacyId - - the legacy packet ID.

isSupported

public boolean isSupported()

Determine if this packet is supported on the current server.

Returns:

Whether or not the packet is supported.

getProtocol

public PacketType.Protocol getProtocol()

Retrieve the protocol (the connection state) the packet type belongs.

Returns:

The protocol of this type.

getSender

public PacketType.Sender getSender()

Retrieve which sender will transmit packets of this type.

Returns:

The sender of these packets.

isClient

public boolean isClient()

Determine if this packet was sent by the client.

Returns:

TRUE if it was, FALSE otherwise.

isServer

public boolean isServer()

Determine if this packet was sent by the server.

Returns:

TRUE if it was, FALSE otherwise.

getCurrentId

public int getCurrentId()

Retrieve the current protocol ID for this packet type.

This is only unique within a specific protocol and target.

It is only unknown if the packet was removed in Minecraft 1.7.2.

Returns:

The current ID, or UNKNOWN_PACKET if unknown.

getPacketClass

public java.lang.Class<?> getPacketClass()

Retrieve the equivalent packet class.

Returns:

The packet class, or NULL if not found.

name

public java.lang.String name()

Retrieve the declared enum name of this packet type.

Returns:

The enum name.

getCurrentVersion

public MinecraftVersion getCurrentVersion()

Retrieve the Minecraft version for the current ID.

Returns:

The Minecraft version.

getLegacyId

public int getLegacyId()

Retrieve the legacy (1.6.4 or below) protocol ID of the packet type.

This ID is globally unique.

Returns:

The legacy ID, or UNKNOWN_PACKET if unknown.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

compareTo

public int compareTo(PacketType other)

Specified by:

compareTo in interface java.lang.Comparable<PacketType>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object