Internal:
- Adding Crafter dependency to reuse some util classes instead of maintaining custom ones.
- Replacing JavaPlugin#saveResource use from Spigot by FileUtil#copyResource from Crafter to remove logs when loading inventory configuration files.

Features:

• Adding the ability to disable an item to prevent the execution of its action when a user clicks on it. More precisely, the following methods have been added to the InventoryItem interface:
  • void enable() to enable the item.
  • void disable() to disable the item.
  • boolean isEnabled() to check if the item is enabled or not.

Features:

• Adding the ability to retrieve the value associated with a paginated InventoryItem. An InventoryItem now has a local DataStore that can be retrieved by using the getLocalStore() method. The paginated data is associated with the constant key CommonDataStoreKey.PAGINATED_DATA, and can be retrieved using the <T> Optional<T> getData(String key, Class<T> type) method. Related issue. Issue #57

• Adding the ability to transfer data between inventories by passing a Context when opening it. Two methods has been added to the InventoryViewManager interface: void openView(CraftVentory inventory, Context context) and void openView(CraftVentory inventory, boolean newHistory, Context context). When opening the inventory, this context will be available in the CraftVentoryBeforeOpenEvent thrown. This event can be handled by declaring hooks. Then, the Context interface contains methods that can be used to retrieve the data. Issue #56

• Improving the Context interface by replacing the method boolean hasData(String key) by boolean hasData(String key, Class<?> type) to also check the type of the data. Adding a method <T> Optional<T> findData(String key, Class<T> type) to retrieve the data in an Optional<T>. Issue #60

• Adding a static method createContext() in CraftVentoryLibrary to create a Context without manipulating the implementation. This is useful when you want to create a Context to pass data when opening an inventory.

• Replacing the CommonContextKey enum by a class with static constants, which is lighter to use. Renaming the PAGINATION_ITEM constant to PAGINATED_DATA which is more explicit.

Rework:
- In the DataStore interface, changing parameters Class<T> type and T value order of the setData() method to be consistent with the same method in the Context interface. Concretely, changing <T> void setData(String key, Class<T> type, T value) to <T> void setData(String key, T value, Class<T> type).

Documentation:
- Improving javadoc consistency between Context and DataStore which are similar interfaces.
- Adding javadoc for newly added methods.

Bug fixes:

• Fixing a bug in which inventory placeholders were not registered.
• Fixing a bug in which InventoryStorage#hasData(String, Class<?>) produced false negatives.

Documentation:

• Improving the README of the project by adding a setup section.
• Improving the wiki by explaining how to setup the library using the JAR file as dependency.

Rework:

• Reworking the way inventories are declared and registered. Introducing an InventoryDescriptor interface which is responsible for declaring inventory properties (providers, placeholders, hooks, config file, etc.). As this is an interface, it will not provide any behavior like the old way. It is then be used to create and register a new InventoryProvider in an InventoryService. By using this, we separate what is provided by the developer and what is provided by the library. The interface also has default methods with no implementation that developers can redefine if they needs to. See the wiki for more information about this new way to register inventories.

• Reworking the way pagination are provided to be able to dynamically retrieve paginated values depending on the current context. Technically, instead of using a Supplier<List<T>>, using a Function<CraftVentory, List<T>> with the currently opened inventory and all its data as context. This enables to retrieve paginated data depending on the viewer / some inventory properties.

• Reworking the way item action loaders are registered by using an enum instead of manually adding each loader one by one. This is an internal change to improve the code and has no impact on the behavior of the library.

Fixing a bug in which where there was no paginated item, the number of pages was 0 instead of 1 (empty page is considered as a valid page).

Rework:

• Renaming the InventoryModel interface to InventoryStorage which is more explicit.
• Renaming the getter CraftVentory#getInventoryModel() to CraftVentory#getInventoryStorage()

Features:

• Adding a new method in the InventoryStorage interface to check if a data exists by key and type.
• Adding a shared storage between inventories in the same history.

Features:

• Pagination improvements:
  • Improving pagination handling by adding the new PaginationManager class that is specifically responsible of that.
  • Improving pagination registration to keep their current state when opening inventory multiple times. Note: Needed for the inventory history feature.
  • Adding PaginationModel#setCurrentPage(int page) to be able to manually open a specific page in a pagination.
• New item actions:
  • Adding theUPDATE_CONTENT action to update the whole inventory content.
  • Adding the UPDATE_PAGINATIONS action to update paginations.
• Adding the InventoryModel class to let developers store properties within an inventory.
  
  
• Hooks: Adding hooks to let developers execute code specifically for an inventory when it is opened, closed or when an item is clicked. Hooks are applied on events (e.g. sub classes of the FastInventoryEvent class). Hooks can be added on the following events:
  • FastInventoryBeforeOpenEvent: Called before opening an inventory.
  • FastInventoryAfterOpenEvent: Called after an inventory has been opened.
  • FastInventoryClickEvent: Called when a player clicks on an item.
  • FastInventoryCloseEvent: Called when an inventory is closed.
• Inventory history: Adding the tracking of players' inventory history and adding actions to navigate through it. The following actions has been added:
  • BACKWARD: Open a previously opened inventory in the history which is before the current one in the history.
  • FORWARD: Open a previously opened inventory in the history which is after the current one in the history.
  • HOME: Open the root inventory in the history.
  • OPEN_INVENTORY: Open a new inventory and add it to the current history or in a new one.

Rework:

• Package architecture: Reworking the package architecture to better represent the three layer organization of the library (e.g. config, transform, inventory). This is a breaking change for a more coherent organization of classes.
  
  
• Transformation process: Reworking the transformation process that retrieves and enhance inventory properties from an inventory configuration.
  • The transformation process is now well defined and scoped.
  • Now, all the manipulated inventory properties can be enhanced through custom Data Transfer Objects (DTO) such as title, inventory type, items, paginations, etc.
  • Providers are now able to provide several properties instead of only one (ex: an item and its associated slots).
• Events: Reworking inventory related event classes (FastInventoryEvent, FastInventoryClickEvent) and adding new events.
  
  
• Inventory handling: Reworking the way inventories are opened and closed to implement the tracking of player's inventory history. Now, an inventory should be opened using methods from the InventoryViewManager interface instead of the ones from the FastInventory interface.

Documentation:

• Javadoc: Adding javadoc on all the classes of the api package and on the FastInventoryLibrary class.

This update also includes the renaming of the project from FastInventory to CraftVentory which is a more unique name.

For more information about the update, see the milestone 2.0.0 on GitHub.

Update content:

• Adding click type condition to execute an action.
• Adding new item actions : broadcast, sound.
• Improving the existing message action by replacing single message by a list of messages.
• Improving the existing player command action by replacing single command by a list of commands.
• Renaming the existing server command action to console command and replacing single command by a list of commands.
• Fixing message color parsing for actions that send messages.

Related issues: See closed issues in 1.1.0 milestone on GitHub.