Class: AwakenedWardenManager

Awakened Warden Manager に関する管理・集約処理を担当します。

24Fields
1Constructors
28Methods
758Lines
Package
com.example.rankingplugin
Source
AwakenedWardenManager.java
Kind
class
Roles
イベント駆動DB / 永続化非同期 / スケジューラ初期化 / ブートストラップ集約 / 制御
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る

クラス説明

クラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。

責務と見どころ

重点クラスの詳細解説

Awakened Warden Manager に関する管理・集約処理を担当します。(root) パッケージの中でも 758 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。

最初に追う読む順番

  1. AwakenedWardenManager
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureWardenBarAlive
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. startDeepDarkSearch
    定期処理や公開 API の起動地点で、外部から見える挙動がここから立ち上がります。
  4. startOrUpdateWardenBar
    定期処理や公開 API の起動地点で、外部から見える挙動がここから立ち上がります。
  5. spawnMinionWardens
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  6. onJoin
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
  7. onWardenDamage
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
  8. onWardenDeath
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
  9. onWardenExplode
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。

内部サブシステムの地図

代表フロー詳解

変更時の注意点

  • Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。
  • DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。
  • 運用中の主ループと終了処理は対になっています。開始側だけ修正すると停止時の残骸や二重登録が起きやすいため、出口側も同時に確認してください。

外部接点

主な永続化テーブル

SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。

boss_events

フィールド

VisibilityTypeName役割
privateJavaPluginpluginプラグイン本体参照です。
privateScoreServicescoreService関連サービスへの参照です。
privateDataSourcedsDB 接続元を保持します。
privateWardenactiveWarden現在アクティブな覚醒ウォーデン
privateintactiveLevelactiveLevel の状態を保持します。
privateBukkitTaskdespawnTask非同期処理やスケジューラ制御に使うハンドルです。
privateBossBarwardenBarボスバー
privateBukkitTaskwardenBarTask非同期処理やスケジューラ制御に使うハンドルです。
privateMap<UUID, Double>damageMapダメージ集計
privatebooleanminionsSummonedミニオン管理
privateList<Warden>minionWardensminionWardens の状態を保持します。
privateStringforcedWorldNameスポーンチャンク強制読み込み用（解除に使用）
privateint forcedChunkX,forcedChunkZforcedChunkZ の状態を保持します。
privatebooleanforcedChunkActiveforcedChunkActive の状態を保持します。
privateNamespacedKeyKEY_EXPIREKEY_EXPIRE の状態を保持します。
privateNamespacedKeyKEY_TYPEKEY_TYPE の状態を保持します。
privatedoubleBASE_HPBASE_HP の状態を保持します。
privatedoubleBASE_ARMORBASE_ARMOR の状態を保持します。
privatedoubleBASE_ATTACKBASE_ATTACK の状態を保持します。
privatedoubleHP_PER_LVHP_PER_LV の状態を保持します。
privatedoubleARMOR_PER_LVARMOR_PER_LV の状態を保持します。
privatedoubleATTACK_PER_LVATTACK_PER_LV の状態を保持します。
privatelongBASE_REWARDBASE_REWARD の状態を保持します。
privatelongREWARD_PER_LVREWARD_PER_LV の状態を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public AwakenedWardenManager(JavaPlugin plugin, ScoreService scoreService, DataSource ds)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。specialBossesEnabled → getLogger → info → getConnection → createStatement → executeUpdate

メソッド索引

NameVisibilityKind説明
specialBossesEnabledprivateメソッドspecialBossesEnabled の主要処理を担当します。
AwakenedWardenManagerpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
updateWardenBarOnceprivateメソッド状態を永続化または更新し、最新状態へ反映します。
ensureWardenBarAlivepublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
onJoinpublicイベント処理イベント発生時の分岐と後続処理を担当します。
findDeepDarkFloorNearprivateメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
probeColumnForDeepDarkprivateメソッド1本の (x,z) 柱で y を降りながら Deep Dark を探し、2ブロック頭上が空く床を返す
startDeepDarkSearchprivateメソッドDeep Dark 探索（同期・分割実行）。
probeColumnForDeepDarkFastprivateメソッド(x,z) 柱の Deep Dark 判定を “高速に” 行い、足場（頭上2マス空き）を返す。
trySpawnAwakenedWardenprivateメソッドDB への問い合わせまたは更新処理を担当します。
restoreAwakenedWardenprivateメソッドDB への問い合わせまたは更新処理を担当します。
clamp01privateメソッドclamp01 の主要処理を担当します。
formatRemainprivateメソッドformatRemain の主要処理を担当します。
startOrUpdateWardenBarprivateメソッド初期化と各種登録を行い、機能を有効化します。
stopWardenBarprivateメソッド動作中の処理やリソースを安全に停止・解放します。
hasNearbyCombatPlayerprivateメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
onWardenDamagepublicイベント処理イベント発生時の分岐と後続処理を担当します。
onWardenDeathpublicイベント処理イベント発生時の分岐と後続処理を担当します。
expireAwakenedWardenprivateメソッドexpireAwakenedWarden の主要処理を担当します。
cleanupAfterBossGoneprivateメソッドcleanupAfterBossGone の主要処理を担当します。
releaseForcedChunkprivateメソッドreleaseForcedChunk の主要処理を担当します。
deleteBossEventRecordprivateメソッド対象データや登録状態を削除・解除します。
onWardenExplodepublicイベント処理イベント発生時の分岐と後続処理を担当します。
onWardenBlockChangepublicイベント処理イベント発生時の分岐と後続処理を担当します。
onProjectileHitpublicイベント処理イベント発生時の分岐と後続処理を担当します。
onChunkLoadpublicイベント処理イベント発生時の分岐と後続処理を担当します。
spawnMinionWardensprivateメソッドspawnMinionWardens の主要処理を担当します。
findNearestPlayerprivateメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

