EliteMobs/com.magmaguy.elitemobs.instanced.dungeons/DynamicDungeonInstance

DynamicDungeonInstance

public class DynamicDungeonInstance extends DungeonInstance

Constructors

public void DynamicDungeonInstance(ContentPackagesConfigFields contentPackagesConfigFields, Location lobbyLocation, Location startLocation, World world, Player player, String difficultyName, int selectedLevel)

public void DynamicDungeonInstance(ContentPackagesConfigFields contentPackagesConfigFields, Location lobbyLocation, Location startLocation, World world, Collection<Player> initialPlayers, String difficultyName, int selectedLevel)

Properties

selectedLevel

public final int selectedLevel

Inherited properties

cancelled

protected boolean cancelled

contentPackagesConfigFields

public ContentPackagesConfigFields contentPackagesConfigFields

deathBanners

protected final HashMap<Block, InstanceDeathLocation> deathBanners

destroyingMatch

protected boolean destroyingMatch

difficultyID

public String difficultyID

dungeonInstances

public final static Set<DungeonInstance> dungeonInstances

exitLocation

protected Location exitLocation

instancedWorldName

public String instancedWorldName

instances

protected final static HashSet<MatchInstance> instances

levelSync

public int levelSync

lobbyLocation

protected Location lobbyLocation

maxPlayers

protected int maxPlayers

minPlayers

protected int minPlayers

participants

protected HashSet<Player> participants

permission

protected String permission

playerLives

protected HashMap<Player, Integer> playerLives

players

protected HashSet<Player> players

previousPlayerLocations

protected final Map<Player, Location> previousPlayerLocations

runtimeId

public final UUID runtimeId

Distinguishes successive matches that reuse the same world and physical region.

spectators

protected HashSet<Player> spectators

startingParticipantIds

protected final HashSet<UUID> startingParticipantIds

startLocation

protected Location startLocation

state

protected MatchInstance.InstancedRegionState state

world

public World world

Functions

addEntryRoster

protected boolean addEntryRoster(Player player, List<UUID> entryMemberIds, BooleanSupplier admissionAuthorization)

addNewPlayer

public boolean addNewPlayer(Player player)

getSelectedLevel

public int getSelectedLevel()

initializeDynamicWorld

protected static DynamicDungeonInstance initializeDynamicWorld(ContentPackagesConfigFields dynamicDungeonConfigFields, String instancedWorldName, Player player, List<UUID> entryMemberIds, String difficultyName, int selectedLevel)

readyCheckDescription

protected String readyCheckDescription()

setupDynamicDungeon

public static void setupDynamicDungeon(Player player, String dungeonConfigFieldsString, String difficultyName, int selectedLevel)

Inherited functions

abortAdmission

protected void abortAdmission()

Releases an admission reservation if registration could not finish.

addSpectator

public void addSpectator(Player player, boolean wasPlayer)

announce

protected void announce(String message)

authorizesCombatTarget

public final boolean authorizesCombatTarget(Player player, Location targetLocation)

True only when both the active participant and a prospective combat target remain inside this ongoing instance.

cancelScheduledTasks

protected void cancelScheduledTasks()

checkCompletionStatus

public boolean checkCompletionStatus()

cleanupLoadedWorld

protected static void cleanupLoadedWorld(World world)

cleanupUnloadedWorldFolder

protected static void cleanupUnloadedWorldFolder(String instancedWorldName)

cloneWorldFiles

protected static File cloneWorldFiles(ContentPackagesConfigFields instancedDungeonsConfigFields, String instancedWordName)

countdownMatch

public void countdownMatch()

createEncounterBoss

public InstancedBossEntity createEncounterBoss(CustomBossesConfigFields fields, Location location)

Creates a one-life encounter mob owned and cleaned up by this dungeon.

defeat

protected void defeat()

deregisterFailedConstruction

protected final void deregisterFailedConstruction()

De-registers a dungeon instance whose constructor body threw after super() had already registered it and started its scheduler tasks.

destroyMatch

public void destroyMatch()

endMatch

public void endMatch()

getAnyPlayerInstance

public static MatchInstance getAnyPlayerInstance(Player player)

getContentPackagesConfigFields

public ContentPackagesConfigFields getContentPackagesConfigFields()

getDeathBanners

public HashMap<Block, InstanceDeathLocation> getDeathBanners()

getDeathLocationByPlayer

protected InstanceDeathLocation getDeathLocationByPlayer(Player player)

getDifficultyID

public String getDifficultyID()

getDungeonInstances

public static Set<DungeonInstance> getDungeonInstances()

getInstancedWorldName

public String getInstancedWorldName()

getLevelSync

public int getLevelSync()

getParticipants

