org.imanity.imanityspigot.event

Class AsyncTabCompleteEvent

java.lang.Object

org.bukkit.event.Event

org.imanity.imanityspigot.event.AsyncTabCompleteEvent

All Implemented Interfaces:

Cancellable

public class AsyncTabCompleteEvent
extends Event
implements Cancellable

Allows plugins to compute tab completion results asynchronously. If this event provides completions, then the standard synchronous process will not be fired to populate the results. However, the synchronous TabCompleteEvent will fire with the Async results. Only 1 process will be allowed to provide completions, the Async Event, or the standard process.

Nested Class Summary

Nested classes/interfaces inherited from class org.bukkit.event.Event

Event.Result

Constructor Summary

Constructors

Constructor and Description
AsyncTabCompleteEvent(CommandSender sender, List<String> completions, String buffer, boolean isCommand, Location loc)
AsyncTabCompleteEvent(@NotNull CommandSender sender, @NotNull String buffer, boolean isCommand, @Nullable Location loc)

Method Summary

Modifier and Type	Method and Description
String	getBuffer() Return the entire buffer which formed the basis of this completion.
List<String>	getCompletions() The list of completions which will be offered to the sender, in order.
static HandlerList	getHandlerList()
HandlerList	getHandlers()
Location	getLocation()
CommandSender	getSender() Get the sender completing this command.
boolean	isCancelled() Gets the cancellation state of this event.
boolean	isCommand()
boolean	isHandled() If true, the standard process of calling Command.tabComplete(CommandSender, String, String[]) or current player names will not be called.
void	setCancelled(boolean cancelled) Will provide no completions, and will not fire the synchronous process
void	setCompletions(List<String> completions) Set the completions offered, overriding any already set.
void	setHandled(boolean handled) Sets whether or not to consider the completion request handled.

Methods inherited from class org.bukkit.event.Event

getEventName, isAsynchronous

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AsyncTabCompleteEvent

public AsyncTabCompleteEvent(@NotNull
                             @NotNull CommandSender sender,
                             @NotNull
                             @NotNull String buffer,
                             boolean isCommand,
                             @Nullable
                             @Nullable Location loc)

AsyncTabCompleteEvent

public AsyncTabCompleteEvent(@NonNull
                             CommandSender sender,
                             @NonNull
                             List<String> completions,
                             @NonNull
                             String buffer,
                             boolean isCommand,
                             Location loc)

Method Detail

getSender

@NonNull
public CommandSender getSender()

Get the sender completing this command.

Returns:

the CommandSender instance

getCompletions

@NonNull
public List<String> getCompletions()

The list of completions which will be offered to the sender, in order. This list is mutable and reflects what will be offered. If this collection is not empty after the event is fired, then the standard process of calling Command.tabComplete(CommandSender, String, String[]) or current player names will not be called.

Returns:

a list of offered completions

setCompletions

public void setCompletions(@NonNull
                           List<String> completions)

Set the completions offered, overriding any already set. If this collection is not empty after the event is fired, then the standard process of calling Command.tabComplete(CommandSender, String, String[]) or current player names will not be called. The passed collection will be cloned to a new List. You must call {getCompletions()} to mutate from here

Parameters:

completions - the new completions

getBuffer

@NonNull
public String getBuffer()

Return the entire buffer which formed the basis of this completion.

Returns:

command buffer, as entered

isCommand

public boolean isCommand()

Returns:

True if it is a command being tab completed, false if it is a chat message.

getLocation

public Location getLocation()

Returns:

The position looked at by the sender, or null if none

isHandled

public boolean isHandled()

If true, the standard process of calling Command.tabComplete(CommandSender, String, String[]) or current player names will not be called.

Returns:

Is completions considered handled. Always true if completions is not empty.

setHandled

public void setHandled(boolean handled)

Sets whether or not to consider the completion request handled. If true, the standard process of calling Command.tabComplete(CommandSender, String, String[]) or current player names will not be called.

Parameters:

handled - if this completion should be marked as being handled

isCancelled

public boolean isCancelled()

Description copied from interface: Cancellable

Gets the cancellation state of this event. A cancelled event will not be executed in the server, but will still pass to other plugins

Specified by:

isCancelled in interface Cancellable

Returns:

true if this event is cancelled

setCancelled

public void setCancelled(boolean cancelled)

Will provide no completions, and will not fire the synchronous process

Specified by:

setCancelled in interface Cancellable

Parameters:

cancelled - true if you wish to cancel this event

getHandlers

@NonNull
public HandlerList getHandlers()

Specified by:

getHandlers in class Event

getHandlerList

@NonNull
public static HandlerList getHandlerList()