メソッド詳細

specialBossesEnabled

メソッドprivate
private boolean specialBossesEnabled()

specialBossesEnabled の主要処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

getConfiggetBoolean

AwakenedWardenManager

コンストラクタpublic
public AwakenedWardenManager(JavaPlugin plugin, ScoreService scoreService, DataSource ds)

依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。

引数

  • JavaPlugin plugin
  • ScoreService scoreService
  • DataSource ds

throws

なし

主要な呼び出し順

specialBossesEnabledgetLoggerinfogetConnectioncreateStatementexecuteUpdateboss_eventssevere

updateWardenBarOnce

メソッドprivate
private void updateWardenBarOnce()

状態を永続化または更新し、最新状態へ反映します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

maxgetHealthgetAttributegetBaseValuegetPersistentDataContainercurrentTimeMillisgetLocationformat

ensureWardenBarAlive

メソッドpublic
public void ensureWardenBarAlive( .jetbrains.annotations.Nullable Player only)

必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。

引数

  • .jetbrains.annotations.Nullable Player only

throws

なし

主要な呼び出し順

isDeadcreateBossBargetOnlinePlayersgetPlayerscontainsaddPlayerupdateWardenBarOncesetVisible

onJoin

イベント処理public
public void onJoin(org.bukkit.event.player.PlayerJoinEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

  • org.bukkit.event.player.PlayerJoinEvent e

throws

なし

主要な呼び出し順

ensureWardenBarAlivegetPlayer

findDeepDarkFloorNear

メソッドprivate
private Location findDeepDarkFloorNear(Location center, int radiusBlocks)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

  • Location center
  • int radiusBlocks

throws

なし

主要な呼び出し順

getWorldgetBlockXgetBlockZmaxgetMinHeightmingetMaxHeightprobeColumnForDeepDark

probeColumnForDeepDark

メソッドprivate
private Location probeColumnForDeepDark(World w, int x, int z, int minY, int maxY)

1本の (x,z) 柱で y を降りながら Deep Dark を探し、2ブロック頭上が空く床を返す

引数

  • World w
  • int x
  • int z
  • int minY
  • int maxY

throws

なし

主要な呼び出し順

getBiomegetBlockAtgetTypeisSolidisAir

startDeepDarkSearch

メソッドprivate
private void startDeepDarkSearch(Location center, int radiusBlocks, java.util.function.Consumer<Location> onFound)

Deep Dark 探索（同期・分割実行）。

引数

  • Location center
  • int radiusBlocks
  • java.util.function.Consumer<Location> onFound

throws

なし

主要な呼び出し順

getWorldgetBlockXgetBlockZmaxgetMinHeightmingetMaxHeightgetConfig

probeColumnForDeepDarkFast

メソッドprivate
private Location probeColumnForDeepDarkFast(World w, int x, int z, int minY, int maxY)

(x,z) 柱の Deep Dark 判定を “高速に” 行い、足場（頭上2マス空き）を返す。

引数

  • World w
  • int x
  • int z
  • int minY
  • int maxY

throws

なし

主要な呼び出し順

maxmingetBiomegetBlockAtgetTypeisSolidisAir

trySpawnAwakenedWarden

メソッドprivate
private void trySpawnAwakenedWarden()

DB への問い合わせまたは更新処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

isDeadrandomgetLoggerinfogetOnlinePlayersisEmptynextIntsize

restoreAwakenedWarden

メソッドprivate
private void restoreAwakenedWarden()

DB への問い合わせまたは更新処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

valueOfgetServergetPortgetConnectionprepareStatementsetStringexecuteQuerynext

clamp01

メソッドprivatestatic
private static double clamp01(double v)

clamp01 の主要処理を担当します。

引数

  • double v

throws

なし

主要な呼び出し順

目立つ内部呼び出しは抽出されませんでした。

formatRemain

メソッドprivate
private String formatRemain(long ms)

formatRemain の主要処理を担当します。

引数

  • long ms

throws

なし

主要な呼び出し順

maxformat

startOrUpdateWardenBar

メソッドprivate
private void startOrUpdateWardenBar()

初期化と各種登録を行い、機能を有効化します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

ensureWardenBarAlive

stopWardenBar

メソッドprivate
private void stopWardenBar()

動作中の処理やリソースを安全に停止・解放します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

cancelgetOnlinePlayersremovePlayer

hasNearbyCombatPlayer

メソッドprivate
private boolean hasNearbyCombatPlayer(Location center, double radius)

条件判定を行い、後続処理の分岐に使える真偽値を返します。

引数

  • Location center
  • double radius

throws

なし

主要な呼び出し順

getWorldgetOnlinePlayersequalsisDeadgetGameModegetLocationdistanceSquared

onWardenDamage

イベント処理public
public void onWardenDamage(EntityDamageByEntityEvent evt)

イベント発生時の分岐と後続処理を担当します。

引数

  • EntityDamageByEntityEvent evt

throws

なし

主要な呼び出し順

getEntityequalsgetDamagergetShootermergegetUniqueIdgetDamagegetHealth

onWardenDeath

イベント処理public
public void onWardenDeath(EntityDeathEvent evt)

イベント発生時の分岐と後続処理を担当します。

引数

  • EntityDeathEvent evt

throws

なし

主要な呼び出し順

getEntitygetScoreboardTagscontainsequalscancelmaxgetDropsentrySet

expireAwakenedWarden

メソッドprivate
private void expireAwakenedWarden()

expireAwakenedWarden の主要処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

isDeadcleanupAfterBossGonedeleteBossEventRecordgetUniqueIdremovebroadcastMessage

cleanupAfterBossGone

メソッドprivate
private void cleanupAfterBossGone()

cleanupAfterBossGone の主要処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

stopWardenBarisDeadremovecleargetLocationgetChunkremovePluginChunkTicketreleaseForcedChunk

releaseForcedChunk

メソッドprivate
private void releaseForcedChunk()

releaseForcedChunk の主要処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

getWorldsetChunkForceLoaded

deleteBossEventRecord

メソッドprivate
private void deleteBossEventRecord(UUID uuid)

対象データや登録状態を削除・解除します。

引数

  • UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetStringvalueOfgetServergetPorttoStringexecuteUpdate

onWardenExplode

イベント処理public
public void onWardenExplode(EntityExplodeEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

  • EntityExplodeEvent e

throws

なし

主要な呼び出し順

getEntityequalsblockListclear

onWardenBlockChange

イベント処理public
public void onWardenBlockChange(EntityChangeBlockEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

  • EntityChangeBlockEvent e

throws

なし

主要な呼び出し順

getEntityequalssetCancelled

onProjectileHit

イベント処理public
public void onProjectileHit(ProjectileHitEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

  • ProjectileHitEvent e

throws

なし

主要な呼び出し順

getEntitygetShooterequalssetCancelled

onChunkLoad

イベント処理public
public void onChunkLoad(ChunkLoadEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

  • ChunkLoadEvent e

throws

なし

主要な呼び出し順

getChunkgetEntitiesgetScoreboardTagscontainsgetPersistentDataContainerequalscurrentTimeMillisdeleteBossEventRecord

spawnMinionWardens

メソッドprivate
private void spawnMinionWardens()

spawnMinionWardens の主要処理を担当します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

getWorldgetAttributegetBaseValuegetLoggerinforandomgetLocationclone

findNearestPlayer

メソッドprivate
private Player findNearestPlayer(Location location)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

  • Location location

throws

なし

主要な呼び出し順

getOnlinePlayersgetLocationdistanceSquared

代表的な処理フロー

  1. 初期化フロー
    AwakenedWardenManager → specialBossesEnabled → getLogger → info → getConnection → createStatement
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. onChunkLoad フロー
    onChunkLoad → getChunk → getEntities → getScoreboardTags → contains → getPersistentDataContainer
    イベント発生時の分岐と後続処理を担当します。
  3. onWardenDamage フロー
    onWardenDamage → getEntity → equals → getDamager → getShooter → merge
    イベント発生時の分岐と後続処理を担当します。
  4. onWardenDeath フロー
    onWardenDeath → getEntity → getScoreboardTags → contains → equals → cancel
    イベント発生時の分岐と後続処理を担当します。
  5. onProjectileHit フロー
    onProjectileHit → getEntity → getShooter → equals → setCancelled
    イベント発生時の分岐と後続処理を担当します。
  6. onWardenExplode フロー
    onWardenExplode → getEntity → equals → blockList → clear
    イベント発生時の分岐と後続処理を担当します。

外部との接点

Web ルート

このクラス内に目立つ Web ルート定義は見つかりませんでした。

SQL / テーブル

boss_events

関連クラス

補足