com.sk89q.worldguard.bukkit.commands.region

Class MemberCommands

java.lang.Object

com.sk89q.worldguard.bukkit.commands.region.MemberCommands

public class MemberCommands
extends Object

Constructor Summary

Constructors

Constructor and Description
MemberCommands(WorldGuardPlugin plugin)

Method Summary

Modifier and Type	Method and Description
void	addMember(com.sk89q.minecraft.util.commands.CommandContext args, org.bukkit.command.CommandSender sender)
void	addOwner(com.sk89q.minecraft.util.commands.CommandContext args, org.bukkit.command.CommandSender sender)
protected static ProtectedRegion	checkExistingRegion(RegionManager regionManager, String id, boolean allowGlobal) Get a protected region by a given name, otherwise throw a CommandException.
protected static void	checkRegionDoesNotExist(RegionManager manager, String id, boolean mayRedefine) Check that a region with the given ID does not already exist.
protected static ProtectedRegion	checkRegionFromSelection(org.bukkit.entity.Player player, String id) Create a ProtectedRegion from the player's selection.
protected static String	checkRegionId(String id, boolean allowGlobal) Validate a region ID.
protected static RegionManager	checkRegionManager(WorldGuardPlugin plugin, org.bukkit.World world) Check that the given region manager is not null.
protected static ProtectedRegion	checkRegionStandingIn(RegionManager regionManager, org.bukkit.entity.Player player) Get the region at the player's location, if possible.
protected static ProtectedRegion	checkRegionStandingIn(RegionManager regionManager, org.bukkit.entity.Player player, boolean allowGlobal) Get the region at the player's location, if possible.
protected static com.sk89q.worldedit.bukkit.selections.Selection	checkSelection(org.bukkit.entity.Player player) Get a WorldEdit selection for a player, or emit an exception if there is none available.
protected static org.bukkit.World	checkWorld(com.sk89q.minecraft.util.commands.CommandContext args, org.bukkit.command.CommandSender sender, char flag) Gets the world from the given flag, or falling back to the the current player if the sender is a player, otherwise reporting an error.
protected static RegionPermissionModel	getPermissionModel(org.bukkit.command.CommandSender sender) Get the permission model to lookup permissions.
protected static void	informNewUser(org.bukkit.command.CommandSender sender, RegionManager manager, ProtectedRegion region) Inform a new user about automatic protection.
void	removeMember(com.sk89q.minecraft.util.commands.CommandContext args, org.bukkit.command.CommandSender sender)
void	removeOwner(com.sk89q.minecraft.util.commands.CommandContext args, org.bukkit.command.CommandSender sender)
protected static <V> void	setFlag(ProtectedRegion region, Flag<V> flag, org.bukkit.command.CommandSender sender, String value) Utility method to set a flag.
protected static void	setPlayerSelection(org.bukkit.entity.Player player, ProtectedRegion region) Set a player's selection to a given region.
protected static void	warnAboutDimensions(org.bukkit.command.CommandSender sender, ProtectedRegion region) Warn the sender if the dimensions of the given region are worrying.
protected static void	warnAboutSaveFailures(org.bukkit.command.CommandSender sender) Warn the region saving is failing.

Methods inherited from class java.lang.Object

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

Constructor Detail

MemberCommands

public MemberCommands(WorldGuardPlugin plugin)

Method Detail

addMember

public void addMember(com.sk89q.minecraft.util.commands.CommandContext args,
                      org.bukkit.command.CommandSender sender)
               throws com.sk89q.minecraft.util.commands.CommandException

Throws:

com.sk89q.minecraft.util.commands.CommandException

addOwner

public void addOwner(com.sk89q.minecraft.util.commands.CommandContext args,
                     org.bukkit.command.CommandSender sender)
              throws com.sk89q.minecraft.util.commands.CommandException

Throws:

com.sk89q.minecraft.util.commands.CommandException

removeMember

public void removeMember(com.sk89q.minecraft.util.commands.CommandContext args,
                         org.bukkit.command.CommandSender sender)
                  throws com.sk89q.minecraft.util.commands.CommandException

Throws:

com.sk89q.minecraft.util.commands.CommandException

removeOwner

public void removeOwner(com.sk89q.minecraft.util.commands.CommandContext args,
                        org.bukkit.command.CommandSender sender)
                 throws com.sk89q.minecraft.util.commands.CommandException

Throws:

com.sk89q.minecraft.util.commands.CommandException

getPermissionModel

protected static RegionPermissionModel getPermissionModel(org.bukkit.command.CommandSender sender)

Get the permission model to lookup permissions.

Parameters:

sender - the sender

Returns:

the permission model

checkWorld

protected static org.bukkit.World checkWorld(com.sk89q.minecraft.util.commands.CommandContext args,
                                             org.bukkit.command.CommandSender sender,
                                             char flag)
                                      throws com.sk89q.minecraft.util.commands.CommandException

