com.comphenix.protocol

Interface ProtocolManager

All Superinterfaces:

PacketStream

All Known Implementing Classes:

PacketFilterManager

public interface ProtocolManager
extends PacketStream

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.
AsynchronousManager	getAsynchronousManager() Retrieve the current asyncronous packet manager.
org.bukkit.entity.Entity	getEntityFromID(org.bukkit.World container, int id) Retrieve the associated entity.
java.util.List<org.bukkit.entity.Player>	getEntityTrackers(org.bukkit.entity.Entity entity) Retrieve every client that is receiving information about a given entity.
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, 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, 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 resend an entity to a list of clients.

Methods inherited from interface com.comphenix.protocol.PacketStream

recieveClientPacket, sendServerPacket

Method Detail

sendServerPacket

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

Send a packet to the given player.

Re-sending a previously cancelled packet is discuraged. Use AsyncMarker.incrementProcessingDelay() to delay a packet until a certain condition has been met.

Specified by:

sendServerPacket in interface PacketStream

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,
                       boolean filters)
                         throws java.lang.IllegalAccessException,
                                java.lang.reflect.InvocationTargetException

Simulate recieving a certain packet from a given player.

Receiving a previously cancelled packet is discuraged. Use AsyncMarker.incrementProcessingDelay() to delay a packet until a certain condition has been met.

Specified by:

recieveClientPacket in interface PacketStream

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.

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.

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 resend an entity to a list of clients.

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

getEntityFromID

org.bukkit.entity.Entity getEntityFromID(org.bukkit.World container,
                                       int id)
                                         throws FieldAccessException

Retrieve the associated entity.

Parameters:

container - - the world the entity belongs to.

id - - the unique ID of the entity.

Returns:

The associated entity.

Throws:

FieldAccessException - Reflection failed.

getEntityTrackers

java.util.List<org.bukkit.entity.Player> getEntityTrackers(org.bukkit.entity.Entity entity)
                                                           throws FieldAccessException

Retrieve every client that is receiving information about a given entity.

Parameters:

entity - - the entity that is being tracked.

Returns:

Every client/player that is tracking the given entity.

Throws:

FieldAccessException - If reflection failed.

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.

getAsynchronousManager

AsynchronousManager getAsynchronousManager()

Retrieve the current asyncronous packet manager.

Returns:

Asyncronous packet manager.