Merge branch 'feature/inventory' into develop

Author: 0ddlyoko

src/main/java/com/froxynetwork/froxyapi/API.java

@@ -4,11 +4,15 @@
 import java.util.List;
 
 import org.bukkit.Server;
+import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.slf4j.Logger;
 
 import com.froxynetwork.froxyapi.command.Command;
 import com.froxynetwork.froxyapi.command.CommandManager;
+import com.froxynetwork.froxyapi.inventory.Inventory;
+import com.froxynetwork.froxyapi.inventory.InventoryManager;
+import com.froxynetwork.froxyapi.inventory.InventoryProvider;
 import com.froxynetwork.froxyapi.language.LanguageManager;
 import com.froxynetwork.froxyapi.language.Languages;
 
@@ -86,7 +90,8 @@ public default Languages getDefaultLanguage() {
 	 * Files name MUST be of this form: "{name}.lang".<br />
 	 * Example: <code>fr_FR.lang or en_US.lang</code>
 	 * 
-	 * @param path The directory
+	 * @param path
+	 *            The directory
 	 */
 	public default void register(File path) {
 		getLanguageManager().register(path);
@@ -96,21 +101,29 @@ public default void register(File path) {
 	 * Get the default translate of specific message id.<br />
 	 * Same as <code>$(id, getDefaultLanguage(), params)</code>
 	 * 
-	 * @param id The id of the message
-	 * @param params The parameters
-	 * @return The message translated by default language, or the id if message id doesn't exist
+	 * @param id
+	 *            The id of the message
+	 * @param params
+	 *            The parameters
+	 * @return The message translated by default language, or the id if message id
+	 *         doesn't exist
 	 */
 	public default String $(String id, String... params) {
 		return getLanguageManager().$(id, params);
 	}
 
 	/**
-	 * Get the translation of specific message id with specific language. If message id not found, return the translation with DEFAULT language
+	 * Get the translation of specific message id with specific language. If message
+	 * id not found, return the translation with DEFAULT language
 	 * 
-	 * @param id The id of the message
-	 * @param lang The specific language
-	 * @param params The parameters
-	 * @return The message translated by specific language, or the message translated by default language, or the id if message id doesn't exist
+	 * @param id
+	 *            The id of the message
+	 * @param lang
+	 *            The specific language
+	 * @param params
+	 *            The parameters
+	 * @return The message translated by specific language, or the message
+	 *         translated by default language, or the id if message id doesn't exist
 	 */
 	public default String $(String id, Languages lang, String... params) {
 		return getLanguageManager().$(id, lang, params);
@@ -119,22 +132,25 @@ public default void register(File path) {
 	/**
 	 * Get the translate of specific id with specific language
 	 * 
-	 * @param id The id of the message
-	 * @param lang The specific language
-	 * @param params The parameters
-	 * @return The message translated by specific language, or the id if message id doesn't exist
+	 * @param id
+	 *            The id of the message
+	 * @param lang
+	 *            The specific language
+	 * @param params
+	 *            The parameters
+	 * @return The message translated by specific language, or the id if message id
+	 *         doesn't exist
 	 */
 	public default String $_(String id, Languages lang, String... params) {
 		return getLanguageManager().$_(id, lang, params);
 	}
-	
 
 	// -----------------------------------------
 	// |                                       |
 	// |            Command Manager            |
 	// |                                       |
 	// -----------------------------------------
-	
+
 	/**
 	 * @return The CommandManager
 	 */
@@ -169,8 +185,55 @@ public default List<Command> getCommands() {
 
 	// -----------------------------------------
 	// |                                       |
-	// |                 Other                 |
+	// |          Inventory Manager            |
 	// |                                       |
 	// -----------------------------------------
 
+	/**
+	 * @return The InventoryManager
+	 */
+	public InventoryManager getInventoryManager();
+
+	/**
+	 * Create an Inventory and open it
+	 * 
+	 * @param provider
+	 *            The provider
+	 * @param player
+	 *            The player
+	 * @return An inventory
+	 */
+	public default Inventory openInventory(InventoryProvider provider, Player player) {
+		return getInventoryManager().openInventory(provider, player);
+	}
+
+	/**
+	 * @param p
+	 *            Player to check
+	 * 
+	 * @return true if specific Player has an opened inventory
+	 */
+	public default boolean hasInventoryOpened(Player p) {
+		return getInventoryManager().hasInventoryOpened(p);
+	}
+
+	/**
+	 * @param p
+	 *            Specific player
+	 * @return The inventory of specific Player. Null if not opened
+	 */
+	public default Inventory getInventory(Player p) {
+		return getInventoryManager().getInventory(p);
+	}
+
+	/**
+	 * Close player's inventory.<br />
+	 * Same as <code>p.closeInventory();</code>
+	 * 
+	 * @param p
+	 *            The player
+	 */
+	public default void closeInventory(Player p) {
+		getInventoryManager().closeInventory(p);
+	}
 }

src/main/java/com/froxynetwork/froxyapi/Froxy.java

@@ -3,11 +3,15 @@
 import java.io.File;
 import java.util.List;
 
+import org.bukkit.entity.Player;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.slf4j.Logger;
 
 import com.froxynetwork.froxyapi.command.Command;
 import com.froxynetwork.froxyapi.command.CommandManager;
+import com.froxynetwork.froxyapi.inventory.Inventory;
+import com.froxynetwork.froxyapi.inventory.InventoryManager;
+import com.froxynetwork.froxyapi.inventory.InventoryProvider;
 import com.froxynetwork.froxyapi.language.LanguageManager;
 import com.froxynetwork.froxyapi.language.Languages;
 
@@ -208,7 +212,57 @@ public static List<Command> getCommands() {
 
 	// -----------------------------------------
 	// |                                       |
-	// |                 Other                 |
+	// |          Inventory Manager            |
 	// |                                       |
 	// -----------------------------------------
+
+	/**
+	 * @return The InventoryManager
+	 */
+	public static InventoryManager getInventoryManager() {
+		return api.getInventoryManager();
+	}
+
+	/**
+	 * Create an Inventory and open it
+	 * 
+	 * @param provider
+	 *            The provider
+	 * @param player
+	 *            The player
+	 * @return An inventory
+	 */
+	public static Inventory openInventory(InventoryProvider provider, Player player) {
+		return api.openInventory(provider, player);
+	}
+
+	/**
+	 * @param p
+	 *            Player to check
+	 * 
+	 * @return true if specific Player has an opened inventory
+	 */
+	public static boolean hasInventoryOpened(Player p) {
+		return api.hasInventoryOpened(p);
+	}
+
+	/**
+	 * @param p
+	 *            Specific player
+	 * @return The inventory of specific Player. Null if not opened
+	 */
+	public static Inventory getInventory(Player p) {
+		return api.getInventory(p);
+	}
+
+	/**
+	 * Close player's inventory.<br />
+	 * Same as <code>p.closeInventory();</code>
+	 * 
+	 * @param p
+	 *            The player
+	 */
+	public static void closeInventory(Player p) {
+		api.closeInventory(p);
+	}
 }

src/main/java/com/froxynetwork/froxyapi/inventory/ClickableItem.java

@@ -0,0 +1,60 @@
+package com.froxynetwork.froxyapi.inventory;
+
+import java.util.function.Consumer;
+
+import org.bukkit.event.inventory.InventoryClickEvent;
+import org.bukkit.inventory.ItemStack;
+
+import lombok.Getter;
+
+/**
+ * MIT License
+ *
+ * Copyright (c) 2019 FroxyNetwork
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ * 
+ * @author 0ddlyoko
+ */
+/**
+ * An item that is clickable in the Inventory
+ */
+public class ClickableItem {
+	@Getter
+	private ItemStack item;
+	private Consumer<InventoryClickEvent> event;
+
+	private ClickableItem(ItemStack item, Consumer<InventoryClickEvent> event) {
+		this.item = item;
+		this.event = event;
+	}
+
+	public void run(InventoryClickEvent e) {
+		event.accept(e);
+	}
+
+	public static ClickableItem of(ItemStack is) {
+		return new ClickableItem(is, e -> {
+		});
+	}
+
+	public static ClickableItem of(ItemStack is, Consumer<InventoryClickEvent> event) {
+		return new ClickableItem(is, event);
+	}
+}