Package de.Keyle.MyPet.api.repository
Class PlayerManager
java.lang.Object
de.Keyle.MyPet.api.repository.PlayerManager
Manages the online
MyPetPlayer cache. Tracks which players are
known to the MyPet system and provides lookup by UUID, Bukkit
Player, or name. The concrete implementation in the plugin
module handles persistence (load/save to the repository) and login/
logout lifecycle.
The cache is thread-safe (ConcurrentHashMap), but most
mutations should occur on the main/entity thread.
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected final Map<UUID, MyPetPlayer> The online players MyPet is tracking, keyed by Mojang UUID. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract MyPetPlayercreateMyPetPlayer(Player player) Creates a new MyPetPlayer instance for a Bukkit player without persisting it.getMyPetPlayer(String name) Looks up a MyPetPlayer by display name.getMyPetPlayer(UUID playerUUID) Returns the cached MyPetPlayer for the given UUID, ornullif the player is not online or not registered.getMyPetPlayer(Player player) Returns the cached MyPetPlayer for the given Bukkit player, ornullif not registered.Returns a snapshot array of all currently online MyPetPlayers.booleanisMyPetPlayer(String name) Returnstrueif an online player with this name is registered.booleanisMyPetPlayer(Player player) Returnstrueif this Bukkit player is in the online cache.abstract MyPetPlayerregisterMyPetPlayer(Player player) Loads or creates a MyPetPlayer for the given Bukkit player and adds them to the online cache.abstract voidsetOffline(MyPetPlayer player) Removes a player from the online cache and persists their data.voidsetOnline(MyPetPlayer player) Adds a player to the online cache.
-
Field Details
-
onlinePlayers
The online players MyPet is tracking, keyed by Mojang UUID.
-
-
Constructor Details
-
PlayerManager
public PlayerManager()Creates a manager. MyPet supplies the implementation; addons reach it through the API.
-
-
Method Details
-
getMyPetPlayer
Returns the cached MyPetPlayer for the given UUID, ornullif the player is not online or not registered.- Parameters:
playerUUID- the player's Mojang UUID- Returns:
- the tracked player, or
nullif they are not online
-
getMyPetPlayer
Returns the cached MyPetPlayer for the given Bukkit player, ornullif not registered.- Parameters:
player- the Bukkit player- Returns:
- the tracked player
-
getMyPetPlayer
Looks up a MyPetPlayer by display name. Returnsnullif the player is not online or not registered.- Parameters:
name- the player's name- Returns:
- the tracked player, or
nullif they are not online
-
setOnline
Adds a player to the online cache. Called on join after loading.- Parameters:
player- the player who came online
-
setOffline
Removes a player from the online cache and persists their data.- Parameters:
player- the player who went offline
-
createMyPetPlayer
Creates a new MyPetPlayer instance for a Bukkit player without persisting it. Used during the first-time registration flow.- Parameters:
player- the Bukkit player- Returns:
- a newly created tracked player
-
isMyPetPlayer
Returnstrueif an online player with this name is registered.- Parameters:
name- the player's name- Returns:
trueif MyPet is tracking that player
-
isMyPetPlayer
Returnstrueif this Bukkit player is in the online cache.- Parameters:
player- the Bukkit player- Returns:
trueif MyPet is tracking that player
-
getMyPetPlayers
Returns a snapshot array of all currently online MyPetPlayers.- Returns:
- every player MyPet is currently tracking
-
registerMyPetPlayer
Loads or creates a MyPetPlayer for the given Bukkit player and adds them to the online cache. Called during the login sequence.- Parameters:
player- the Bukkit player- Returns:
- the tracked player, created if this is their first join
-