public HashSet<Player> getParticipants()

getPermission

public String getPermission()

getPlayerInstance

public static MatchInstance getPlayerInstance(Player player)

getPlayers

public HashSet<Player> getPlayers()

getPreviousPlayerLocations

public Map<Player, Location> getPreviousPlayerLocations()

getRemainingLives

public Integer getRemainingLives(Player player)

Returns this participant's remaining dungeon/arena lives, or null when no counter is active.

getResolvedDifficultyID

public String getResolvedDifficultyID()

getRuntimeId

public UUID getRuntimeId()

Distinguishes successive matches that reuse the same world and physical region.

getSpectatorInstance

public static MatchInstance getSpectatorInstance(Player player)

getStartingParticipantIds

public HashSet<UUID> getStartingParticipantIds()

getState

public MatchInstance.InstancedRegionState getState()

getWorld

public World getWorld()

hasMatchDestroyEventFired

protected boolean hasMatchDestroyEventFired()

initializeInstancedWorld

protected static DungeonInstance initializeInstancedWorld(ContentPackagesConfigFields instancedDungeonsConfigFields, String instancedWordName, Player player, String difficultyName)

protected static DungeonInstance initializeInstancedWorld(ContentPackagesConfigFields instancedDungeonsConfigFields, String instancedWordName, Player player, List<UUID> entryMemberIds, String difficultyName)

isAcceptingNewPlayers

public boolean isAcceptingNewPlayers()

The single admission predicate.

isAcceptingSpectator

protected boolean isAcceptingSpectator(Player player, boolean wasPlayer)

isCancelled

public boolean isCancelled()

isDefunct

public boolean isDefunct()

A dungeon instance is also dead once its world removal is scheduled or its world reference is gone; both can precede the registry evictions the base check keys on, and the browser holds these objects for the whole 30–90 second deletion window.

isDestroyingMatch

public boolean isDestroyingMatch()

isInRegion

protected boolean isInRegion(Location location)

isInstanceRemovalScheduled

protected boolean isInstanceRemovalScheduled()

isRelativeLevelSync

protected boolean isRelativeLevelSync()

Checks if the level sync is using a relative value (starts with + or -)

isSpectator

public boolean isSpectator(Player player)

True for a player currently waiting in this match's spectator/downed state.

isWaitingPlayer

public final boolean isWaitingPlayer(Player player)

Admitted players whose entry task has reached the lobby, including the start countdown.

launchEvent

protected static boolean launchEvent(ContentPackagesConfigFields instancedDungeonsConfigFields, String instancedWordName, Player player)

matchesDifficulty

public boolean matchesDifficulty(List<String> filter, String source)

parseLevelSync

protected int parseLevelSync(String rawValue, int contentLevel)

Parses the levelSync value from config.

participantExitLocation

protected Location participantExitLocation(Player player)

Participant exits are independent of the boundary used to eject intruders.

playerDeath

public void playerDeath(Player player)

prepareDungeonEntryRoster

protected static List<UUID> prepareDungeonEntryRoster(Player initiator, ContentPackagesConfigFields configFields)

previousLocationOrExit

protected Location previousLocationOrExit(Player player)

readyCheckDescription

protected static String readyCheckDescription(ContentPackagesConfigFields configFields, String difficultyName)

recalculateLevelSyncForDynamicLevel

protected void recalculateLevelSyncForDynamicLevel(int dynamicLevel)

Recalculates the level sync based on a dynamic level (used by DynamicDungeonInstance).

removeAnyKind

public void removeAnyKind(Player player)

removeInstance

public void removeInstance()

removePlayer

public void removePlayer(Player player)

removeSpectator

public void removeSpectator(Player player)

requestPartyEntry

public boolean requestPartyEntry(Player player)

Player-facing entry boundary.

reserveAdmission

protected boolean reserveAdmission()

Acquired after all cancellable admission preflights, before player registration.

resolveDungeonEntryRoster

protected static List<Player> resolveDungeonEntryRoster(Player initiator, Collection<UUID> memberIds, ContentPackagesConfigFields configFields, DungeonInstance allowedInstance)

revivePlayer

public void revivePlayer(Player player, InstanceDeathLocation deathLocation)

scheduleDelayedDestroy

protected void scheduleDelayedDestroy(long delayTicks)

Schedules a cancellable delayed teardown, reusing the destroyMatchTask slot so it is cancelled by cancelDestroyMatchTask()/cleanupInstanceReferences() like every other instanced-dungeon task.

setupInstancedDungeon

public static void setupInstancedDungeon(Player player, String instancedDungeonConfigFieldsString, String difficultyName)

shutdown

public static void shutdown()

startMatch

protected void startMatch()

victory

protected void victory()