Package org.bukkit.conversations

Class Conversation

java.lang.Object
org.bukkit.conversations.Conversation
@Deprecated(forRemoval=true) public class Conversation extends Object
Deprecated, for removal: This API element is subject to removal in a future version.
The conversation API has been deprecated for removal. This system does not support component based messages and has been slowly losing functionality over the years as Minecraft has changed that this API can not adapt to. It is recommended you instead manually listen to the AsyncChatEvent or alternatively using Dialog to get user input.
The Conversation class is responsible for tracking the current state of a conversation, displaying prompts to the user, and dispatching the user's response to the appropriate place. Conversation objects are not typically instantiated directly. Instead a ConversationFactory is used to construct identical conversations on demand.

Conversation flow consists of a directed graph of Prompt objects. Each time a prompt gets input from the user, it must return the next prompt in the graph. Since each Prompt chooses the next Prompt, complex conversation trees can be implemented where the nature of the player's response directs the flow of the conversation.

Each conversation has a ConversationPrefix that prepends all output from the conversation to the player. The ConversationPrefix can be used to display the plugin name or conversation status as the conversation evolves.

Each conversation has a timeout measured in the number of inactive seconds to wait before abandoning the conversation. If the inactivity timeout is reached, the conversation is abandoned and the user's incoming and outgoing chat is returned to normal.

You should not construct a conversation manually. Instead, use the ConversationFactory for access to all available options.

  • Field Details

    • currentPrompt

      protected Prompt currentPrompt
      Deprecated, for removal: This API element is subject to removal in a future version.

    • context

      protected ConversationContext context
      Deprecated, for removal: This API element is subject to removal in a future version.

    • localEchoEnabled

      protected boolean localEchoEnabled
      Deprecated, for removal: This API element is subject to removal in a future version.

    • prefix

      protected ConversationPrefix prefix
      Deprecated, for removal: This API element is subject to removal in a future version.

    • cancellers

      protected List<ConversationCanceller> cancellers
      Deprecated, for removal: This API element is subject to removal in a future version.

    • abandonedListeners

      protected List<ConversationAbandonedListener> abandonedListeners
      Deprecated, for removal: This API element is subject to removal in a future version.

  • Constructor Details

    • Conversation

      public Conversation(@Nullable @Nullable Plugin plugin, @NotNull @NotNull Conversable forWhom, @Nullable @Nullable Prompt firstPrompt)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Initializes a new Conversation.
      Parameters:
      plugin - The plugin that owns this conversation.
      forWhom - The entity for whom this conversation is mediating.
      firstPrompt - The first prompt in the conversation graph.

    • Conversation

      public Conversation(@Nullable @Nullable Plugin plugin, @NotNull @NotNull Conversable forWhom, @Nullable @Nullable Prompt firstPrompt, @NotNull @NotNull Map<Object,Object> initialSessionData)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Initializes a new Conversation.
      Parameters:
      plugin - The plugin that owns this conversation.
      forWhom - The entity for whom this conversation is mediating.
      firstPrompt - The first prompt in the conversation graph.
      initialSessionData - Any initial values to put in the conversation context sessionData map.

  • Method Details

    • getForWhom

      @NotNull public @NotNull Conversable getForWhom()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the entity for whom this conversation is mediating.
      Returns:
      The entity.

    • isModal

      public boolean isModal()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the modality of this conversation. If a conversation is modal, all messages directed to the player are suppressed for the duration of the conversation.
      Returns:
      The conversation modality.

    • isLocalEchoEnabled

      public boolean isLocalEchoEnabled()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the status of local echo for this conversation. If local echo is enabled, any text submitted to a conversation gets echoed back into the submitter's chat window.
      Returns:
      The status of local echo.

    • setLocalEchoEnabled

      public void setLocalEchoEnabled(boolean localEchoEnabled)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Sets the status of local echo for this conversation. If local echo is enabled, any text submitted to a conversation gets echoed back into the submitter's chat window.
      Parameters:
      localEchoEnabled - The status of local echo.

    • getPrefix

      @NotNull public @NotNull ConversationPrefix getPrefix()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the ConversationPrefix that prepends all output from this conversation.
      Returns:
      The ConversationPrefix in use.

    • getCancellers

      @NotNull public @NotNull List<ConversationCanceller> getCancellers()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the list of ConversationCancellers
      Returns:
      The list.

    • getContext

      @NotNull public @NotNull ConversationContext getContext()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns the Conversation's ConversationContext.
      Returns:
      The ConversationContext.

    • begin

      public void begin()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Displays the first prompt of this conversation and begins redirecting the user's chat responses.

    • getState

      @NotNull public @NotNull Conversation.ConversationState getState()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns the current state of the conversation.
      Returns:
      the current state of the conversation

    • acceptInput

      public void acceptInput(@NotNull @NotNull String input)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Passes player input into the current prompt. The next prompt (as determined by the current prompt) is then displayed to the user.
      Parameters:
      input - The user's chat text.

    • addConversationAbandonedListener

      public void addConversationAbandonedListener(@NotNull @NotNull ConversationAbandonedListener listener)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Adds a ConversationAbandonedListener.
      Parameters:
      listener - The listener to add.

    • removeConversationAbandonedListener

      public void removeConversationAbandonedListener(@NotNull @NotNull ConversationAbandonedListener listener)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Removes a ConversationAbandonedListener.
      Parameters:
      listener - The listener to remove.

    • abandon

      public void abandon()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Abandons and resets the current conversation. Restores the user's normal chat behavior.

    • abandon

      public void abandon(@NotNull @NotNull ConversationAbandonedEvent details)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Abandons and resets the current conversation. Restores the user's normal chat behavior.
      Parameters:
      details - Details about why the conversation was abandoned

    • outputNextPrompt

      public void outputNextPrompt()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Displays the next user prompt and abandons the conversation if the next prompt is null.