mirror of
https://github.com/essentials/Essentials.git
synced 2025-09-26 06:09:15 +02:00
54 lines
1.4 KiB
Java
54 lines
1.4 KiB
Java
package com.earth2me.essentials.api;
|
|
|
|
import java.util.Collection;
|
|
import net.ess3.api.IUser;
|
|
import org.bukkit.Location;
|
|
|
|
|
|
public interface IJails extends IReload
|
|
{
|
|
/**
|
|
* Gets the location of the jail with the given name
|
|
* @param jailName The name of the jail
|
|
* @return the location of the jail
|
|
* @throws Exception if the jail does not exist
|
|
*/
|
|
Location getJail(String jailName) throws Exception;
|
|
|
|
/**
|
|
* Gets a list of jails by names
|
|
* @return a list of jails, if there are none the list will be empty
|
|
* @throws Exception
|
|
*/
|
|
Collection<String> getList() throws Exception;
|
|
|
|
/**
|
|
* Gets the number of jails
|
|
* @return the size of the list of jails
|
|
*/
|
|
int getCount();
|
|
|
|
/**
|
|
* Remove the jail with the given name
|
|
* @param jail the jail to remove
|
|
* @throws Exception if the jail does not exist
|
|
*/
|
|
void removeJail(String jail) throws Exception;
|
|
|
|
/**
|
|
* Attempts to send the given user to the given jail
|
|
* @param user the user to send to jail
|
|
* @param jail the jail to send the user to
|
|
* @throws Exception if the user is offline or jail does not exist
|
|
*/
|
|
void sendToJail(IUser user, String jail) throws Exception;
|
|
|
|
/**
|
|
* Set a new jail with the given name and location
|
|
* @param jailName the name of the jail being set
|
|
* @param loc the location of the jail being set
|
|
* @throws Exception
|
|
*/
|
|
void setJail(String jailName, Location loc) throws Exception;
|
|
}
|