com.sk89q.worldguard.commands.region

Class MemberCommands

java.lang.Object

com.sk89q.worldguard.commands.region.MemberCommands

public class MemberCommands
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
MemberCommands(WorldGuard worldGuard)

Method Summary

Modifier and Type	Method and Description
void	addMember(com.sk89q.minecraft.util.commands.CommandContext args, com.sk89q.worldedit.extension.platform.Actor sender)
void	addOwner(com.sk89q.minecraft.util.commands.CommandContext args, com.sk89q.worldedit.extension.platform.Actor sender)
protected static ProtectedRegion	checkExistingRegion(RegionManager regionManager, java.lang.String id, boolean allowGlobal) Get a protected region by a given name, otherwise throw a CommandException.
protected static void	checkRegionDoesNotExist(RegionManager manager, java.lang.String id, boolean mayRedefine) Check that a region with the given ID does not already exist.
protected static ProtectedRegion	checkRegionFromSelection(LocalPlayer player, java.lang.String id) Create a ProtectedRegion from the player's selection.
protected static java.lang.String	checkRegionId(java.lang.String id, boolean allowGlobal) Validate a region ID.
protected static RegionManager	checkRegionManager(com.sk89q.worldedit.world.World world) Check that the given region manager is not null.
protected static ProtectedRegion	checkRegionStandingIn(RegionManager regionManager, LocalPlayer player, boolean allowGlobal, java.lang.String rgCmd) Get the region at the player's location, if possible.
protected static ProtectedRegion	checkRegionStandingIn(RegionManager regionManager, LocalPlayer player, java.lang.String rgCmd) Get the region at the player's location, if possible.
protected static com.sk89q.worldedit.regions.Region	checkSelection(LocalPlayer player) Get a WorldEdit selection for a player, or emit an exception if there is none available.
protected static com.sk89q.worldedit.world.World	checkWorld(com.sk89q.minecraft.util.commands.CommandContext args, com.sk89q.worldedit.extension.platform.Actor 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(com.sk89q.worldedit.extension.platform.Actor sender) Get the permission model to lookup permissions.
protected static void	informNewUser(com.sk89q.worldedit.extension.platform.Actor sender, RegionManager manager, ProtectedRegion region) Inform a new user about automatic protection.
void	removeMember(com.sk89q.minecraft.util.commands.CommandContext args, com.sk89q.worldedit.extension.platform.Actor sender)
void	removeOwner(com.sk89q.minecraft.util.commands.CommandContext args, com.sk89q.worldedit.extension.platform.Actor sender)
protected static <V> void	setFlag(ProtectedRegion region, Flag<V> flag, com.sk89q.worldedit.extension.platform.Actor sender, java.lang.String value) Utility method to set a flag.
protected static void	setPlayerSelection(LocalPlayer player, ProtectedRegion region) Set a player's selection to a given region.
protected static void	warnAboutDimensions(com.sk89q.worldedit.extension.platform.Actor sender, ProtectedRegion region) Warn the sender if the dimensions of the given region are worrying.
protected static void	warnAboutSaveFailures(com.sk89q.worldedit.extension.platform.Actor 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(WorldGuard worldGuard)

Method Detail

addMember

public void addMember(com.sk89q.minecraft.util.commands.CommandContext args,
                      com.sk89q.worldedit.extension.platform.Actor 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,
                     com.sk89q.worldedit.extension.platform.Actor sender)
              throws com.sk89q.minecraft.util.commands.CommandException,
                     com.sk89q.worldedit.util.auth.AuthorizationException

Throws:

com.sk89q.minecraft.util.commands.CommandException

com.sk89q.worldedit.util.auth.AuthorizationException

removeMember

public void removeMember(com.sk89q.minecraft.util.commands.CommandContext args,
                         com.sk89q.worldedit.extension.platform.Actor 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,
                        com.sk89q.worldedit.extension.platform.Actor sender)
                 throws com.sk89q.minecraft.util.commands.CommandException

Throws:

com.sk89q.minecraft.util.commands.CommandException

getPermissionModel

protected static RegionPermissionModel getPermissionModel(com.sk89q.worldedit.extension.platform.Actor sender)

Get the permission model to lookup permissions.

Parameters:

sender - the sender

Returns:

the permission model

checkWorld

protected static com.sk89q.worldedit.world.World checkWorld(com.sk89q.minecraft.util.commands.CommandContext args,
                                                            com.sk89q.worldedit.extension.platform.Actor 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 java.lang.String checkRegionId(java.lang.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,
                                                     java.lang.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,
                                                       LocalPlayer player,
                                                       java.lang.String rgCmd)
                                                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,
                                                       LocalPlayer player,
                                                       boolean allowGlobal,
                                                       java.lang.String rgCmd)
                                                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.regions.Region checkSelection(LocalPlayer 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,
                                              java.lang.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(com.sk89q.worldedit.world.World world)
                                           throws com.sk89q.minecraft.util.commands.CommandException

Check that the given region manager is not null.

Parameters:

world - the world

Throws:

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

checkRegionFromSelection

protected static ProtectedRegion checkRegionFromSelection(LocalPlayer player,
                                                          java.lang.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(com.sk89q.worldedit.extension.platform.Actor sender)

Warn the region saving is failing.

Parameters:

sender - the sender to send the message to

warnAboutDimensions

protected static void warnAboutDimensions(com.sk89q.worldedit.extension.platform.Actor 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(com.sk89q.worldedit.extension.platform.Actor 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(LocalPlayer 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,
                                  com.sk89q.worldedit.extension.platform.Actor sender,
                                  java.lang.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