Interface StoreAPI<P,M>


public interface StoreAPI<P,M>
API for registering and managing store categories/items.
  • Method Details

    • registerCategory

      void registerCategory(StoreCategoryDefinition<M> category, List<StoreItemDefinition<M>> items)
      Register a category with its items.
      Parameters:
      category - Category definition
      items - Items available in the category
    • unregisterCategory

      void unregisterCategory(String categoryId)
      Unregister a category by its id.
      Parameters:
      categoryId - Category id
    • openStore

      boolean openStore(P player)
      Open the global store categories menu for the player.
    • openStore

      boolean openStore(P player, String moduleId)
      Open the store menu including module-specific categories.
      Parameters:
      player - Player to open for
      moduleId - Module id to include module-specific categories
    • openCategory

      boolean openCategory(P player, String categoryId)
      Open a specific category.
    • isUnlocked

      boolean isUnlocked(P player, String categoryId, String itemId)
      Check if an item is unlocked for a player.
    • unlock

      boolean unlock(P player, String categoryId, String itemId)
      Unlock an item for a player.
    • select

      boolean select(P player, String categoryId, String itemId)
      Select an item for a player.
    • getSelected

      String getSelected(P player, String categoryId)
      Get the selected item id for a category.
    • resolveSelected

      String resolveSelected(P player, String categoryId)
      Get the effective selected item id, resolving random selections to a concrete unlocked item.
      Parameters:
      player - player to resolve for
      categoryId - category id
      Returns:
      the resolved item id, or null if none is available