Package io.papermc.paper.event.world

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:

• The /locate command is used.
  
• An Eye of Ender is used.
• An Explorer/Treasure Map is activated.
• A dolphin swims to a treasure location.
• A trade is done with a villager for a map.
• World.locateNearestStructure(Location, StructureType, int, boolean) is invoked.
• World.locateNearestStructure(Location, Structure, int, boolean) is invoked.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	StructuresLocateEvent.Result	Result for StructuresLocateEvent.

Constructor Summary

Constructors

Constructor	Description
StructuresLocateEvent(World world, Location origin, List<Structure> structures, int radius, boolean findUnexplored)

Method Summary

Modifier and Type	Method	Description
static HandlerList	getHandlerList()
HandlerList	getHandlers()
Location	getOrigin()	Gets the Location from which the search is to be conducted.
int	getRadius()	Gets the search radius in which to attempt locating the structure.
@Nullable StructuresLocateEvent.Result	getResult()	Gets the Location and Structure set as the result, if it was defined.
@UnmodifiableView List<Structure>	getStructures()	Gets an unmodifiable list of Structures that are valid targets for the search.
boolean	isCancelled()	Gets the cancellation state of this event.
void	setCancelled(boolean cancel)	Sets the cancellation state of this event.
void	setFindUnexplored(boolean findUnexplored)	Sets whether to search exclusively for unexplored structures.
void	setRadius(int radius)	Sets the search radius in which to attempt locating the structure.
void	setResult(@Nullable StructuresLocateEvent.Result result)	Sets the result Location and Structure.
void	setStructures(List<Structure> structures)	Sets the list of Structures that are valid targets for the search.
boolean	shouldFindUnexplored()	Gets whether to search exclusively for unexplored structures.

Methods inherited from class org.bukkit.event.world.WorldEvent

getWorld

Methods inherited from class org.bukkit.event.Event

callEvent, getEventName, isAsynchronous

Methods inherited from class java.lang.Object

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

Constructor Details

StructuresLocateEvent

@Internal
public StructuresLocateEvent(World world,
 Location origin,
 List<Structure> structures,
 int radius,
 boolean findUnexplored)

Method Details

getOrigin

public Location getOrigin()

Gets the Location from which the search is to be conducted.

Returns:

Location where search begins

getResult

public @Nullable StructuresLocateEvent.Result 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:

• World.locateNearestStructure(Location, StructureType, int, boolean)

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()