com.comphenix.protocol

Interface ProtocolManager

All Known Implementing Classes:

PacketFilterManager

public interface ProtocolManager

Represents an API for accessing the Minecraft protocol.

Author:

Kristian

Method Summary

Methods

Modifier and Type	Method and Description
void	addPacketListener(PacketListener listener) Adds a packet listener.
PacketContainer	createPacket(int id) Constructs a new encapsulated Minecraft packet with the given ID.
PacketContainer	createPacket(int id, boolean forceDefaults) Constructs a new encapsulated Minecraft packet with the given ID.
PacketConstructor	createPacketConstructor(int id, java.lang.Object... arguments) Construct a packet using the special builtin Minecraft constructors.
com.google.common.collect.ImmutableSet<PacketListener>	getPacketListeners() Retrieves a list of every registered packet listener.
java.util.Set<java.lang.Integer>	getReceivingFilters() Retrieves a immutable set containing the ID of the recieved client packets that will be observed by listeners.
java.util.Set<java.lang.Integer>	getSendingFilters() Retrieves a immutable set containing the ID of the sent server packets that will be observed by listeners.
boolean	isClosed() Determines whether or not this protocol mananger has been disabled.
void	recieveClientPacket(org.bukkit.entity.Player sender, PacketContainer packet) Simulate recieving a certain packet from a given player.
void	recieveClientPacket(org.bukkit.entity.Player sender, PacketContainer packet, boolean filters) Simulate recieving a certain packet from a given player.
void	removePacketListener(PacketListener listener) Removes a given packet listener.
void	removePacketListeners(org.bukkit.plugin.Plugin plugin) Removes every listener associated with the given plugin.
void	sendServerPacket(org.bukkit.entity.Player reciever, PacketContainer packet) Send a packet to the given player.
void	sendServerPacket(org.bukkit.entity.Player reciever, PacketContainer packet, boolean filters) Send a packet to the given player.
void	updateEntity(org.bukkit.entity.Entity entity, java.util.List<org.bukkit.entity.Player> observers) Completely refresh all clients about an entity.

Method Detail

getPacketListeners

com.google.common.collect.ImmutableSet<PacketListener> getPacketListeners()

Retrieves a list of every registered packet listener.

Returns:

Every registered packet listener.

addPacketListener

void addPacketListener(PacketListener listener)

Adds a packet listener.

Adding an already registered listener has no effect. If you need to change the packets the current listener is observing, you must first remove the packet listener before you can register it again.

Parameters:

listener - - new packet listener.

removePacketListener

void removePacketListener(PacketListener listener)

Removes a given packet listener.

Attempting to remove a listener that doesn't exist has no effect.

Parameters:

listener - - the packet listener to remove.

removePacketListeners

void removePacketListeners(org.bukkit.plugin.Plugin plugin)

Removes every listener associated with the given plugin.

Parameters:

plugin - - the plugin to unload.

sendServerPacket

void sendServerPacket(org.bukkit.entity.Player reciever,
                    PacketContainer packet)
                      throws java.lang.reflect.InvocationTargetException

Send a packet to the given player.

Parameters:

reciever - - the reciever.

packet - - packet to send.

Throws:

java.lang.reflect.InvocationTargetException - - if an error occured when sending the packet.

sendServerPacket

void sendServerPacket(org.bukkit.entity.Player reciever,
                    PacketContainer packet,
                    boolean filters)
                      throws java.lang.reflect.InvocationTargetException

Send a packet to the given player.

Parameters:

reciever - - the reciever.

packet - - packet to send.

filters - - whether or not to invoke any packet filters.

Throws:

java.lang.reflect.InvocationTargetException - - if an error occured when sending the packet.

recieveClientPacket

void recieveClientPacket(org.bukkit.entity.Player sender,
                       PacketContainer packet)
                         throws java.lang.IllegalAccessException,
                                java.lang.reflect.InvocationTargetException

Simulate recieving a certain packet from a given player.

Parameters:

sender - - the sender.

packet - - the packet that was sent.

Throws:

java.lang.reflect.InvocationTargetException - If the reflection machinery failed.

java.lang.IllegalAccessException - If the underlying method caused an error.

recieveClientPacket

void recieveClientPacket(org.bukkit.entity.Player sender,
                       PacketContainer packet,
                       boolean filters)
                         throws java.lang.IllegalAccessException,
                                java.lang.reflect.InvocationTargetException

Simulate recieving a certain packet from a given player.

Parameters:

sender - - the sender.

packet - - the packet that was sent.

filters - - whether or not to invoke any packet filters.

Throws:

java.lang.reflect.InvocationTargetException - If the reflection machinery failed.

java.lang.IllegalAccessException - If the underlying method caused an error.

createPacket

PacketContainer createPacket(int id)

Constructs a new encapsulated Minecraft packet with the given ID.

Parameters:

id - - packet ID.

Returns:

New encapsulated Minecraft packet.

createPacket

PacketContainer createPacket(int id,
                           boolean forceDefaults)

Constructs a new encapsulated Minecraft packet with the given ID.

If set to true, the forceDefaults option will force the system to automatically give non-primitive fields in the packet sensible default values. For instance, certain packets - like Packet60Explosion - require a List or Set to be non-null. If the forceDefaults option is true, the List or Set will be automatically created.

Parameters:

id - - packet ID.

forceDefaults - - TRUE to use sensible defaults in most fields, FALSE otherwise.

Returns:

New encapsulated Minecraft packet.

createPacketConstructor

PacketConstructor createPacketConstructor(int id,
                                        java.lang.Object... arguments)

Construct a packet using the special builtin Minecraft constructors.

Parameters:

id - - the packet ID.

arguments - - arguments that will be passed to the constructor.

Returns:

The packet constructor.

updateEntity

void updateEntity(org.bukkit.entity.Entity entity,
                java.util.List<org.bukkit.entity.Player> observers)
                  throws FieldAccessException

Completely refresh all clients about an entity.

Note that this method is NOT thread safe. If you call this method from anything but the main thread, it will throw an exception.

Parameters:

entity - - entity to refresh.

observers - - the clients to update.

Throws:

FieldAccessException

getSendingFilters

java.util.Set<java.lang.Integer> getSendingFilters()

Retrieves a immutable set containing the ID of the sent server packets that will be observed by listeners.

Returns:

Every filtered server packet.

getReceivingFilters

java.util.Set<java.lang.Integer> getReceivingFilters()

Retrieves a immutable set containing the ID of the recieved client packets that will be observed by listeners.

Returns:

Every filtered client packet.

isClosed

boolean isClosed()

Determines whether or not this protocol mananger has been disabled.

Returns:

TRUE if it has, FALSE otherwise.