Class StructuresLocateEvent

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

@NullMarked public class StructuresLocateEvent extends WorldEvent implements Cancellable
Called before a set of configured structures is located. This happens when:
  • Constructor Details

  • Method Details

    • getOrigin

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

      Gets the Location and Structure set as the result, if it was defined.

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

      Returns:
      The result location and structure, if it has been set. null if it has not.
      See Also:
    • setResult

      public void setResult(@Nullable StructuresLocateEvent.Result result)
      Sets the result Location and Structure. This causes the search to be skipped, and the result object passed here to be used as the result.
      Parameters:
      result - the Location and Structure of the search.
    • getStructures

      public @UnmodifiableView List<Structure> getStructures()
      Gets an unmodifiable list of Structures that are valid targets for the search.
      Returns:
      an unmodifiable list of Structures
    • setStructures

      public void setStructures(List<Structure> structures)
      Sets the list of Structures that are valid targets for the search.
      Parameters:
      structures - a list of Structures targets
    • 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 (in chunks)
    • 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 (in chunks)
    • 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
    • getHandlers

      public HandlerList getHandlers()
      Specified by:
      getHandlers in class Event
    • getHandlerList

      public static HandlerList getHandlerList()