Stanislav
11 years ago
14 changed files with 65 additions and 827 deletions
@ -1,780 +0,0 @@ |
|||||||
package ru.simsonic.rscPermissions; |
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.HashMap; |
|
||||||
import java.util.Set; |
|
||||||
import org.bukkit.OfflinePlayer; |
|
||||||
import org.bukkit.World; |
|
||||||
import org.bukkit.command.CommandSender; |
|
||||||
import org.bukkit.entity.Player; |
|
||||||
import org.bukkit.permissions.PermissionAttachment; |
|
||||||
import org.bukkit.permissions.PermissionAttachmentInfo; |
|
||||||
|
|
||||||
public class rscpAPI |
|
||||||
{ |
|
||||||
private final ru.simsonic.rscPermissions.MainPluginClass rscp; |
|
||||||
protected rscpAPI(MainPluginClass plugin) |
|
||||||
{ |
|
||||||
this.rscp = plugin; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault support method. |
|
||||||
* Checks if method is enabled. |
|
||||||
* |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean isEnabled() |
|
||||||
{ |
|
||||||
return rscp.isEnabled(); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Gets players primary group |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @return Players primary group |
|
||||||
*/ |
|
||||||
public String getPrimaryGroup(String world, String player) |
|
||||||
{ |
|
||||||
return rscp.settings.getDefaultGroup(); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Check if player is member of a group. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* This method is known to return unexpected results depending on what permission system is being used. Different |
|
||||||
* permission systems |
|
||||||
* will store the player groups differently, It is HIGHLY suggested you test your code out first. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerInGroup(String world, String player, String group) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Add player to a group. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddGroup(String world, String player, String group) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Remove player from a group. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveGroup(String world, String player, String group) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Checks if player has a permission node. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But may return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerHas(String world, String player, String permission) |
|
||||||
{ |
|
||||||
Player onlinePlayer = rscp.getServer().getPlayerExact(player); |
|
||||||
if(onlinePlayer != null) |
|
||||||
return onlinePlayer.hasPermission(permission); |
|
||||||
rscp.cache.calculateBasePermissions(player); |
|
||||||
HashMap<String, Boolean> map = rscp.cache.mapPermissions.get(player); |
|
||||||
if(map != null) |
|
||||||
{ |
|
||||||
Boolean value = map.get(permission); |
|
||||||
if(value != null) |
|
||||||
return value; |
|
||||||
} |
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Add permission to a player. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAdd(String world, String player, String permission) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Remove permission from a player. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Name of Player |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemove(String world, String player, String permission) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Checks if group has a permission node. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupHas(String world, String group, String permission) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Add permission to a group. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupAdd(String world, String group, String permission) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Remove permission from a group. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupRemove(String world, String group, String permission) |
|
||||||
{ |
|
||||||
// TO DO
|
|
||||||
return false; |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Gets the list of groups that this player has. |
|
||||||
* Supports NULL value for World if the permission system registered supports global permissions. |
|
||||||
* But May return odd values if the servers registered permission system does not have a global permission store. |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @return Array of groups |
|
||||||
*/ |
|
||||||
public String[] getPlayerGroups(String world, String player) |
|
||||||
{ |
|
||||||
ArrayList<String> list = rscp.cache.getUserGroups(player); |
|
||||||
return list.toArray(new String[list.size()]); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault permission support method. |
|
||||||
* Returns a list of all known groups |
|
||||||
* |
|
||||||
* @return an Array of String of all groups |
|
||||||
*/ |
|
||||||
public String[] getGroups() |
|
||||||
{ |
|
||||||
Set<String> groups = rscp.cache.getAllPossibleGroups(); |
|
||||||
return groups.toArray(new String[groups.size()]); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Get player's prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @return Prefix |
|
||||||
*/ |
|
||||||
public String getPlayerPrefix(String world, String player) |
|
||||||
{ |
|
||||||
return rscp.cache.userGetPrefix(player); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Get players prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @return Prefix |
|
||||||
*/ |
|
||||||
public String getPlayerSuffix(String world, String player) |
|
||||||
{ |
|
||||||
return rscp.cache.userGetSuffix(player); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Get player's prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @return Prefix |
|
||||||
*/ |
|
||||||
public String getGroupPrefix(String world, String group) |
|
||||||
{ |
|
||||||
return rscp.cache.groupGetPrefix(group); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Get players prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @return Prefix |
|
||||||
*/ |
|
||||||
public String getGroupSuffix(String world, String group) |
|
||||||
{ |
|
||||||
return rscp.cache.groupGetSuffix(group); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Set player's prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param prefix Prefix |
|
||||||
*/ |
|
||||||
public void setPlayerPrefix(String world, final String player, final String prefix) |
|
||||||
{ |
|
||||||
new Thread() |
|
||||||
{ |
|
||||||
@Override |
|
||||||
public void run() |
|
||||||
{ |
|
||||||
rscp.connectionList.updateEntityText(player, true, prefix, true); |
|
||||||
} |
|
||||||
}.start(); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Set player's prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param player Player name |
|
||||||
* @param suffix Suffix |
|
||||||
*/ |
|
||||||
public void setPlayerSuffix(String world, final String player, final String suffix) |
|
||||||
{ |
|
||||||
new Thread() |
|
||||||
{ |
|
||||||
@Override |
|
||||||
public void run() |
|
||||||
{ |
|
||||||
rscp.connectionList.updateEntityText(player, true, suffix, false); |
|
||||||
} |
|
||||||
}.start(); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Set group prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @param prefix Prefix |
|
||||||
*/ |
|
||||||
public void setGroupPrefix(String world, final String group, final String prefix) |
|
||||||
{ |
|
||||||
new Thread() |
|
||||||
{ |
|
||||||
@Override |
|
||||||
public void run() |
|
||||||
{ |
|
||||||
rscp.connectionList.updateEntityText(group, false, prefix, true); |
|
||||||
} |
|
||||||
}.start(); |
|
||||||
} |
|
||||||
/** |
|
||||||
* Vault chat support. |
|
||||||
* Set group prefix |
|
||||||
* |
|
||||||
* @param world World name |
|
||||||
* @param group Group name |
|
||||||
* @param suffix Suffix |
|
||||||
*/ |
|
||||||
public void setGroupSuffix(String world, final String group, final String suffix) |
|
||||||
{ |
|
||||||
new Thread() |
|
||||||
{ |
|
||||||
@Override |
|
||||||
public void run() |
|
||||||
{ |
|
||||||
rscp.connectionList.updateEntityText(group, false, suffix, false); |
|
||||||
} |
|
||||||
}.start(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if a CommandSender has a permission node. This will return the result of bukkits, generic .hasPermission() |
|
||||||
* method and is identical in all cases. This method will explicitly fail if the registered permission system does |
|
||||||
* not register permissions in bukkit. |
|
||||||
* |
|
||||||
* For easy checking of a commandsender |
|
||||||
* |
|
||||||
* @param sender to check permissions on |
|
||||||
* @param permission to check for |
|
||||||
* @return true if the sender has the permission |
|
||||||
*/ |
|
||||||
public boolean has(CommandSender sender, String permission) |
|
||||||
{ |
|
||||||
return sender.hasPermission(permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if player has a permission node. (Short for playerHas(...) |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean has(Player player, String permission) |
|
||||||
{ |
|
||||||
return player.hasPermission(permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if player has a permission node. Supports NULL value for World if the permission system registered supports |
|
||||||
* global permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world String world name |
|
||||||
* @param player to check |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerHas(String world, OfflinePlayer player, String permission) |
|
||||||
{ |
|
||||||
// SHOULD BE UPDATED
|
|
||||||
return playerHas(world, player.getName(), permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if player has a permission node. Defaults to world-specific permission check if the permission system |
|
||||||
* supports it. See {@link #playerHas(String, OfflinePlayer, String)} for explicit global or world checks. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerHas(Player player, String permission) |
|
||||||
{ |
|
||||||
return has(player, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add permission to a player. Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world String world name |
|
||||||
* @param player to add to |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAdd(String world, OfflinePlayer player, String permission) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return playerAdd((String)null, player.getName(), permission); |
|
||||||
return playerAdd(world, player.getName(), permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add permission to a player ONLY for the world the player is currently on. This is a world-specific operation, if |
|
||||||
* you want to add global permission you must explicitly use NULL for the world. See |
|
||||||
* {@link #playerAdd(String, OfflinePlayer, String)} for global permission use. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAdd(Player player, String permission) |
|
||||||
{ |
|
||||||
return playerAdd(player.getWorld().getName(), player, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add transient permission to a player. This implementation can be used by any subclass which implements a "pure" |
|
||||||
* superperms plugin, i.e. one that only needs the built-in Bukkit API to add transient permissions to a player. |
|
||||||
* |
|
||||||
* @param player to add to |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddTransient(OfflinePlayer player, String permission) throws UnsupportedOperationException |
|
||||||
{ |
|
||||||
if(player.isOnline()) |
|
||||||
return playerAddTransient((Player)player, permission); |
|
||||||
throw new UnsupportedOperationException("rscPermissions does not support offline player transient permissions!"); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add transient permission to a player. This operation adds a permission onto the player object in bukkit via |
|
||||||
* Bukkit's permission interface. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddTransient(Player player, String permission) |
|
||||||
{ |
|
||||||
for(PermissionAttachmentInfo paInfo : player.getEffectivePermissions()) |
|
||||||
if(paInfo.getAttachment() != null && paInfo.getAttachment().getPlugin().equals(rscp)) |
|
||||||
{ |
|
||||||
paInfo.getAttachment().setPermission(permission, true); |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
PermissionAttachment attach = player.addAttachment(rscp); |
|
||||||
attach.setPermission(permission, true); |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Adds a world specific transient permission to the player, may only work with some permission managers. Defaults to |
|
||||||
* GLOBAL permissions for any permission system that does not support world-specific transient permissions! |
|
||||||
* |
|
||||||
* @param worldName to check on |
|
||||||
* @param player to add to |
|
||||||
* @param permission to test |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddTransient(String worldName, OfflinePlayer player, String permission) |
|
||||||
{ |
|
||||||
return false; |
|
||||||
// return playerAddTransient(worldName, player.getName(), permission);
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Adds a world specific transient permission to the player, may only work with some permission managers. Defaults to |
|
||||||
* GLOBAL permissions for any permission system that does not support world-specific transient permissions! |
|
||||||
* |
|
||||||
* @param worldName to check on |
|
||||||
* @param player to check |
|
||||||
* @param permission to check for |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddTransient(String worldName, Player player, String permission) |
|
||||||
{ |
|
||||||
return playerAddTransient(player, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Removes a world specific transient permission from the player, may only work with some permission managers. |
|
||||||
* Defaults to GLOBAL permissions for any permission system that does not support world-specific transient |
|
||||||
* permissions! |
|
||||||
* |
|
||||||
* @param worldName to remove for |
|
||||||
* @param player to remove for |
|
||||||
* @param permission to remove |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveTransient(String worldName, OfflinePlayer player, String permission) |
|
||||||
{ |
|
||||||
return false; |
|
||||||
// return playerRemoveTransient(worldName, player.getName(), permission);
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Removes a world specific transient permission from the player, may only work with some permission managers. |
|
||||||
* Defaults to GLOBAL permissions for any permission system that does not support world-specific transient |
|
||||||
* permissions! |
|
||||||
* |
|
||||||
* @param worldName to check on |
|
||||||
* @param player to check |
|
||||||
* @param permission to check for |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveTransient(String worldName, Player player, String permission) |
|
||||||
{ |
|
||||||
return playerRemoveTransient(worldName, (OfflinePlayer)player, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove permission from a player. Will attempt to remove permission from the player on the player's current world. |
|
||||||
* This is NOT a global operation. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemove(Player player, String permission) |
|
||||||
{ |
|
||||||
return false; |
|
||||||
// return playerRemove(player.getWorld().getName(), player, permission);
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove transient permission from a player. This implementation can be used by any subclass which implements a |
|
||||||
* "pure" superperms plugin, i.e. one that only needs the built-in Bukkit API to remove transient permissions from a |
|
||||||
* player. Any subclass implementing a plugin which provides its own API for this needs to override this method. |
|
||||||
* |
|
||||||
* @param player OfflinePlayer |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveTransient(OfflinePlayer player, String permission) |
|
||||||
{ |
|
||||||
if(player.isOnline()) |
|
||||||
return playerRemoveTransient((Player)player, permission); |
|
||||||
else |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove transient permission from a player. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveTransient(Player player, String permission) |
|
||||||
{ |
|
||||||
for(PermissionAttachmentInfo paInfo : player.getEffectivePermissions()) |
|
||||||
if(paInfo.getAttachment() != null && paInfo.getAttachment().getPlugin().equals(rscp)) |
|
||||||
{ |
|
||||||
paInfo.getAttachment().unsetPermission(permission); |
|
||||||
return true; |
|
||||||
} |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if group has a permission node. Supports NULL value for World if the permission system registered supports |
|
||||||
* global permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world World Object |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupHas(World world, String group, String permission) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return groupHas((String)null, group, permission); |
|
||||||
return groupHas(world.getName(), group, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add permission to a group. Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world World Object |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupAdd(World world, String group, String permission) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return groupAdd((String)null, group, permission); |
|
||||||
return groupAdd(world.getName(), group, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove permission from a group. Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world World Object |
|
||||||
* @param group Group name |
|
||||||
* @param permission Permission node |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean groupRemove(World world, String group, String permission) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return groupRemove((String)null, group, permission); |
|
||||||
return groupRemove(world.getName(), group, permission); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Check if player is member of a group. Supports NULL value for World if the permission system registered supports |
|
||||||
* global permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world World Object |
|
||||||
* @param player to check |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerInGroup(String world, OfflinePlayer player, String group) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return playerInGroup((String)null, player.getName(), group); |
|
||||||
return playerInGroup(world, player.getName(), group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Check if player is member of a group. This method will ONLY check groups for which the player is in that are |
|
||||||
* defined for the current world. This may result in odd return behaviour depending on what permission system has |
|
||||||
* been registered. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerInGroup(Player player, String group) |
|
||||||
{ |
|
||||||
return playerInGroup(player.getWorld().getName(), player, group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add player to a group. Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world String world name |
|
||||||
* @param player to add |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddGroup(String world, OfflinePlayer player, String group) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return playerAddGroup((String)null, player.getName(), group); |
|
||||||
return playerAddGroup(world, player.getName(), group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Add player to a group. This will add a player to the group on the current World. This may return odd results if |
|
||||||
* the permission system being used on the server does not support world-specific groups, or if the group being added |
|
||||||
* to is a global group. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerAddGroup(Player player, String group) |
|
||||||
{ |
|
||||||
return playerAddGroup(player.getWorld().getName(), player, group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove player from a group. Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world World Object |
|
||||||
* @param player to remove |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveGroup(String world, OfflinePlayer player, String group) |
|
||||||
{ |
|
||||||
if(world == null) |
|
||||||
return playerRemoveGroup((String)null, player.getName(), group); |
|
||||||
return playerRemoveGroup(world, player.getName(), group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Remove player from a group. This will add a player to the group on the current World. This may return odd results |
|
||||||
* if the permission system being used on the server does not support world-specific groups, or if the group being |
|
||||||
* added to is a global group. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @param group Group name |
|
||||||
* @return Success or Failure |
|
||||||
*/ |
|
||||||
public boolean playerRemoveGroup(Player player, String group) |
|
||||||
{ |
|
||||||
return playerRemoveGroup(player.getWorld().getName(), player, group); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the list of groups that this player has Supports NULL value for World if the permission system registered |
|
||||||
* supports global permissions. But May return odd values if the servers registered permission system does not have a |
|
||||||
* global permission store. |
|
||||||
* |
|
||||||
* @param world String world name |
|
||||||
* @param player OfflinePlayer |
|
||||||
* @return Array of groups |
|
||||||
*/ |
|
||||||
public String[] getPlayerGroups(String world, OfflinePlayer player) |
|
||||||
{ |
|
||||||
return getPlayerGroups(world, player.getName()); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns a list of world-specific groups that this player is currently in. May return unexpected results if you are |
|
||||||
* looking for global groups, or if the registered permission system does not support world-specific groups. See |
|
||||||
* {@link #getPlayerGroups(String, OfflinePlayer)} for better control of World-specific or global groups. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @return Array of groups |
|
||||||
*/ |
|
||||||
public String[] getPlayerGroups(Player player) |
|
||||||
{ |
|
||||||
return getPlayerGroups(player.getWorld().getName(), player); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets players primary group Supports NULL value for World if the permission system registered supports global |
|
||||||
* permissions. But May return odd values if the servers registered permission system does not have a global |
|
||||||
* permission store. |
|
||||||
* |
|
||||||
* @param world String world name |
|
||||||
* @param player to get from |
|
||||||
* @return Players primary group |
|
||||||
*/ |
|
||||||
public String getPrimaryGroup(String world, OfflinePlayer player) |
|
||||||
{ |
|
||||||
return getPrimaryGroup(world, player.getName()); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get players primary group. Defaults to the players current world, so may return only world-specific groups. In |
|
||||||
* most cases {@link #getPrimaryGroup(String, OfflinePlayer)} is preferable. |
|
||||||
* |
|
||||||
* @param player Player Object |
|
||||||
* @return Players primary group |
|
||||||
*/ |
|
||||||
public String getPrimaryGroup(Player player) |
|
||||||
{ |
|
||||||
return getPrimaryGroup(player.getWorld().getName(), player); |
|
||||||
} |
|
||||||
} |
|
||||||
Loading…
Reference in new issue