com.sk89q.worldguard.bukkit

Class ProtectionQuery

java.lang.Object

com.sk89q.worldguard.bukkit.ProtectionQuery

public class ProtectionQuery
extends java.lang.Object

A helper class to query whether a block or entity is protected by WorldGuard.

Constructor Summary

Constructors

Constructor and Description
ProtectionQuery()

Method Summary

Modifier and Type	Method and Description
boolean	testBlockBreak(java.lang.Object cause, org.bukkit.block.Block block) Test whether a block can be broken.
boolean	testBlockInteract(java.lang.Object cause, org.bukkit.block.Block block) Test whether a block can be interacted with.
boolean	testBlockPlace(java.lang.Object cause, org.bukkit.Location location, org.bukkit.Material newMaterial) Test whether a block can be placed at a given location.
boolean	testEntityDamage(java.lang.Object cause, org.bukkit.entity.Entity entity) Test whether an entity can be damaged.
boolean	testEntityDestroy(java.lang.Object cause, org.bukkit.entity.Entity entity) Test whether an entity can be destroyed.
boolean	testEntityInteract(java.lang.Object cause, org.bukkit.entity.Entity entity) Test whether an entity can be interacted with.
boolean	testEntityPlace(java.lang.Object cause, org.bukkit.Location location, org.bukkit.entity.EntityType type) Test whether an entity can be placed.

Methods inherited from class java.lang.Object

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

Constructor Detail

ProtectionQuery

public ProtectionQuery()

Method Detail

testBlockPlace

public boolean testBlockPlace(@Nullable
                              java.lang.Object cause,
                              org.bukkit.Location location,
                              org.bukkit.Material newMaterial)

Test whether a block can be placed at a given location.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

location - the location of the block

newMaterial - the new material

Returns:

true if the action is permitted

testBlockBreak

public boolean testBlockBreak(@Nullable
                              java.lang.Object cause,
                              org.bukkit.block.Block block)

Test whether a block can be broken.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

block - the block broken

Returns:

true if the action is permitted

testBlockInteract

public boolean testBlockInteract(@Nullable
                                 java.lang.Object cause,
                                 org.bukkit.block.Block block)

Test whether a block can be interacted with.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

block - the block that is interacted with

Returns:

true if the action is permitted

testEntityPlace

public boolean testEntityPlace(@Nullable
                               java.lang.Object cause,
                               org.bukkit.Location location,
                               org.bukkit.entity.EntityType type)

Test whether an entity can be placed.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

location - the location that the entity will be spawned at

type - the type that is to be spawned

Returns:

true if the action is permitted

testEntityDestroy

public boolean testEntityDestroy(@Nullable
                                 java.lang.Object cause,
                                 org.bukkit.entity.Entity entity)

Test whether an entity can be destroyed.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

entity - the entity broken

Returns:

true if the action is permitted

testEntityInteract

public boolean testEntityInteract(@Nullable
                                  java.lang.Object cause,
                                  org.bukkit.entity.Entity entity)

Test whether an entity can be interacted with.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

entity - the entity interacted with

Returns:

true if the action is permitted

testEntityDamage

public boolean testEntityDamage(@Nullable
                                java.lang.Object cause,
                                org.bukkit.entity.Entity entity)

Test whether an entity can be damaged.

The cause does not have to be a player. It can be null if the cause is not known, although the checks will executed assuming that the actor is a non-member of all regions.

Parameters:

cause - the cause, which can be a block, an entity, or a player, or null if unknown

entity - the entity damaged

Returns:

true if the action is permitted