Package dev.deepcore.challenge.session

Class SessionOperationService

java.lang.Object

dev.deepcore.challenge.session.SessionOperationService

public final class SessionOperationService
extends Object

Provides a single operations facade over session-level service actions.

Constructor Summary

Constructors

Constructor

Description

SessionOperationService(Supplier<SessionUiCoordinatorService> sessionUiCoordinatorSupplier, Supplier<DegradingInventoryTickerService> degradingInventoryTickerSupplier, Supplier<DegradingInventoryService> degradingInventoryServiceSupplier, Supplier<SharedInventorySyncService> sharedInventorySyncServiceSupplier, Supplier<RunHealthCoordinatorService> runHealthCoordinatorServiceSupplier, Supplier<PrepGuiCoordinatorService> prepGuiCoordinatorServiceSupplier, Supplier<ActionBarTickerService> actionBarTickerServiceSupplier, Supplier<PausedRunStateService> pausedRunStateServiceSupplier, Supplier<WorldResetManager> worldResetManagerSupplier)

Creates a session operation facade service.

Method Summary

Modifier and Type	Method	Description
void	applyInitialHalfHeart(org.bukkit.entity.Player player)	Applies the initial half-heart setting to a specific player.
void	applyInitialHalfHeartIfEnabled()	Applies initial half-heart challenge settings for online participants.
void	clearActionBar()	Clears action bars for all currently online players.
void	clearLobbySidebar(org.bukkit.entity.Player player)	Clears the lobby sidebar for the given player when supported.
void	clearLockedBarrierSlots(org.bukkit.entity.Player player)	Clears locked barrier slots for a player when degrading inventory is active.
void	clearPausedSnapshots()	Clears stored paused-run snapshots from the session state service.
void	enforceInventorySlotCap(org.bukkit.entity.Player player)	Enforces the active inventory slot cap for a player when enabled.
void	refreshOpenPrepGuis()	Refreshes all currently open preparation GUIs if available.
void	restoreDefaultMaxHealth(org.bukkit.entity.Player player)	Restores default max health values for the provided player.
void	snapshotEquippedWearablesForParticipants()	Captures wearable snapshots for all active challenge participants.
void	startActionBarTask()	Starts the challenge action-bar task if the UI coordinator is available.
void	startDegradingInventoryTask(boolean resetSlots)	Starts the degrading-inventory ticker and optionally resets slot state.
void	startLobbySidebarTask()	Starts the lobby sidebar task if the UI coordinator is available.
void	stashRunStateForLobby(org.bukkit.entity.Player player, boolean teleportToLobby)	Stashes player run state for lobby transfer with optional teleport.
void	syncSharedHealthFromFirstParticipant()	Synchronizes shared health from the first online participant state.
void	syncSharedHungerFromMostFilledParticipant()	Synchronizes shared hunger from the most-satiated online participant.
void	syncSharedInventoryFromFirstParticipant()	Synchronizes shared inventory from the first online participant snapshot.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SessionOperationService

public SessionOperationService(Supplier<SessionUiCoordinatorService> sessionUiCoordinatorSupplier,
 Supplier<DegradingInventoryTickerService> degradingInventoryTickerSupplier,
 Supplier<DegradingInventoryService> degradingInventoryServiceSupplier,
 Supplier<SharedInventorySyncService> sharedInventorySyncServiceSupplier,
 Supplier<RunHealthCoordinatorService> runHealthCoordinatorServiceSupplier,
 Supplier<PrepGuiCoordinatorService> prepGuiCoordinatorServiceSupplier,
 Supplier<ActionBarTickerService> actionBarTickerServiceSupplier,
 Supplier<PausedRunStateService> pausedRunStateServiceSupplier,
 Supplier<WorldResetManager> worldResetManagerSupplier)

Creates a session operation facade service.

Parameters:

sessionUiCoordinatorSupplier - supplier for session UI coordinator service

degradingInventoryTickerSupplier - supplier for degrading inventory ticker service

degradingInventoryServiceSupplier - supplier for degrading inventory service

sharedInventorySyncServiceSupplier - supplier for shared inventory sync service

runHealthCoordinatorServiceSupplier - supplier for run health coordinator service

prepGuiCoordinatorServiceSupplier - supplier for prep GUI coordinator service

actionBarTickerServiceSupplier - supplier for action-bar ticker service

pausedRunStateServiceSupplier - supplier for paused-run state service

worldResetManagerSupplier - supplier for world reset manager

Method Details

startActionBarTask

public void startActionBarTask()

Starts the challenge action-bar task if the UI coordinator is available.

startLobbySidebarTask

public void startLobbySidebarTask()

Starts the lobby sidebar task if the UI coordinator is available.

clearLobbySidebar

public void clearLobbySidebar(org.bukkit.entity.Player player)

Clears the lobby sidebar for the given player when supported.

Parameters:

player - player whose lobby sidebar should be cleared

startDegradingInventoryTask

public void startDegradingInventoryTask(boolean resetSlots)

Starts the degrading-inventory ticker and optionally resets slot state.

Parameters:

resetSlots - true to reset slot allowance before ticker start

enforceInventorySlotCap

public void enforceInventorySlotCap(org.bukkit.entity.Player player)

Enforces the active inventory slot cap for a player when enabled.

Parameters:

player - player whose inventory slot cap should be enforced

clearLockedBarrierSlots

public void clearLockedBarrierSlots(org.bukkit.entity.Player player)

Clears locked barrier slots for a player when degrading inventory is active.

Parameters:

player - player whose locked barriers should be cleared

syncSharedInventoryFromFirstParticipant

public void syncSharedInventoryFromFirstParticipant()

Synchronizes shared inventory from the first online participant snapshot.

snapshotEquippedWearablesForParticipants

public void snapshotEquippedWearablesForParticipants()

Captures wearable snapshots for all active challenge participants.

syncSharedHealthFromFirstParticipant

public void syncSharedHealthFromFirstParticipant()

Synchronizes shared health from the first online participant state.

syncSharedHungerFromMostFilledParticipant

public void syncSharedHungerFromMostFilledParticipant()

Synchronizes shared hunger from the most-satiated online participant.

applyInitialHalfHeartIfEnabled

public void applyInitialHalfHeartIfEnabled()

Applies initial half-heart challenge settings for online participants.

applyInitialHalfHeart

public void applyInitialHalfHeart(org.bukkit.entity.Player player)

Applies the initial half-heart setting to a specific player.

Parameters:

player - player who should receive initial half-heart settings

restoreDefaultMaxHealth

public void restoreDefaultMaxHealth(org.bukkit.entity.Player player)

Restores default max health values for the provided player.

Parameters:

player - player whose max health should be restored

refreshOpenPrepGuis

public void refreshOpenPrepGuis()

Refreshes all currently open preparation GUIs if available.

clearActionBar

public void clearActionBar()

Clears action bars for all currently online players.

clearPausedSnapshots

public void clearPausedSnapshots()

Clears stored paused-run snapshots from the session state service.

stashRunStateForLobby

public void stashRunStateForLobby(org.bukkit.entity.Player player,
 boolean teleportToLobby)

Stashes player run state for lobby transfer with optional teleport.

Parameters:

player - player whose run state should be stashed

teleportToLobby - true to teleport player to lobby after stashing