Package com.github.stefvanschie.inventoryframework.gui.type.util

Class Gui

java.lang.Object
com.github.stefvanschie.inventoryframework.gui.type.util.Gui
Direct Known Subclasses:
BeaconGui, NamedGui
public abstract class Gui extends Object
The base class of all GUIs

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    protected @NotNull HumanEntityCache
    humanEntityCache
    A player cache for storing player's inventories
    protected org.bukkit.inventory.Inventory
    inventory
    The inventory of this gui
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent>
    onBottomClick
    The consumer that will be called once a players clicks in the bottom-half of the gui
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent>
    onBottomDrag
    The consumer that will be called once a player drags in the bottom-half of the gui
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryCloseEvent>
    onClose
    The consumer that will be called once a player closes the gui
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent>
    onGlobalClick
    The consumer that will be called once a players clicks in the gui or in their inventory
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent>
    onGlobalDrag
    The consumer that will be called once a player drags in the gui or their inventory
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent>
    onOutsideClick
    The consumer that will be called once a player clicks outside of the gui screen
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent>
    onTopClick
    The consumer that will be called once a players clicks in the top-half of the gui
    protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent>
    onTopDrag
    The consumer that will be called once a player drags in the top-half of the gui

  • Constructor Summary

    Constructors
    Constructor
    Description
    Gui()
    Constructs a new GUI
    Gui​(@NotNull org.bukkit.plugin.java.JavaPlugin plugin)
    Constructs a new gui with the provided plugin.

  • Method Summary

    Modifier and Type
    Method
    Description
    protected void
    addInventory​(@NotNull org.bukkit.inventory.Inventory inventory, @NotNull Gui gui)
    Adds the specified inventory and gui, so we can properly intercept clicks.
    void
    callOnBottomClick​(@NotNull org.bukkit.event.inventory.InventoryClickEvent event)
    Calls the consumer (if it's not null) that was specified using setOnBottomClick(Consumer), so the consumer that should be called whenever the inventory is clicked in.
    void
    callOnBottomDrag​(@NotNull org.bukkit.event.inventory.InventoryDragEvent event)
    Calls the consumer (if it's not null) that was specified using setOnBottomDrag(Consumer), so the consumer that should be called whenever the inventory is dragged in.
    void
    callOnClose​(@NotNull org.bukkit.event.inventory.InventoryCloseEvent event)
    Calls the consumer (if it's not null) that was specified using setOnClose(Consumer), so the consumer that should be called whenever this gui is closed.
    void
    callOnGlobalClick​(@NotNull org.bukkit.event.inventory.InventoryClickEvent event)
    Calls the consumer (if it's not null) that was specified using setOnGlobalClick(Consumer), so the consumer that should be called whenever this gui or inventory is clicked in.
    void
    callOnGlobalDrag​(@NotNull org.bukkit.event.inventory.InventoryDragEvent event)
    Calls the consumer (if it's not null) that was specified using setOnGlobalDrag(Consumer), so the consumer that should be called whenever this gui or inventory is dragged in.
    void
    callOnOutsideClick​(@NotNull org.bukkit.event.inventory.InventoryClickEvent event)
    Calls the consumer (if it's not null) that was specified using setOnOutsideClick(Consumer), so the consumer that should be called whenever a player clicks outside the gui.
    void
    callOnTopClick​(@NotNull org.bukkit.event.inventory.InventoryClickEvent event)
    Calls the consumer (if it's not null) that was specified using setOnTopClick(Consumer), so the consumer that should be called whenever this gui is clicked in.
    void
    callOnTopDrag​(@NotNull org.bukkit.event.inventory.InventoryDragEvent event)
    Calls the consumer (if it's not null) that was specified using setOnTopDrag(Consumer), so the consumer that should be called whenever this gui's top half is dragged in.
    abstract void
    click​(@NotNull org.bukkit.event.inventory.InventoryClickEvent event)
    This should delegate the provided inventory click event to the right pane, which can then handle this click event further.
    abstract @NotNull Gui
    copy()
    Makes a copy of this gui and returns it.
    static @Nullable Gui
    getGui​(@NotNull org.bukkit.inventory.Inventory inventory)
    Gets a gui from the specified inventory.
    @NotNull HumanEntityCache
    getHumanEntityCache()
    Gets the human entity cache used for this gui
    abstract int
    getViewerCount()
    Gets the count of HumanEntity instances that are currently viewing this GUI.
    abstract @NotNull List<org.bukkit.entity.HumanEntity>
    getViewers()
    Gets a mutable snapshot of the current HumanEntity viewers of this GUI.
    protected void
    initializeOrThrow​(@NotNull Object instance, @NotNull Element element)
    Initializes standard fields from a Gui from a given input stream.
    abstract boolean
    isPlayerInventoryUsed()
    Gets whether the player inventory is currently in use.
    boolean
    isUpdating()
    Gets whether this gui is being updated, as invoked by update().
    static @Nullable Gui
    load​(@NotNull Object instance, @NotNull InputStream inputStream)
    Loads a Gui from a given input stream.
    static @NotNull Pane
    loadPane​(@NotNull Object instance, @NotNull Node node)
    Loads a pane by the given instance and node
    static void
    registerGui​(@NotNull String name, @NotNull BiFunction<? super Object,​? super Element,​? extends Gui> biFunction)
    Registers a type that can be used inside an XML file to specify the gui type
    static void
    registerPane​(@NotNull String name, @NotNull BiFunction<Object,​Element,​Pane> biFunction)
    Registers a name that can be used inside an XML file to add custom panes
    static void
    registerProperty​(@NotNull String attributeName, @NotNull Function<String,​Object> function)
    Registers a property that can be used inside an XML file to add additional new properties.
    void
    setOnBottomClick​(@Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onBottomClick)
    Set the consumer that should be called whenever the inventory is clicked in.
    void
    setOnBottomDrag​(@Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onBottomDrag)
    Set the consumer that should be called whenever the inventory is dragged in.
    void
    setOnClose​(@Nullable Consumer<org.bukkit.event.inventory.InventoryCloseEvent> onClose)
    Set the consumer that should be called whenever this gui is closed.
    void
    setOnGlobalClick​(@Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onGlobalClick)
    Set the consumer that should be called whenever this gui or inventory is clicked in.
    void
    setOnGlobalDrag​(@Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onGlobalDrag)
    Set the consumer that should be called whenever this gui or inventory is dragged in.
    void
    setOnOutsideClick​(@Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onOutsideClick)
    Set the consumer that should be called whenever a player clicks outside the gui.
    void
    setOnTopClick​(@Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onTopClick)
    Set the consumer that should be called whenever this gui is clicked in.
    void
    setOnTopDrag​(@Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onTopDrag)
    Set the consumer that should be called whenever this gui's top half is dragged in.
    abstract void
    show​(@NotNull org.bukkit.entity.HumanEntity humanEntity)
    Shows a gui to a player
    void
    update()
    Update the gui for everyone

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

    • inventory

      protected org.bukkit.inventory.Inventory inventory
      The inventory of this gui

    • humanEntityCache

      @NotNull protected final @NotNull HumanEntityCache humanEntityCache
      A player cache for storing player's inventories

    • onTopClick

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onTopClick
      The consumer that will be called once a players clicks in the top-half of the gui

    • onBottomClick

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onBottomClick
      The consumer that will be called once a players clicks in the bottom-half of the gui

    • onGlobalClick

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onGlobalClick
      The consumer that will be called once a players clicks in the gui or in their inventory

    • onOutsideClick

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onOutsideClick
      The consumer that will be called once a player clicks outside of the gui screen

    • onTopDrag

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onTopDrag
      The consumer that will be called once a player drags in the top-half of the gui

    • onBottomDrag

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onBottomDrag
      The consumer that will be called once a player drags in the bottom-half of the gui

    • onGlobalDrag

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onGlobalDrag
      The consumer that will be called once a player drags in the gui or their inventory

    • onClose

      @Nullable protected @Nullable Consumer<org.bukkit.event.inventory.InventoryCloseEvent> onClose
      The consumer that will be called once a player closes the gui

  • Constructor Details

  • Method Details

    • show

      public abstract void show​(@NotNull @NotNull org.bukkit.entity.HumanEntity humanEntity)
      Shows a gui to a player
      Parameters:
      humanEntity - the human entity to show the gui to

    • copy

      @NotNull @Contract(pure=true) public abstract @NotNull Gui copy()
      Makes a copy of this gui and returns it. This makes a deep copy of the gui. This entails that the underlying panes will be copied as per their Pane.copy() and miscellaneous data will be copied. The copy of this gui, will however have no viewers even if this gui currently has viewers. With this, cache data for viewers will also be non-existent for the copied gui. The returned gui will never be reference equal to the current gui.
      Returns:
      a copy of the gui
      Since:
      0.6.2

    • click

      public abstract void click​(@NotNull @NotNull org.bukkit.event.inventory.InventoryClickEvent event)
      This should delegate the provided inventory click event to the right pane, which can then handle this click event further. This should not call any internal click handlers, since those will already have been activated.
      Parameters:
      event - the event to delegate
      Since:
      0.8.0

    • isPlayerInventoryUsed

      public abstract boolean isPlayerInventoryUsed()
      Gets whether the player inventory is currently in use. This means whether the player inventory currently has an item in it.
      Returns:
      true if the player inventory is occupied, false otherwise
      Since:
      0.8.0

    • getViewerCount

      @Contract(pure=true) public abstract int getViewerCount()
      Gets the count of HumanEntity instances that are currently viewing this GUI.
      Returns:
      the count of viewers
      Since:
      0.5.19

    • getViewers

      @NotNull @Contract(pure=true) public abstract @NotNull List<org.bukkit.entity.HumanEntity> getViewers()
      Gets a mutable snapshot of the current HumanEntity viewers of this GUI. This is a snapshot (copy) and not a view, therefore modifications aren't visible.
      Returns:
      a snapshot of the current viewers
      Since:
      0.5.19
      See Also:
      getViewerCount()

    • update

      public void update()
      Update the gui for everyone

    • addInventory

      protected void addInventory​(@NotNull @NotNull org.bukkit.inventory.Inventory inventory, @NotNull @NotNull Gui gui)
      Adds the specified inventory and gui, so we can properly intercept clicks.
      Parameters:
      inventory - the inventory for the specified gui
      gui - the gui belonging to the specified inventory
      Since:
      0.8.1

    • getGui

      @Nullable @Contract(pure=true) public static @Nullable Gui getGui​(@NotNull @NotNull org.bukkit.inventory.Inventory inventory)
      Gets a gui from the specified inventory. Only guis of type beacon, brewing stand, dispenser, dropper, furnace and hopper can be retrieved.
      Parameters:
      inventory - the inventory to get the gui from
      Returns:
      the gui or null if the inventory doesn't have an accompanying gui
      Since:
      0.8.1

    • getHumanEntityCache

      @NotNull @Contract(pure=true) public @NotNull HumanEntityCache getHumanEntityCache()
      Gets the human entity cache used for this gui
      Returns:
      the human entity cache
      Since:
      0.5.4
      See Also:
      HumanEntityCache

    • load

      @Nullable public static @Nullable Gui load​(@NotNull @NotNull Object instance, @NotNull @NotNull InputStream inputStream)
      Loads a Gui from a given input stream. Returns null instead of throwing an exception in case of a failure.
      Parameters:
      instance - the class instance for all reflection lookups
      inputStream - the file
      Returns:
      the gui or null if the loading failed

    • initializeOrThrow

      protected void initializeOrThrow​(@NotNull @NotNull Object instance, @NotNull @NotNull Element element)
      Initializes standard fields from a Gui from a given input stream. Throws a RuntimeException instead of returning null in case of a failure.
      Parameters:
      instance - the class instance for all reflection lookups
      element - the gui element
      See Also:
      load(Object, InputStream)

    • setOnTopClick

      public void setOnTopClick​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onTopClick)
      Set the consumer that should be called whenever this gui is clicked in.
      Parameters:
      onTopClick - the consumer that gets called

    • callOnTopClick

      public void callOnTopClick​(@NotNull @NotNull org.bukkit.event.inventory.InventoryClickEvent event)
      Calls the consumer (if it's not null) that was specified using setOnTopClick(Consumer), so the consumer that should be called whenever this gui is clicked in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • setOnBottomClick

      public void setOnBottomClick​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onBottomClick)
      Set the consumer that should be called whenever the inventory is clicked in.
      Parameters:
      onBottomClick - the consumer that gets called

    • callOnBottomClick

      public void callOnBottomClick​(@NotNull @NotNull org.bukkit.event.inventory.InventoryClickEvent event)
      Calls the consumer (if it's not null) that was specified using setOnBottomClick(Consumer), so the consumer that should be called whenever the inventory is clicked in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • setOnGlobalClick

      public void setOnGlobalClick​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onGlobalClick)
      Set the consumer that should be called whenever this gui or inventory is clicked in.
      Parameters:
      onGlobalClick - the consumer that gets called

    • callOnGlobalClick

      public void callOnGlobalClick​(@NotNull @NotNull org.bukkit.event.inventory.InventoryClickEvent event)
      Calls the consumer (if it's not null) that was specified using setOnGlobalClick(Consumer), so the consumer that should be called whenever this gui or inventory is clicked in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • setOnOutsideClick

      public void setOnOutsideClick​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryClickEvent> onOutsideClick)
      Set the consumer that should be called whenever a player clicks outside the gui.
      Parameters:
      onOutsideClick - the consumer that gets called
      Since:
      0.5.7

    • callOnOutsideClick

      public void callOnOutsideClick​(@NotNull @NotNull org.bukkit.event.inventory.InventoryClickEvent event)
      Calls the consumer (if it's not null) that was specified using setOnOutsideClick(Consumer), so the consumer that should be called whenever a player clicks outside the gui. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • setOnTopDrag

      public void setOnTopDrag​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onTopDrag)
      Set the consumer that should be called whenever this gui's top half is dragged in.
      Parameters:
      onTopDrag - the consumer that gets called
      Since:
      0.9.0

    • callOnTopDrag

      public void callOnTopDrag​(@NotNull @NotNull org.bukkit.event.inventory.InventoryDragEvent event)
      Calls the consumer (if it's not null) that was specified using setOnTopDrag(Consumer), so the consumer that should be called whenever this gui's top half is dragged in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.9.0

    • setOnBottomDrag

      public void setOnBottomDrag​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onBottomDrag)
      Set the consumer that should be called whenever the inventory is dragged in.
      Parameters:
      onBottomDrag - the consumer that gets called
      Since:
      0.9.0

    • callOnBottomDrag

      public void callOnBottomDrag​(@NotNull @NotNull org.bukkit.event.inventory.InventoryDragEvent event)
      Calls the consumer (if it's not null) that was specified using setOnBottomDrag(Consumer), so the consumer that should be called whenever the inventory is dragged in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.9.0

    • setOnGlobalDrag

      public void setOnGlobalDrag​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryDragEvent> onGlobalDrag)
      Set the consumer that should be called whenever this gui or inventory is dragged in.
      Parameters:
      onGlobalDrag - the consumer that gets called
      Since:
      0.9.0

    • callOnGlobalDrag

      public void callOnGlobalDrag​(@NotNull @NotNull org.bukkit.event.inventory.InventoryDragEvent event)
      Calls the consumer (if it's not null) that was specified using setOnGlobalDrag(Consumer), so the consumer that should be called whenever this gui or inventory is dragged in. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • setOnClose

      public void setOnClose​(@Nullable @Nullable Consumer<org.bukkit.event.inventory.InventoryCloseEvent> onClose)
      Set the consumer that should be called whenever this gui is closed.
      Parameters:
      onClose - the consumer that gets called

    • callOnClose

      public void callOnClose​(@NotNull @NotNull org.bukkit.event.inventory.InventoryCloseEvent event)
      Calls the consumer (if it's not null) that was specified using setOnClose(Consumer), so the consumer that should be called whenever this gui is closed. Catches and logs all exceptions the consumer might throw.
      Parameters:
      event - the event to handle
      Since:
      0.6.0

    • isUpdating

      @Contract(pure=true) public boolean isUpdating()
      Gets whether this gui is being updated, as invoked by update(). This returns true if this is the case and false otherwise.
      Returns:
      whether this gui is being updated
      Since:
      0.5.15

    • registerProperty

      public static void registerProperty​(@NotNull @NotNull String attributeName, @NotNull @NotNull Function<String,​Object> function)
      Registers a property that can be used inside an XML file to add additional new properties.
      Parameters:
      attributeName - the name of the property. This is the same name you'll be using to specify the property type in the XML file.
      function - how the property should be processed. This converts the raw text input from the XML node value into the correct object type.
      Throws:
      IllegalArgumentException - when a property with this name is already registered.

    • registerPane

      public static void registerPane​(@NotNull @NotNull String name, @NotNull @NotNull BiFunction<Object,​Element,​Pane> biFunction)
      Registers a name that can be used inside an XML file to add custom panes
      Parameters:
      name - the name of the pane to be used in the XML file
      biFunction - how the pane loading should be processed
      Throws:
      IllegalArgumentException - when a pane with this name is already registered

    • registerGui

      public static void registerGui​(@NotNull @NotNull String name, @NotNull @NotNull BiFunction<? super Object,​? super Element,​? extends Gui> biFunction)
      Registers a type that can be used inside an XML file to specify the gui type
      Parameters:
      name - the name of the type of gui to be used in an XML file
      biFunction - how the gui creation should be processed
      Throws:
      IllegalArgumentException - when a gui type with this name is already registered

    • loadPane

      @NotNull public static @NotNull Pane loadPane​(@NotNull @NotNull Object instance, @NotNull @NotNull Node node)
      Loads a pane by the given instance and node
      Parameters:
      instance - the instance
      node - the node
      Returns:
      the pane