BetterShardsAPI.java

package vg.civcraft.mc.bettershards;

import java.util.UUID;

import org.bukkit.configuration.ConfigurationSection;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;

import vg.civcraft.mc.bettershards.events.PlayerChangeServerReason;
import vg.civcraft.mc.bettershards.external.MercuryManager;
import vg.civcraft.mc.bettershards.misc.BedLocation;
import vg.civcraft.mc.bettershards.misc.CustomWorldNBTStorage;
import vg.civcraft.mc.bettershards.misc.PlayerStillDeadException;
import vg.civcraft.mc.bettershards.misc.TeleportInfo;
import vg.civcraft.mc.bettershards.portal.Portal;

public class BetterShardsAPI {
	
	/**
	 * Teleports a player to a different shard.
	 * @param p The Player that you wish to connect.
	 * @param serverName The name of the server that you wish the player to be sent to.
	 * @param reason The reason to be identified by the PlayerChangeServerEvent triggered by this method.
	 * @throws PlayerStillDeadException If the player is dead than this exception is thrown. There are issues with trying
	 * to teleport a dead player.  If calling from PlayerRespawnEvent just schedule a sync method to occur after the event.
	 */
	public static boolean connectPlayer(Player p, String serverName, PlayerChangeServerReason reason) throws PlayerStillDeadException {
		return BetterShardsPlugin.getConnectionManager().teleportPlayerToServer(p, serverName, reason);
	}
	
	/**
	 * Teleports a player to a different shard.
	 * @param p The UUID of the Player that you wish to connect.
	 * @param serverName The name of the server that you wish the player to be sent to.
	 * @param reason The reason to be identified by the PlayerChangeServerEvent triggered by this method.
	 * @throws PlayerStillDeadException If the player is dead than this exception is thrown. There are issues with trying
	 * to teleport a dead player.  If calling from PlayerRespawnEvent just schedule a sync method to occur after the event.
	 */
	public static boolean connectPlayer(UUID p, String serverName, PlayerChangeServerReason reason) throws PlayerStillDeadException {
		return BetterShardsPlugin.getConnectionManager().teleportPlayerToServer(p, serverName, reason);
	}
	
	/**
	 * Teleports the specified player to the current server.
	 * @param uuid The name of said player.
	 */
	public static void requestPlayerTeleport(String name) {
		BetterShardsPlugin.getConnectionManager().teleportOtherServerPlayer(name);
	}
	
	/**
	 * Teleports a player to a different shard.
	 * @param p The Player that you wish to connect.
	 * @param portal The portal that the player should be teleported to.
	 * @param reason The reason to be identified by the PlayerChangeServerEvent triggered by this method.
	 * @param data Additional data provided for the teleport
	 * @throws PlayerStillDeadException If the player is dead than this exception is thrown. There are issues with trying
	 * to teleport a dead player.  If calling from PlayerRespawnEvent just schedule a sync method to occur after the event.
	 */
	public static boolean connectPlayer(Player p, Portal portal, PlayerChangeServerReason reason, Object ... data) throws PlayerStillDeadException {
		if (BetterShardsPlugin.getConnectionManager().teleportPlayerToServer(p, portal.getServerName(), reason)) {
			MercuryManager.teleportPlayer(p.getUniqueId(), portal, data); // We want to do this after because we don't know if a player was teleported yet.
			return true;
		}
		return false;
	}

	public static String getServerName() {
		return BetterShardsPlugin.getCurrentServerName();
	}
	
	/**
	 * Checks if a player has a bed.
	 * @param uuid
	 * @return Returns true if player has one, false otherwise.
	 */
	public static boolean hasBed(UUID uuid) {
		return BetterShardsPlugin.getBedManager().getBed(uuid) != null;
	}
	
	public static BedLocation getBedLocation(UUID uuid) {
		return BetterShardsPlugin.getBedManager().getBed(uuid);
	}
	
	/**
	 * Adds the BedLocation to both the db and to localcaching as well as sending it
	 * to other servers.  This method will also remove any prexisting beds.
	 * @param uuid The uuid of the player getting the bed.
	 * @param bed The BedLocation object.
	 */
	public static void addBedLocation(UUID uuid, BedLocation bed) {
		removeBedLocation(bed);
		BetterShardsPlugin.getBedManager().addBedLocation(uuid, bed);
		BetterShardsPlugin.getDatabaseManager().addBedLocation(bed);
		MercuryManager.sendBedLocation(bed);
	}
	
	public static void removeBedLocation(BedLocation bed) {
		BetterShardsPlugin.getBedManager().removeBed(bed.getUUID());
		BetterShardsPlugin.getDatabaseManager().removeBed(bed.getUUID());
		MercuryManager.removeBedLocation(bed);
	}
	
	/**
	 * Sends the info to servers that a player needs to be teleported.
	 * @param server The server to teleport the player to.
	 * @param uuid The uuid of the player to teleport.
	 * @param info Create a TeleportInfo object to pass.
	 * world can be either the world name or world uuid.
	 */
	public static void teleportPlayer(String server, UUID uuid, TeleportInfo info) {
		MercuryManager.teleportPlayer(server, uuid, info);
	}
	
	/**
	 * RandomSpawns a player on the server
	 * @param server the server to randomspawn the player on
	 * @param player the player to randomspawn
	 */	
	public static void randomSpawnPlayer(String server, UUID player) {
		try {
			connectPlayer(player, server, PlayerChangeServerReason.RANDOMSPAWN);
		} catch (PlayerStillDeadException e) {
			e.printStackTrace();
		}
		MercuryManager.notifyRandomSpawn(server, player);
	}
	
	/**
	 * To make cross shard integration of other plugins easier, BetterShards allows those to store data in the form of yaml configuration
	 * sections together with player data. It will automatically get saved when the player switches to another shard and get loaded on there.
	 * 
	 * @param plugin Plugin for which data should be saved
	 * @param uuid UUID of the player for whom data should be saved
	 * 
	 * @return ConfigurationSection object, which can be edited and read as needed
	 */
	public static ConfigurationSection getConfigurationSection(JavaPlugin plugin, UUID uuid) {
		return CustomWorldNBTStorage.getWorldNBTStorage().getConfigurationSection(uuid, plugin);
	}
	
	/**
	 * Registers a portal with BetterShards.
	 * This should be called for every custom portal you have.
	 * @param plugin_id The plugin specific id that your portal uses.
	 * @param plugin The plugin that is registering this portal.
	 * @param portal The portal Class.
	 * @param name The name of the portalType that will show up to players.
	 */
	public static <E extends Portal> void registerPortal(int plugin_id, String plugin, Class<E> portal, String name) {
		BetterShardsPlugin.getDatabaseManager().addPortalType(plugin_id, plugin);
		// Now we get the generated id from bettershards.
		int real_id = BetterShardsPlugin.getDatabaseManager().getPortalID(plugin, plugin_id);
		BetterShardsPlugin.getPortalManager().getPortalFactory().registerPortal(real_id, portal, name);
	}
	
	public static int getPortalID(int pluginId, String plugin) {
		return BetterShardsPlugin.getDatabaseManager().getPortalID(plugin, pluginId);
	}
}