Package com.winterhavenmc.library.messagebuilder.models.recipient

package com.winterhavenmc.library.messagebuilder.models.recipient
Contains a sealed model hierarchy representing classified message recipients in a Bukkit-based command or messaging context.

The Recipient interface and its nested types allow plugin developers to reason about the type of a CommandSender at runtime using a type-safe, data-driven approach.

Recipient Categories

  • Recipient.Valid – A standard, recognized sender such as a player, console, or command block
  • Recipient.Proxied – A ProxiedCommandSender that represents a delegated command flow
  • Recipient.Invalid – A null or unsupported sender, accompanied by a reason code

Usage

The factory method Recipient.of(CommandSender) is used to classify any incoming CommandSender, and returns a sealed Recipient subtype appropriate to its role. 
 Recipient recipient = Recipient.of(sender);
 if (recipient instanceof Recipient.Sendable sendable) {
     sendable.sender().sendMessage("Welcome!");
 }
This model is typically used by the message dispatch layer of the library to safely and clearly manage how messages are sent based on the sender's context.
See Also:
  • Class
    Description
    Recipient
    A sealed interface and its related types that represent different categories of message recipients in a player message context.
    Recipient.Invalid
    Represents an invalid or unrecognized message recipient.
    Recipient.InvalidReason
    Indicates the reason a Recipient was deemed invalid.
    Recipient.Proxied
    Represents a proxied command sender (e.g., from another plugin or dispatch chain).
    Recipient.Sendable
    A marker subinterface for Recipient types that are capable of receiving messages directly.
    Recipient.Valid
    Represents a valid, recognized message recipient such as a player, console, or command block.