Class CacheManager

java.lang.Object
com.ranull.graves.manager.CacheManager
public class CacheManager extends Object

  • Constructor Details

    • CacheManager

      public CacheManager()
      Constructs a new CacheManager with initialized maps.

      The constructor initializes all the maps used for caching data related to graves, chunks, locations, and items

  • Method Details

    • getGraveMap

      public Map<UUID,Grave> getGraveMap()
      Returns the map of grave UUIDs to their corresponding Grave objects.
      Returns:
      the map of graves

    • addRightClickedBlock

      public void addRightClickedBlock(String playerName, org.bukkit.Location location)
      Adds a right-clicked block location for a specified player.
      Parameters:
      playerName - the name of the player
      location - the location of the right-clicked block

    • getRightClickedBlock

      public org.bukkit.Location getRightClickedBlock(String playerName)
      Retrieves the location of the right-clicked block for a specified player.
      Parameters:
      playerName - the name of the player
      Returns:
      the location of the right-clicked block, or null if not found

    • removeRightClickedBlock

      public void removeRightClickedBlock(String playerName, org.bukkit.Location location)
      Removes the right-clicked block location for a specified player.
      Parameters:
      playerName - the name of the player
      location - the location of the right-clicked block

    • hasRightClickedBlock

      public boolean hasRightClickedBlock(String playerName)
      Checks if a right-clicked block location exists for a specified player.
      Parameters:
      playerName - the name of the player
      Returns:
      true if the right-clicked block location exists, false otherwise

    • getChunkMap

      public Map<String, ChunkData> getChunkMap()
      Returns the map of chunk identifiers to their corresponding ChunkData objects.
      Returns:
      the map of chunk data

    • getLastLocationMap

      public Map<UUID, org.bukkit.Location> getLastLocationMap()
      Returns the map of entity UUIDs to their last known Location.
      Returns:
      the map of last known locations

    • getRemovedItemStackMap

      public Map<UUID, List<org.bukkit.inventory.ItemStack>> getRemovedItemStackMap()
      Returns the map of entity UUIDs to lists of removed ItemStack objects.
      Returns:
      the map of removed item stacks

    • startViewingGrave

      public boolean startViewingGrave(UUID graveUUID, UUID viewerUUID)
      Marks a grave as currently being viewed by the given player.

      If the grave is already being viewed by someone else, this will NOT overwrite the current viewer. Use canAccessGrave(UUID, UUID) / isGraveBeingViewed(UUID) to check first.

      Parameters:
      graveUUID - the grave UUID
      viewerUUID - the player's UUID
      Returns:
      true if the viewer was set (lock acquired), false if someone else already holds it

    • stopViewingGrave

      public void stopViewingGrave(UUID graveUUID, UUID viewerUUID)
      Clears the viewer lock for a grave if the given player is the current viewer.
      Parameters:
      graveUUID - the grave UUID
      viewerUUID - the player's UUID

    • clearGraveViewer

      public void clearGraveViewer(UUID graveUUID)
      Force-clears the viewer lock for a grave (regardless of who is viewing). Useful for cleanup if a viewer disconnects unexpectedly.
      Parameters:
      graveUUID - the grave UUID

    • clearAllGraveViewersFor

      public void clearAllGraveViewersFor(UUID viewerUUID)
      Clears any grave-viewer locks held by the specified player. Useful to call on PlayerQuitEvent.
      Parameters:
      viewerUUID - the player's UUID

    • isGraveBeingViewed

      public boolean isGraveBeingViewed(UUID graveUUID)
      Checks whether a grave is currently being viewed by someone.
      Parameters:
      graveUUID - the grave UUID
      Returns:
      true if the grave is being viewed, otherwise false

    • getGraveViewer

      public UUID getGraveViewer(UUID graveUUID)
      Gets the UUID of the player currently viewing a grave, or null if none.
      Parameters:
      graveUUID - the grave UUID
      Returns:
      the viewer UUID, or null

    • canAccessGrave

      public boolean canAccessGrave(UUID graveUUID, UUID viewerUUID)
      Checks if a player can access a grave right now.

      Access is allowed if the grave is not being viewed, or if it is being viewed by the same player.

      Parameters:
      graveUUID - the grave UUID
      viewerUUID - the player's UUID
      Returns:
      true if access is allowed, otherwise false

    • getGrave

      public Grave getGrave(UUID graveUUID)
      Retrieves a Grave from the cache by its UUID
      Parameters:
      graveUUID - the UUID of the grave to retrieve
      Returns:
      the Grave associated with the UUID provided, or null if not present

    • getGrave

      public Grave getGrave(org.bukkit.block.Block block)
      Convenience method to retrieve a Grave from the cache based on a Block.

      Internally delegates to getGrave(Location) using the block's location.

      Parameters:
      block - the block to check
      Returns:
      the matching Grave, or null if none is found

    • getOldestGrave

      public Grave getOldestGrave(UUID playerUUID)
      Returns the oldest grave for a given player.
      Parameters:
      playerUUID - The UUID of the player whose graves to consider.
      Returns:
      The oldest grave for the specified player.

    • getGrave

      public Grave getGrave(org.bukkit.Location location)
      Retrieves the Grave whose block is located at the given Location.

      This compares block coordinates (world + block X/Y/Z) instead of raw double coordinates to ensure it matches the actual block the grave is placed on.

      Parameters:
      location - the location of the grave block
      Returns:
      the matching Grave, or null if none is found

    • getEntityMap

      public Map<UUID, EntityData> getEntityMap()
      Returns the map of entity UUIDs to their corresponding EntityData.
      Returns:
      the entity map

    • getEntityData

      public EntityData getEntityData(UUID entityUUID)
      Retrieves tracked entity data by entity UUID.
      Parameters:
      entityUUID - the entity UUID
      Returns:
      the tracked entity data, or null if not cached

    • addEntityData

      public void addEntityData(EntityData entityData)
      Adds or replaces tracked entity data in the cache.
      Parameters:
      entityData - the entity data to cache

    • removeEntityData

      public void removeEntityData(UUID entityUUID)
      Removes tracked entity data from the cache by entity UUID.
      Parameters:
      entityUUID - the entity UUID

    • removeEntityData

      public void removeEntityData(EntityData entityData)
      Removes tracked entity data from the cache.
      Parameters:
      entityData - the entity data to remove