Gets the world from the given flag, or falling back to the the current player if the sender is a player, otherwise reporting an error.

Parameters:

args - the arguments

sender - the sender

flag - the flag (such as 'w')

Returns:

a world

Throws:

com.sk89q.minecraft.util.commands.CommandException - on error

checkRegionId

protected static String checkRegionId(String id,
                                      boolean allowGlobal)
                               throws com.sk89q.minecraft.util.commands.CommandException

Validate a region ID.

Parameters:

id - the id

allowGlobal - whether __global__ is allowed

Returns:

the id given

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown on an error

checkExistingRegion

protected static ProtectedRegion checkExistingRegion(RegionManager regionManager,
                                                     String id,
                                                     boolean allowGlobal)
                                              throws com.sk89q.minecraft.util.commands.CommandException

Get a protected region by a given name, otherwise throw a CommandException.

This also validates the region ID.

Parameters:

regionManager - the region manager

id - the name to search

allowGlobal - true to allow selecting __global__

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown if no region is found by the given name

checkRegionStandingIn

protected static ProtectedRegion checkRegionStandingIn(RegionManager regionManager,
                                                       org.bukkit.entity.Player player)
                                                throws com.sk89q.minecraft.util.commands.CommandException

Get the region at the player's location, if possible.

If the player is standing in several regions, an error will be raised and a list of regions will be provided.

Parameters:

regionManager - the region manager

player - the player

Returns:

a region

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown if no region was found

checkRegionStandingIn

protected static ProtectedRegion checkRegionStandingIn(RegionManager regionManager,
                                                       org.bukkit.entity.Player player,
                                                       boolean allowGlobal)
                                                throws com.sk89q.minecraft.util.commands.CommandException

Get the region at the player's location, if possible.

If the player is standing in several regions, an error will be raised and a list of regions will be provided.

If the player is not standing in any regions, the global region will returned if allowGlobal is true and it exists.

Parameters:

regionManager - the region manager

player - the player

allowGlobal - whether to search for a global region if no others are found

Returns:

a region

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown if no region was found

checkSelection

protected static com.sk89q.worldedit.bukkit.selections.Selection checkSelection(org.bukkit.entity.Player player)
                                                                         throws com.sk89q.minecraft.util.commands.CommandException

Get a WorldEdit selection for a player, or emit an exception if there is none available.

Parameters:

player - the player

Returns:

the selection

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown on an error

checkRegionDoesNotExist

protected static void checkRegionDoesNotExist(RegionManager manager,
                                              String id,
                                              boolean mayRedefine)
                                       throws com.sk89q.minecraft.util.commands.CommandException

Check that a region with the given ID does not already exist.

Parameters:

manager - the manager

id - the ID

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown if the ID already exists

checkRegionManager

protected static RegionManager checkRegionManager(WorldGuardPlugin plugin,
                                                  org.bukkit.World world)
                                           throws com.sk89q.minecraft.util.commands.CommandException

Check that the given region manager is not null.

Parameters:

plugin - the plugin

world - the world

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown if the manager is null

checkRegionFromSelection

protected static ProtectedRegion checkRegionFromSelection(org.bukkit.entity.Player player,
                                                          String id)
                                                   throws com.sk89q.minecraft.util.commands.CommandException

Create a ProtectedRegion from the player's selection.

Parameters:

player - the player

id - the ID of the new region

Returns:

a new region

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown on an error

warnAboutSaveFailures

protected static void warnAboutSaveFailures(org.bukkit.command.CommandSender sender)

Warn the region saving is failing.

Parameters:

sender - the sender to send the message to

warnAboutDimensions

protected static void warnAboutDimensions(org.bukkit.command.CommandSender sender,
                                          ProtectedRegion region)

Warn the sender if the dimensions of the given region are worrying.

Parameters:

sender - the sender to send the message to

region - the region

informNewUser

protected static void informNewUser(org.bukkit.command.CommandSender sender,
                                    RegionManager manager,
                                    ProtectedRegion region)

Inform a new user about automatic protection.

Parameters:

sender - the sender to send the message to

manager - the region manager

region - the region

setPlayerSelection

protected static void setPlayerSelection(org.bukkit.entity.Player player,
                                         ProtectedRegion region)
                                  throws com.sk89q.minecraft.util.commands.CommandException

Set a player's selection to a given region.

Parameters:

player - the player

region - the region

Throws:

com.sk89q.minecraft.util.commands.CommandException - thrown on a command error

setFlag

protected static <V> void setFlag(ProtectedRegion region,
                                  Flag<V> flag,
                                  org.bukkit.command.CommandSender sender,
                                  String value)
                           throws InvalidFlagFormat

Utility method to set a flag.

Parameters:

region - the region

flag - the flag

sender - the sender

value - the value

Throws:

InvalidFlagFormat - thrown if the value is invalid