EliteMobs/com.magmaguy.elitemobs.advancedcombat.progression/ClassProgressionModule

ClassProgressionModule

public final class ClassProgressionModule

Thread-safe cache and domain Module for [Alpha] Advanced Combat System progression.

All store access runs through one serial executor. Reads, awards and selections use only immutable catalog data and the loaded cache, so gameplay callers never perform JDBC work.

Constructors

public void ClassProgressionModule(ClassCatalog catalog, FoundationLevels foundationLevels, ClassProgressionStore store)

Creates a Module with its own daemon persistence thread.

public void ClassProgressionModule(ClassCatalog catalog, FoundationLevels foundationLevels, ClassProgressionStore store, ClassContentAvailability contentAvailability)

public void ClassProgressionModule(ClassCatalog catalog, FoundationLevels foundationLevels, ClassProgressionStore store, Executor persistenceExecutor)

Creates a Module over a supplied asynchronous executor; calls are serialized even if it is a pool.

public void ClassProgressionModule(ClassCatalog catalog, FoundationLevels foundationLevels, ClassProgressionStore store, Executor persistenceExecutor, ClassContentAvailability contentAvailability)

Functions

activeRunSelection

public Optional<RunSelection> activeRunSelection(UUID playerId)

award

public AwardResult award(UUID playerId, long requestedXp)

Awards the selected form, or the memory-locked run form when one exists.

builtIn

public static ClassProgressionModule builtIn(FoundationLevels foundationLevels, ClassProgressionStore store)

public static ClassProgressionModule builtIn(FoundationLevels foundationLevels, ClassProgressionStore store, Executor persistenceExecutor)

canChallenge

public boolean canChallenge(UUID playerId, String formId)

Eligibility excludes only this form's trial, never its parent's requirements.

clearSelectedForm

public SelectionResult clearSelectedForm(UUID playerId)

closeAsync

public synchronized CompletableFuture<Void> closeAsync()

completeChallenge

public boolean completeChallenge(UUID playerId, String formId)

Unlocks and selects the form after the owning trial's instructor actually dies.

failure

public Optional<Throwable> failure(UUID playerId)

flush

public CompletableFuture<Void> flush()

Completes after every operation submitted before this call has left the store boundary.

public CompletableFuture<Void> flush(UUID playerId)

Same global ordering barrier, additionally surfacing this player's recorded failure.

forgetForAdministration

public ClassProgressionForgetResult forgetForAdministration(UUID playerId, String formId)

Revokes a form and all descendants, preserving its ancestors and sibling branches.

isReady

public boolean isReady(UUID playerId)

load

public CompletableFuture<ProfileSnapshot> load(UUID playerId)

Loads, validates and publishes one player's complete profile without blocking the caller.

lockRun

public RunLockResult lockRun(UUID playerId, UUID runId)

Locks the selected class and its controls for this run.

readiness

public ProgressionReadiness readiness(UUID playerId)

recordTutorialSkill

public Optional<SkillTutorialProgress> recordTutorialSkill(UUID playerId, AbilitySlot slot)

Records a successful cast once, using the same ordered persistence queue as class selections.

runSelection

public Optional<RunSelection> runSelection(UUID playerId, UUID runId)

selectForm

public SelectionResult selectForm(UUID playerId, String formId)

selectInputProfile

public SelectionResult selectInputProfile(UUID playerId, InputProfile inputProfile)

setAllLineagesForAdministration

public int setAllLineagesForAdministration(UUID playerId, int effectiveLevel)

Permission-gated tester fixture backing /em loot debug: scales every class tree to one effective level.

setLineageForAdministration

public ClassProgressionSetResult setLineageForAdministration(UUID playerId, String formId, int effectiveLevel)

Permission-gated tester fixture: completes every ancestor band, sets the requested form to an exact visible level, and selects it.

snapshot

public Optional<ProfileSnapshot> snapshot(UUID playerId)

Returns an immutable current view only after successful hydration.

tutorialProgress

public Optional<SkillTutorialProgress> tutorialProgress(UUID playerId)

unload

public void unload(UUID playerId)

Drops loaded profile state.

unlockRun

public boolean unlockRun(UUID playerId, UUID runId)

A stale run token cannot clear a newer instance's lock.