com.sk89q.worldguard.session.handler

Class Handler

java.lang.Object

com.sk89q.worldguard.session.handler.Handler

Direct Known Subclasses:

EntryFlag, FarewellFlag, FeedFlag, FlagValueChangeHandler, GodMode, GreetingFlag, HealFlag, WaterBreathing

public abstract class Handler
extends Object

Stores session data and possibly acts on it.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Handler(Session session) Create a new handler.

Method Summary

Modifier and Type	Method and Description
StateFlag.State	getInvincibility(org.bukkit.entity.Player player) Return whether the player should be invincible.
WorldGuardPlugin	getPlugin() Get the plugin.
Session	getSession() Get the session.
void	initialize(org.bukkit.entity.Player player, org.bukkit.Location current, ApplicableRegionSet set) Called when the session is first being created or /wg flushstates is used.
boolean	onCrossBoundary(org.bukkit.entity.Player player, org.bukkit.Location from, org.bukkit.Location to, ApplicableRegionSet toSet, Set<ProtectedRegion> entered, Set<ProtectedRegion> exited, MoveType moveType) Called when a player has moved into a new location where either there are fewer regions or more regions.
boolean	testMoveTo(org.bukkit.entity.Player player, org.bukkit.Location from, org.bukkit.Location to, ApplicableRegionSet toSet, MoveType moveType) Called when Session.testMoveTo(Player, Location, MoveType) is called.
void	tick(org.bukkit.entity.Player player, ApplicableRegionSet set) Called periodically (at least once every second) by SessionManager in the server's main thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

Handler

protected Handler(Session session)

Create a new handler.

Parameters:

session - The session

Method Detail

getPlugin

public WorldGuardPlugin getPlugin()

Get the plugin.

Returns:

The plugin

getSession

public Session getSession()

Get the session.

Returns:

The session

initialize

public void initialize(org.bukkit.entity.Player player,
                       org.bukkit.Location current,
                       ApplicableRegionSet set)

Called when the session is first being created or /wg flushstates is used.

Parameters:

player - The player

current - The player's current location

set - The regions for the current location

testMoveTo

public boolean testMoveTo(org.bukkit.entity.Player player,
                          org.bukkit.Location from,
                          org.bukkit.Location to,
                          ApplicableRegionSet toSet,
                          MoveType moveType)

Called when Session.testMoveTo(Player, Location, MoveType) is called.

If this method returns false, then no other handlers will be run (for this move attempt).

Parameters:

player - The player

from - The previous, valid, location

to - The new location to test

toSet - The regions for the new location

moveType - The type of movement

Returns:

Whether the movement should be allowed

onCrossBoundary

public boolean onCrossBoundary(org.bukkit.entity.Player player,
                               org.bukkit.Location from,
                               org.bukkit.Location to,
                               ApplicableRegionSet toSet,
                               Set<ProtectedRegion> entered,
                               Set<ProtectedRegion> exited,
                               MoveType moveType)

Called when a player has moved into a new location where either there are fewer regions or more regions.

This is called only if the move test (Session.testMoveTo(Player, Location, MoveType)) was successful.

If this method returns false, then no other handlers will be run (for this move attempt).

Parameters:

player - The player

from - The previous, valid, location

to - The new location to test

toSet - The regions for the new location

entered - The list of regions that have been entered

exited - The list of regions that have been left

moveType - The type of move

Returns:

Whether the movement should be allowed

tick

public void tick(org.bukkit.entity.Player player,
                 ApplicableRegionSet set)

Called periodically (at least once every second) by SessionManager in the server's main thread.

Parameters:

player - The player

set - The regions for the player's current location

getInvincibility

@Nullable
public StateFlag.State getInvincibility(org.bukkit.entity.Player player)

Return whether the player should be invincible.

StateFlag.State.DENY can be returned to prevent invincibility even if another handler permits it.

Parameters:

player - The player

Returns:

Invincibility state