Class SkilltreeManager
- All Implemented Interfaces:
ServiceContainer,Listener
Skilltrees and Requirements.
Skilltrees are loaded from .st.json files during plugin startup and registered
here by name. The manager provides lookup, ordering, weighted random selection, and
requirement evaluation for the pet skilltree selection UI.
Requirements are registered by their RequirementName annotation and evaluated
at runtime to determine if a pet qualifies for a given skilltree.
Loaded during Load.State.OnLoad so that skilltrees are available before pet
data is restored from the repository.
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidRemoves all registered skilltrees.Returns skilltree names sorted by theirSkilltree.getOrder()value.Returns all registered skilltrees sorted by theirSkilltree.getOrder()value.getRandomSkilltree(Pet pet) Selects a random skilltree for the given pet using weighted probability.getRequirement(String requirementName) Looks up a requirement by name (case-insensitive).getRequirementName(Class<?> clazz) Resolves the requirement name for a class by searching its type hierarchy for aRequirementNameannotation.getSkilltree(String name) Returns the skilltree with the given name, ornullif none is registered.Returns the set of all registered skilltree names.Returns all registered skilltree instances (unordered).booleanhasSkilltree(String name) Returnstrueif a skilltree with the given name is registered.voidDisables the servicevoidregisterRequirement(Requirement Requirement) Registers a requirement implementation, keyed by the name from itsRequirementNameannotation (case-insensitive).voidregisterSkilltree(Skilltree skilltree) Registers a skilltree, keyed by its name.voidremoveRequirement(Requirement requirement) Unregisters a requirement by resolving the name from its class annotation.voidremoveRequirement(String requirementName) Unregisters a requirement by name.Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface de.Keyle.MyPet.api.util.service.ServiceContainer
getActivationMessage, getServiceName, loadConfig, onEnable
-
Constructor Details
-
SkilltreeManager
public SkilltreeManager()Creates an empty manager. MyPet registers one as a service; addons use that instance.
-
-
Method Details
-
onDisable
public void onDisable()Description copied from interface:ServiceContainerDisables the service- Specified by:
onDisablein interfaceServiceContainer
-
registerSkilltree
Registers a skilltree, keyed by its name. Overwrites any existing tree with the same name.- Parameters:
skilltree- the skilltree to register
-
getSkilltree
Returns the skilltree with the given name, ornullif none is registered.- Parameters:
name- the skilltree's name- Returns:
- the registered skilltree, or
nullif none has that name
-
getSkilltreeNames
Returns the set of all registered skilltree names.- Returns:
- the names of every registered skilltree
-
getOrderedSkilltreeNames
Returns skilltree names sorted by theirSkilltree.getOrder()value.- Returns:
- the names, in menu order
-
getSkilltrees
Returns all registered skilltree instances (unordered).- Returns:
- every registered skilltree
-
getOrderedSkilltrees
Returns all registered skilltrees sorted by theirSkilltree.getOrder()value.- Returns:
- every registered skilltree, in menu order
-
getRandomSkilltree
Selects a random skilltree for the given pet using weighted probability.Only skilltrees that match the pet's type, pass all requirements, and have a positive weight are candidates. The selection uses a cumulative-weight random algorithm so that trees with higher weights are proportionally more likely.
- Parameters:
pet- the pet to select a skilltree for- Returns:
- a randomly selected skilltree, or
nullif no candidates qualify
-
hasSkilltree
Returnstrueif a skilltree with the given name is registered.- Parameters:
name- the name to look for- Returns:
trueif a skilltree with that name is registered
-
clearSkilltrees
public void clearSkilltrees()Removes all registered skilltrees. Typically called during reload or shutdown. -
registerRequirement
Registers a requirement implementation, keyed by the name from itsRequirementNameannotation (case-insensitive).- Parameters:
Requirement- the requirement instance to register
-
getRequirement
Looks up a requirement by name (case-insensitive).- Parameters:
requirementName- the requirement name to look up- Returns:
- the requirement instance, or
nullif not registered
-
getRequirementName
Resolves the requirement name for a class by searching its type hierarchy for aRequirementNameannotation.Searches the class itself, then its superclass chain, then all implemented interfaces recursively.
- Parameters:
clazz- the class to inspect- Returns:
- the annotated requirement name, or
nullif not found
-
removeRequirement
Unregisters a requirement by name.- Parameters:
requirementName- the requirement to unregister
-
removeRequirement
Unregisters a requirement by resolving the name from its class annotation.- Parameters:
requirement- the requirement to unregister
-