EliteMobs/com.magmaguy.elitemobs.advancedcombat/AdvancedCombatModule

AdvancedCombatModule

public final class AdvancedCombatModule implements Listener, ClassAbilityInput, AutoCloseable

Deep module boundary for [Alpha] Advanced Combat System classes.

Bukkit adapters submit player intent here; this object alone coordinates progression, run locks, resources, passives, threat, contribution and presentation. Active abilities have no cooldowns: resource costs are the only pacing.

Types

AbilityResourceSnapshot

public final class AbilityResourceSnapshot extends Record

Functions

abilityEvidence

public static List<AbilityRuntimeObservation> abilityEvidence(UUID playerId)

Stable observation seam for the external every-class behavior probe.

abilityName

public String abilityName(Player player, AbilitySlot slot)

abilityResourceSnapshot

public static Optional<AdvancedCombatModule.AbilityResourceSnapshot> abilityResourceSnapshot(Player player, AbilitySlot slot)

Read-only presentation of the same cost and affordability check used when casting.

activeClassLineageSnapshot

public static Optional<ClassLineage> activeClassLineageSnapshot(UUID playerId)

The same effective lineage used for activation, including an instance's locked class.

activeClassWeaponAffinities

public Set<SkillType> activeClassWeaponAffinities(Player player)

Weapon affinities of the active form; empty without an active class.

activeInputProfile

public InputProfile activeInputProfile(Player player)

awardClassXp

public AwardResult awardClassXp(Player player, long rawReward)

Same raw reward for every contributor; damage share never enters this method.

canChallenge

public boolean canChallenge(Player player, String formId)

catalog

public ClassCatalog catalog()

classProgressSnapshot

public static Optional<FormProgressSnapshot> classProgressSnapshot(UUID playerId)

Active form, including the selection locked for an instance run.

clearSelectedForm

public SelectionResult clearSelectedForm(Player player)

public void close()

completeChallenge

public boolean completeChallenge(Player player, String formId)

controlsAlwaysAvailable

public boolean controlsAlwaysAvailable(Player player)

drainAbilityEvidence

public static List<AbilityRuntimeObservation> drainAbilityEvidence(UUID playerId)

fLayerSupported

public boolean fLayerSupported(Player player)

Whether this client can express the F-key layer at all (Bedrock clients cannot).

forgetClassForAdministration

public ClassProgressionForgetResult forgetClassForAdministration(Player player, String formId)

Resets one subtree and immediately releases any affected active class mechanics.

get

public static AdvancedCombatModule get()

hasActiveClass

public boolean hasActiveClass(Player player)

initialize

public static AdvancedCombatModule initialize(PlayerCombatState combatState)

isAbilityGestureOpen

public static boolean isAbilityGestureOpen(UUID playerId)

isInitialized

public static boolean isInitialized()

meaningfulParticipants

public Set<Player> meaningfulParticipants(EliteEntity elite)

mechanicsActive

public boolean mechanicsActive(Player player)

onClassTrialEnded

public void onClassTrialEnded(Player player)

Refreshes the awarded selection after the trial has removed its participant.

onControlModeChanged

public void onControlModeChanged(Player player)

onEliteDamagesPlayer

public void onEliteDamagesPlayer(PlayerDamagedByEliteMobEvent event)

onEliteDeath

public void onEliteDeath(EliteMobDeathEvent event)

onJoinControlToggleNotice

public void onJoinControlToggleNotice(PlayerJoinEvent event)

Announces the outside-content control toggle to players with an unlocked class.

onMatchLeave

public void onMatchLeave(MatchLeaveEvent event)

onMatchStart

public void onMatchStart(MatchStartEvent event)

onPlayerChangedWorld

public void onPlayerChangedWorld(PlayerChangedWorldEvent event)

onPlayerDamagesElite

public void onPlayerDamagesElite(EliteMobDamagedByPlayerEvent event)

onPlayerDamagesNonElite

public void onPlayerDamagesNonElite(EntityDamageByEntityEvent event)

onPlayerDataLoaded

public void onPlayerDataLoaded(PlayerDataLoadedEvent event)

onPlayerDeath

public void onPlayerDeath(PlayerDeathEvent event)

onPlayerQuit

public void onPlayerQuit(PlayerQuitEvent event)

onPlayerTakesDamage

public void onPlayerTakesDamage(EntityDamageEvent event)

outsideControlsAllowed

public boolean outsideControlsAllowed()

profile

public Optional<ProfileSnapshot> profile(UUID playerId)

resourceSnapshot

public static Optional<ClassResourceController.Snapshot> resourceSnapshot(UUID playerId)

Read-only presentation snapshot; callers never receive the mutable resource controller.

scaleAllClassesForAdministration

public int scaleAllClassesForAdministration(Player player, int effectiveLevel)

Loot-debug fixture: scales every class tree to the requested effective level.

selectForm

public SelectionResult selectForm(Player player, String formId)

setClassLevelForAdministration

public ClassProgressionSetResult setClassLevelForAdministration(Player player, String formId, int effectiveLevel)

shutdownIfInitialized

public static void shutdownIfInitialized()

useAbility

public AbilityResult useAbility(Player player, AbilitySlot slot)