diff --git a/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java b/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java index 4ddf7eccc1..ae5631144b 100644 --- a/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java +++ b/paper-api/src/main/java/org/bukkit/event/server/BroadcastMessageEvent.java @@ -1,16 +1,16 @@ package org.bukkit.event.server; +import java.util.Set; import org.bukkit.command.CommandSender; -import org.bukkit.entity.Player; import org.bukkit.event.Cancellable; import org.bukkit.event.HandlerList; -import java.util.Set; - /** - * Event triggered for {@link org.bukkit.Server#broadcast(String, String)} + * Event triggered for server broadcast messages such as from + * {@link org.bukkit.Server#broadcast(String, String)}. */ public class BroadcastMessageEvent extends ServerEvent implements Cancellable { + private static final HandlerList handlers = new HandlerList(); private String message; private final Set recipients; @@ -22,7 +22,7 @@ public class BroadcastMessageEvent extends ServerEvent implements Cancellable { } /** - * Get the message to broadcast + * Get the message to broadcast. * * @return Message to broadcast */ @@ -31,16 +31,24 @@ public class BroadcastMessageEvent extends ServerEvent implements Cancellable { } /** - * Set the message to broadcast + * Set the message to broadcast. * - * @param message Message to broadcast + * @param message New message to broadcast */ public void setMessage(String message) { this.message = message; } /** - * Gets a set of recipients that this broadcast message will be displayed to. + * Gets a set of recipients that this chat message will be displayed to. + *

+ * The set returned is not guaranteed to be mutable and may auto-populate + * on access. Any listener accessing the returned set should be aware that + * it may reduce performance for a lazy set implementation. + *

+ * Listeners should be aware that modifying the list may throw {@link + * UnsupportedOperationException} if the event caller provides an + * unmodifiable set. * * @return All CommandSenders who will see this chat message */