Uses of Annotation Interface
valorless.havenbags.annotations.NotNull

Packages that use NotNull
Package
Description
valorless.havenbags
Core package for the HavenBags plugin, containing main classes, listeners, configuration, and shared utilities.
valorless.havenbags.api
Public API surface for interacting with HavenBags features and data.
valorless.havenbags.configconversion
Provides versioned, one-shot migration utilities for HavenBags configuration and data.
valorless.havenbags.items
 
valorless.havenbags.utils
Internal utility classes shared across the plugin.

  • Uses of NotNull in valorless.havenbags

    Method parameters in valorless.havenbags with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static Boolean
    Database.bagExists(String uuid)
    Returns true if a bag with the given UUID exists in the in-memory map.
    static org.bukkit.entity.Player
    Database.bagOpenBy(String uuid, org.bukkit.inventory.ItemStack bagItem)
    Returns the Player currently viewing the bag, or null if it is not open.
    static Boolean
    Database.clearBagContent(String uuid)
    Clears the contents of the bag with the given UUID.
    static Boolean
    Database.clearBagContentPlayer(String playeruuid)
    Clears the contents of all bags owned by the specified player.
    static boolean
    Database.contains(String uuid)
    Returns true if a bag with the given UUID is present in the in-memory map.
    static Bag
    Database.createBag(String uuid, String owner, List<org.bukkit.inventory.ItemStack> content, org.bukkit.entity.Player creator, org.bukkit.inventory.ItemStack bag)
    Creates a new bag, stores it in memory, and persists it immediately for MYSQLPLUS.
    static Bag
    Database.createBag(String uuid, String owner, List<org.bukkit.inventory.ItemStack> content, org.bukkit.entity.Player creator, org.bukkit.inventory.ItemStack bag)
    Creates a new bag, stores it in memory, and persists it immediately for MYSQLPLUS.
    static Bag
    Database.createBag(String uuid, String owner, List<org.bukkit.inventory.ItemStack> content, org.bukkit.entity.Player creator, org.bukkit.inventory.ItemStack bag)
    Creates a new bag, stores it in memory, and persists it immediately for MYSQLPLUS.
    static Bag
    Database.createBag(Bag dat)
    Registers an already-constructed Bag into memory and persists it immediately for MYSQLPLUS.
    static Boolean
    Database.deleteBag(String uuid, org.bukkit.entity.Player... player)
    Permanently deletes a bag from both the storage backend and the in-memory map.
    static Bag
    Database.getBag(String uuid, Database.UpdateSource... source)
    Retrieves a loaded Bag by UUID.
    static List<String>
    Database.getBags(String playerUUID)
    Returns a list of all bag UUID strings owned by the specified player.
    static List<Bag>
    Database.getBagsData(String playerUUID)
    Returns a list of all Bag instances owned by the specified player.
    static boolean
    Database.isBagOpen(String uuid, org.bukkit.inventory.ItemStack bagItem)
    Checks whether the bag with the given UUID is currently open.
    static void
    Database.markBagClosed(String uuid)
    Marks the bag as closed and clears the viewer and GUI references.
    static void
    Database.markBagOpen(String uuid, org.bukkit.inventory.ItemStack bagItem, org.bukkit.entity.Player player)
    Marks the bag as open and records the viewing player.
    static void
    Database.markBagOpen(String uuid, org.bukkit.inventory.ItemStack bagItem, org.bukkit.entity.Player player, BagGUI gui)
    Marks the bag as open, records the viewing player, and attaches the associated BagGUI instance.
    static void
    Database.removeBag(String uuid)
    Removes the bag with the given UUID from the in-memory map and the Database.changedBags dirty set.
    static void
    Database.updateBag(String uuid, List<org.bukkit.inventory.ItemStack> content, Database.UpdateSource... source)
    Updates a bag's content by UUID and marks it dirty for the next save cycle.
    static void
    Database.updateBag(String uuid, List<org.bukkit.inventory.ItemStack> content, Database.UpdateSource... source)
    Updates a bag's content by UUID and marks it dirty for the next save cycle.
    static void
    Database.updateBag(org.bukkit.inventory.ItemStack bagItem, List<org.bukkit.inventory.ItemStack> content, Database.UpdateSource... source)
    Updates a bag's content and visual metadata (texture, model data, item model) from the given bag ItemStack, then marks it dirty for the next save cycle.
    static void
    Database.updateBag(org.bukkit.inventory.ItemStack bagItem, List<org.bukkit.inventory.ItemStack> content, Database.UpdateSource... source)
    Updates a bag's content and visual metadata (texture, model data, item model) from the given bag ItemStack, then marks it dirty for the next save cycle.

  • Uses of NotNull in valorless.havenbags.api

    Methods in valorless.havenbags.api with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createCustomBagItem(String key, org.bukkit.entity.Player player)
    Creates a custom bag item for the provided key.
    Method parameters in valorless.havenbags.api with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static void
    HavenBagsAPI.addBagDamage(org.bukkit.inventory.ItemStack bag, int damageToAdd)
    Adds damage to a bag item.
    static boolean
    HavenBagsAPI.bagExists(String uuid)
    Checks whether a bag exists in storage.
    static org.bukkit.entity.Player
    HavenBagsAPI.bagOpenBy(String uuid)
    Gets the player who has the bag open.
    static int
    HavenBagsAPI.bagSlotsEmpty(org.bukkit.inventory.ItemStack bag)
    Counts the number of empty slots in the specified bag item.
    static String
    HavenBagsAPI.bagState(org.bukkit.inventory.ItemStack item)
    Retrieves the current state of the bag.
    static boolean
    HavenBagsAPI.blacklistAsWhitelist(Bag bagData)
    Checks if the specified bag's configuration is set to treat its blacklist as a whitelist.
    static boolean
    HavenBagsAPI.canCarry(org.bukkit.inventory.ItemStack item, org.bukkit.inventory.ItemStack bag)
    Checks if the specified item can be carried in the given bag, considering weight limits.
    static boolean
    HavenBagsAPI.canCarry(org.bukkit.inventory.ItemStack item, org.bukkit.inventory.ItemStack bag)
    Checks if the specified item can be carried in the given bag, considering weight limits.
    static boolean
    HavenBagsAPI.canCarryMoreBags(org.bukkit.entity.Player player)
    Checks if the player can carry more bags based on configured limits.
    static String
    HavenBagsAPI.capacityTexture(org.bukkit.inventory.ItemStack bag)
    Determines the appropriate texture for a bag based on its used capacity.
    static boolean
    HavenBagsAPI.closeBag(String uuid)
    Closes the bag with the specified UUID if it is currently open.
    static String
    HavenBagsAPI.convertUrlToBase64(String url)
    Converts a texture URL to a Base64-encoded string.
    static Bag
    HavenBagsAPI.createBag(BagCreationObject creationObject)
    Creates and persists a new bag from the provided creation descriptor.
    static Bag
    HavenBagsAPI.createBag(Bag bagData)
    Creates and persists a new bag from the provided Data object.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createCustomBagItem(String key, org.bukkit.entity.Player player)
    Creates a custom bag item for the provided key.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createEffectToken(String value)
    Creates an effect token for the given effect identifier.
    static boolean
    HavenBagsAPI.createEtherealBag(String bagId, org.bukkit.entity.Player player, int size)
    Creates an ethereal bag entry for a player.
    static boolean
    HavenBagsAPI.createEtherealBag(String bagId, org.bukkit.entity.Player player, int size)
    Creates an ethereal bag entry for a player.
    static org.bukkit.inventory.Inventory
    HavenBagsAPI.GUI.createPage(org.bukkit.entity.Player player, String title, int page, List<org.bukkit.inventory.ItemStack> items, int rows)
    Creates a paginated inventory GUI for displaying items.
    if the number of items exceeds the capacity of a single page, multiple pages will be created.
    static org.bukkit.inventory.Inventory
    HavenBagsAPI.GUI.createPage(org.bukkit.entity.Player player, String title, int page, List<org.bukkit.inventory.ItemStack> items, int rows)
    Creates a paginated inventory GUI for displaying items.
    if the number of items exceeds the capacity of a single page, multiple pages will be created.
    static org.bukkit.inventory.Inventory
    HavenBagsAPI.GUI.createPage(org.bukkit.entity.Player player, String title, int page, List<org.bukkit.inventory.ItemStack> items, int rows)
    Creates a paginated inventory GUI for displaying items.
    if the number of items exceeds the capacity of a single page, multiple pages will be created.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createToken(String value, TokenType type)
    Creates a skin token ItemStack for the given value and type.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createToken(String value, TokenType type)
    Creates a skin token ItemStack for the given value and type.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createUnusedBagItem(int size, boolean binding)
    Creates an unused bag ItemStack with specified size and binding status.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.createUnusedBagItem(int size, boolean binding)
    Creates an unused bag ItemStack with specified size and binding status.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.creteHeadFromBase64(String base64)
    Creates a player head ItemStack with a custom texture from a Base64 string.
    static boolean
    HavenBagsAPI.customBagRequiresPlayer(String key)
    Checks if a custom bag key requires a player context when created via HavenBagsAPI.createCustomBagItem(String, Player).
    static boolean
    HavenBagsAPI.deleteBag(String uuid)
    Deletes a bag by UUID.
    static String
    HavenBagsAPI.extractUrlFromBase64(String base64)
    Extracts the URL from a Base64-encoded texture string.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.generateBagItem(Bag bagData)
    Generates a bag item from the provided Data.
    static Bag
    HavenBagsAPI.getBag(String uuid)
    Fetches Data for a bag by UUID.
    static int
    HavenBagsAPI.getBagCurrentHealth(org.bukkit.inventory.ItemStack bag)
    Gets the current remaining health for a bag item.
    static int
    HavenBagsAPI.getBagDamage(org.bukkit.inventory.ItemStack bag)
    Gets the current stored damage value for a bag item.
    static Bag
    HavenBagsAPI.getBagData(org.bukkit.inventory.ItemStack item)
    Resolves the live Data object for the given bag item.
    static int
    HavenBagsAPI.getBagMaxHealth(org.bukkit.inventory.ItemStack bag)
    Gets the maximum health for a bag item based on its configured size tier.
    static String
    HavenBagsAPI.getBagOwner(String uuid)
    Gets the owner UUID of a bag.
    static int
    HavenBagsAPI.getBagSlotsInInventory(org.bukkit.entity.Player player)
    Calculates the total number of bag slots in a player's inventory.
    static List<Bag>
    HavenBagsAPI.getBagsOnPlayer(org.bukkit.entity.Player player)
    Lists all bag Data instances present in a player's inventory.
    static BagState
    HavenBagsAPI.getBagState(org.bukkit.inventory.ItemStack bag)
    Checks the state of the bag (e.g., "NEW", "USED", "NULL") based on its contents and configuration.
    static String
    HavenBagsAPI.getBagUUID(org.bukkit.inventory.ItemStack item)
    Gets the UUID stored on a bag item.
    static double
    HavenBagsAPI.getBagWeight(List<org.bukkit.inventory.ItemStack> bagContents)
    Calculates the total weight of a list of ItemStacks, typically representing bag contents.
    static double
    HavenBagsAPI.getBagWeight(org.bukkit.inventory.ItemStack bag)
    Calculates the total weight of items contained within the specified bag item.
    static List<org.bukkit.inventory.ItemStack>
    HavenBagsAPI.getEtherealBags(String bagId, org.bukkit.entity.Player player)
    Gets the contents of an ethereal bag for a player.
    static List<org.bukkit.inventory.ItemStack>
    HavenBagsAPI.getEtherealBags(String bagId, org.bukkit.entity.Player player)
    Gets the contents of an ethereal bag for a player.
    static EtherealBagSettings
    HavenBagsAPI.getEtherealBagSettings(String bagId, org.bukkit.entity.Player player)
    Retrieves settings for a player's ethereal bag.
    static EtherealBagSettings
    HavenBagsAPI.getEtherealBagSettings(String bagId, org.bukkit.entity.Player player)
    Retrieves settings for a player's ethereal bag.
    static double
    HavenBagsAPI.getItemWeight(org.bukkit.inventory.ItemStack item)
    Retrieves the weight of a single ItemStack.
    static String
    HavenBagsAPI.GUI.getPageActionKey(org.bukkit.inventory.ItemStack button)
    Retrieves the action associated with a pagination button.
    static List<Bag>
    HavenBagsAPI.getPlayerBags(String playerUUID)
    Lists all bags owned by a player.
    static String
    HavenBagsAPI.getTexture(org.bukkit.inventory.ItemStack bag)
    Retrieves the custom texture Base64 string from the specified bag item.
    static boolean
    HavenBagsAPI.hasEtherialBag(String bagId, org.bukkit.entity.Player player)
    Checks if the player has the specified ethereal bag.
    static boolean
    HavenBagsAPI.hasEtherialBag(String bagId, org.bukkit.entity.Player player)
    Checks if the player has the specified ethereal bag.
    static boolean
    HavenBagsAPI.hasEtherialBags(org.bukkit.entity.Player player)
    Checks if the player has any ethereal bags.
    static boolean
    HavenBagsAPI.hasOthersBag(org.bukkit.entity.Player player)
    Checks if the player has any bags belonging to other players.
    static boolean
    HavenBagsAPI.isBag(org.bukkit.inventory.ItemStack item)
    Checks whether the given item is a HavenBag.
    static boolean
    HavenBagsAPI.isBagEmpty(String uuid)
    Checks if the bag with the specified UUID is empty.
    static boolean
    HavenBagsAPI.isBagEmpty(UUID uuid)
    Checks if the bag with the specified UUID is empty.
    static boolean
    HavenBagsAPI.isBagEmpty(org.bukkit.inventory.ItemStack bag)
    Checks if the bag is empty.
    static boolean
    HavenBagsAPI.isBagFull(String uuid)
    Checks if the bag with the specified UUID is full (no empty slots).
    static boolean
    HavenBagsAPI.isBagFull(UUID uuid)
    Checks if the bag with the specified UUID is full (no empty slots).
    static boolean
    HavenBagsAPI.isBagFull(org.bukkit.inventory.ItemStack bag)
    Checks if the specified bag is full (no empty slots).
    static boolean
    HavenBagsAPI.isBagOpen(String uuid)
    Checks if a bag is currently open by any viewer.
    static boolean
    HavenBagsAPI.isEtherealBagOpen(String bagId, org.bukkit.entity.Player player)
    Checks if the specified ethereal bag is currently open.
    static boolean
    HavenBagsAPI.isEtherealBagOpen(String bagId, org.bukkit.entity.Player player)
    Checks if the specified ethereal bag is currently open.
    static boolean
    HavenBagsAPI.isItemBlacklisted(org.bukkit.inventory.ItemStack item, Bag bagData)
    Checks if the specified item is blacklisted from being stored in HavenBags.
    static boolean
    HavenBagsAPI.isToken(org.bukkit.inventory.ItemStack item)
    Checks whether the given item is a valid skin token.
    static void
    HavenBagsAPI.refreshBagLore(org.bukkit.inventory.ItemStack bag)
    Refreshes the lore of the specified bag item to reflect its current state.
    static void
    HavenBagsAPI.refreshBagLore(org.bukkit.inventory.ItemStack bag, org.bukkit.entity.Player player)
    Refreshes the lore of the specified bag item to reflect its current state.
    static void
    HavenBagsAPI.refreshBagLore(org.bukkit.inventory.ItemStack bag, org.bukkit.entity.Player player)
    Refreshes the lore of the specified bag item to reflect its current state.
    static boolean
    HavenBagsAPI.removeEtherealBag(String bagId, org.bukkit.entity.Player player)
    Removes an ethereal bag entry from a player.
    static boolean
    HavenBagsAPI.removeEtherealBag(String bagId, org.bukkit.entity.Player player)
    Removes an ethereal bag entry from a player.
    static void
    HavenBagsAPI.setBagDamage(org.bukkit.inventory.ItemStack bag, int damage)
    Sets the stored damage value for a bag item.
    static boolean
    HavenBagsAPI.setEtherealBagContents(String bagId, org.bukkit.entity.Player player, List<org.bukkit.inventory.ItemStack> contents)
    Replaces the contents of an ethereal bag for a player.
    static boolean
    HavenBagsAPI.setEtherealBagContents(String bagId, org.bukkit.entity.Player player, List<org.bukkit.inventory.ItemStack> contents)
    Replaces the contents of an ethereal bag for a player.
    static boolean
    HavenBagsAPI.setEtherealBagContents(String bagId, org.bukkit.entity.Player player, List<org.bukkit.inventory.ItemStack> contents)
    Replaces the contents of an ethereal bag for a player.
    static void
    HavenBagsAPI.setTexture(org.bukkit.inventory.ItemStack bag, String base64Texture)
    Sets a custom texture on the specified bag item.
    static void
    HavenBagsAPI.setTexture(org.bukkit.inventory.ItemStack bag, String base64Texture)
    Sets a custom texture on the specified bag item.
    static org.bukkit.inventory.ItemStack
    HavenBagsAPI.upgradeBag(org.bukkit.inventory.ItemStack bag)
    Upgrades the given bag ItemStack to the next size tier.
    static double
    HavenBagsAPI.usedCapacity(org.bukkit.inventory.ItemStack bag)
    Calculates how full the specified bag is.

  • Uses of NotNull in valorless.havenbags.configconversion

    Method parameters in valorless.havenbags.configconversion with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static void
    CV2_BagConversion.check(valorless.valorlessutils.config.Config config)
    Checks the provided configuration for an outdated config-version and, if necessary, migrates bag directories from player-name based folders to UUID-based folders.
    static void
    CV5_TokenConfigConversion.check(valorless.valorlessutils.config.Config config)
    Checks the provided configuration and, if config-version < 5, updates the configuration structure by moving skin-token.* keys into token.skin.*, removes the legacy keys, and persists the changes.
    static void
    CV6_ConfigRestructure.check(valorless.valorlessutils.config.Config config)
    Checks the provided config and, if needed, performs a one-shot migration to config-version = 6.
    static void
    CV7_ConfigRestructure.check(valorless.valorlessutils.config.Config config)
    Checks the given configuration and performs a one-time migration to config-version = 7 when required.

  • Uses of NotNull in valorless.havenbags.items

    Method parameters in valorless.havenbags.items with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static org.bukkit.inventory.ItemStack
    BagItemFactory.toItemStack(Bag bag)
    Create an ItemStack representing the given bag data.

  • Uses of NotNull in valorless.havenbags.utils

    Method parameters in valorless.havenbags.utils with annotations of type NotNull
    Modifier and Type
    Method
    Description
    static void
    HeadCreator.setTextureValue(org.bukkit.inventory.ItemStack item, String value)
     
    static void
    HeadCreator.setTextureValue(org.bukkit.inventory.ItemStack item, String value)