Package org.bukkit.plugin.messaging

Interface PluginMessageRecipient

All Known Subinterfaces:

Player, Server, World

public interface PluginMessageRecipient

Represents a possible recipient for a Plugin Message.

Method Summary

Modifier and Type	Method	Description
Set<String>	getListeningPluginChannels()	Gets a set containing all the Plugin Channels that this client is listening on.
void	sendPluginMessage(Plugin source, String channel, byte[] message)	Sends this recipient a Plugin Message on the specified outgoing channel.

Method Details

sendPluginMessage

void sendPluginMessage(@NotNull
 Plugin source,
 @NotNull
 String channel,
 @NotNull
 byte[] message)

Sends this recipient a Plugin Message on the specified outgoing channel.

The message may not be larger than Messenger.MAX_MESSAGE_SIZE bytes, and the plugin must be registered to send messages on the specified channel.

Parameters:

source - The plugin that sent this message.

channel - The channel to send this message on.

message - The raw message to send.

Throws:

IllegalArgumentException - Thrown if the source plugin is disabled.

IllegalArgumentException - Thrown if source, channel or message is null.

MessageTooLargeException - Thrown if the message is too big.

ChannelNotRegisteredException - Thrown if the channel is not registered for this plugin.

getListeningPluginChannels

@NotNull
Set<String> getListeningPluginChannels()

Gets a set containing all the Plugin Channels that this client is listening on.

Returns:

Set containing all the channels that this client may accept.