Class StructureLocateEvent

java.lang.Object
org.bukkit.event.Event
org.bukkit.event.world.WorldEvent
io.papermc.paper.event.world.StructureLocateEvent
All Implemented Interfaces:
Cancellable

public class StructureLocateEvent extends WorldEvent implements Cancellable
Called before a structure/feature is located. This happens when:
  • Constructor Details

  • Method Details

    • getHandlerList

      @NotNull public static @NotNull HandlerList getHandlerList()
    • getHandlers

      @NotNull public @NotNull HandlerList getHandlers()
      Specified by:
      getHandlers in class Event
    • getResult

      @Nullable public @Nullable Location getResult()
      Gets the location set as the structure location, if it was defined.

      Returns null if it has not been set by setResult(Location). Since this event fires before the search is done, the actual location is unknown at this point.

      Returns:
      The result location, if it has been set. null if it has not.
      See Also:
      World.locateNearestStructure(Location, StructureType, int, boolean)
    • setResult

      public void setResult(@Nullable @Nullable Location result)
      Sets the result Location. This causes the search to be skipped, and the location passed here to be used as the result.
      Parameters:
      result - the Location of the structure.
    • getType

      @NotNull public @NotNull StructureType getType()
      Gets the StructureType that is to be located.
      Returns:
      the structure type.
    • setType

      public void setType(@NotNull @NotNull StructureType type)
      Sets the StructureType that is to be located.
      Parameters:
      type - the structure type.
    • getOrigin

      @NotNull public @NotNull Location getOrigin()
      Gets the Location from which the search is to be conducted.
      Returns:
      Location where search begins
    • getRadius

      public int getRadius()
      Gets the search radius in which to attempt locating the structure.

      This radius may not always be obeyed during the structure search!

      Returns:
      the search radius.
    • setRadius

      public void setRadius(int radius)
      Sets the search radius in which to attempt locating the structure.

      This radius may not always be obeyed during the structure search!

      Parameters:
      radius - the search radius.
    • shouldFindUnexplored

      public boolean shouldFindUnexplored()
      Gets whether to search exclusively for unexplored structures.

      As with the search radius, this value is not always obeyed.

      Returns:
      Whether to search for only unexplored structures.
    • setFindUnexplored

      public void setFindUnexplored(boolean findUnexplored)
      Sets whether to search exclusively for unexplored structures.

      As with the search radius, this value is not always obeyed.

      Parameters:
      findUnexplored - Whether to search for only unexplored structures.
    • 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 cancel)
      Description copied from interface: Cancellable
      Sets 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:
      setCancelled in interface Cancellable
      Parameters:
      cancel - true if you wish to cancel this event