起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
主なフィールド
Class: AwakenedWitherManager
Awakened Wither Manager に関する管理・集約処理を担当します。
23Fields
1Constructors
21Methods
499Lines
- Package
com.example.rankingplugin- Source
AwakenedWitherManager.java- Kind
class- Roles
- イベント駆動DB / 永続化非同期 / スケジューラ初期化 / ブートストラップ集約 / 制御
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る
クラス説明
クラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。
責務と見どころ
- イベント駆動 — Bukkit イベントやコールバックを受けて後続処理を分岐します。
- DB / 永続化 — テーブル作成、読込、更新、削除など永続化責務を持ちます。
- 非同期 / スケジューラ — 重い処理をメインスレッドから切り離し、定期実行も管理します。
- 初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。
- 集約 / 制御 — 複数サービスや状態をまとめ、全体制御を行います。
重点クラスの詳細解説
Awakened Wither Manager に関する管理・集約処理を担当します。(root) パッケージの中でも 499 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。
最初に追う読む順番
AwakenedWitherManager依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。ensureWitherBarAlive不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。startOrUpdateWitherBar定期処理や公開 API の起動地点で、外部から見える挙動がここから立ち上がります。onJoin運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。onWitherDamage運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。onWitherDeath運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。onWitherExplode運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。onWitherBlockChange運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。onWitherSkullHit運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
内部サブシステムの地図
運用中の主ループ
イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。
主なメソッド
状態反映と永続化
メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。
終了処理と掃除
停止時やフロー終端で残る実体・タスク・キャッシュを戻す出口です。
永続化と状態同期
DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。
主なメソッド
代表フロー詳解
初期化と起動の流れ
このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
通常運用の中心フロー
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
反映・保存・終了の流れ
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
変更時の注意点
- Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。
- DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。
- 運用中の主ループと終了処理は対になっています。開始側だけ修正すると停止時の残骸や二重登録が起きやすいため、出口側も同時に確認してください。
外部接点
主な永続化テーブル
SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。
boss_events
フィールド
コンストラクタ / 初期化
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public AwakenedWitherManager(JavaPlugin plugin, ScoreService scoreService, DataSource ds) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | specialBossesEnabled → getLogger → info → getServer → getPluginManager → registerEvents |
メソッド索引
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| specialBossesEnabled | private | メソッド | specialBossesEnabled の主要処理を担当します。 |
| AwakenedWitherManager | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| clamp01 | private | メソッド | clamp01 の主要処理を担当します。 |
| formatRemain | private | メソッド | formatRemain の主要処理を担当します。 |
| startOrUpdateWitherBar | private | メソッド | 初期化と各種登録を行い、機能を有効化します。 |
| stopWitherBar | private | メソッド | 動作中の処理やリソースを安全に停止・解放します。 |
| ensureWitherBarAlive | public | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| updateWitherBarOnce | private | メソッド | タイトルと進捗を1回分計算して反映（残り時間は witherExpireEpochMs を使用） |
| trySpawnAwakenedWither | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| restoreAwakenedWither | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| expireAwakenedWither | private | メソッド | expireAwakenedWither の主要処理を担当します。 |
| cleanupAfterBossGone | private | メソッド | cleanupAfterBossGone の主要処理を担当します。 |
| releaseForcedChunk | private | メソッド | releaseForcedChunk の主要処理を担当します。 |
| onJoin | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| deleteBossEventRecord | private | メソッド | 対象データや登録状態を削除・解除します。 |
| onWitherDamage | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onWitherDeath | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onWitherExplode | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onWitherBlockChange | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onWitherSkullHit | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onChunkLoad | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
メソッド詳細
specialBossesEnabled
private boolean specialBossesEnabled()specialBossesEnabled の主要処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
getConfiggetBoolean
AwakenedWitherManager
public AwakenedWitherManager(JavaPlugin plugin, ScoreService scoreService, DataSource ds)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
引数
JavaPlugin pluginScoreService scoreServiceDataSource ds
throws
なし
主要な呼び出し順
specialBossesEnabledgetLoggerinfogetServergetPluginManagerregisterEventsgetConnectioncreateStatement
clamp01
private static double clamp01(double v)clamp01 の主要処理を担当します。
引数
double v
throws
なし
主要な呼び出し順
目立つ内部呼び出しは抽出されませんでした。
formatRemain
private String formatRemain(long ms)formatRemain の主要処理を担当します。
引数
long ms
throws
なし
主要な呼び出し順
maxformat
startOrUpdateWitherBar
private void startOrUpdateWitherBar()初期化と各種登録を行い、機能を有効化します。
引数
- 引数なし
throws
なし
主要な呼び出し順
ensureWitherBarAlive
stopWitherBar
private void stopWitherBar()動作中の処理やリソースを安全に停止・解放します。
引数
- 引数なし
throws
なし
主要な呼び出し順
cancelremoveAll
ensureWitherBarAlive
public void ensureWitherBarAlive( .jetbrains.annotations.Nullable Player only)必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
引数
.jetbrains.annotations.Nullable Player only
throws
なし
主要な呼び出し順
isValidisDeadstopWitherBarcreateBossBargetOnlinePlayersgetPlayerscontainsaddPlayer
updateWitherBarOnce
private void updateWitherBarOnce()タイトルと進捗を1回分計算して反映（残り時間は witherExpireEpochMs を使用）
引数
- 引数なし
throws
なし
主要な呼び出し順
isValidisDeadstopWitherBarmaxgetHealthgetAttributegetValuegetMaxHealth
trySpawnAwakenedWither
private void trySpawnAwakenedWither()DB への問い合わせまたは更新処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
isDeadrandomgetLoggerinfogetOnlinePlayersisEmptynextIntsize
restoreAwakenedWither
private void restoreAwakenedWither()DB への問い合わせまたは更新処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
valueOfgetServergetPortgetConnectionprepareStatementsetStringexecuteQuerynext
expireAwakenedWither
private void expireAwakenedWither()expireAwakenedWither の主要処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
isDeaddeleteBossEventRecordgetUniqueIdgetLocationgetChunkremovePluginChunkTicketremovecleanupAfterBossGone
cleanupAfterBossGone
private void cleanupAfterBossGone()cleanupAfterBossGone の主要処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
releaseForcedChunkstopWitherBarclearcancel
releaseForcedChunk
private void releaseForcedChunk()releaseForcedChunk の主要処理を担当します。
引数
- 引数なし
throws
なし
主要な呼び出し順
getWorldsetChunkForceLoaded
onJoin
public void onJoin(org.bukkit.event.player.PlayerJoinEvent e)イベント発生時の分岐と後続処理を担当します。
引数
org.bukkit.event.player.PlayerJoinEvent e
throws
なし
主要な呼び出し順
ensureWitherBarAlivegetPlayer
deleteBossEventRecord
private void deleteBossEventRecord(UUID uuid)対象データや登録状態を削除・解除します。
引数
UUID uuid
throws
なし
主要な呼び出し順
getConnectionprepareStatementsetStringvalueOfgetServergetPorttoStringexecuteUpdate
onWitherDamage
public void onWitherDamage(EntityDamageByEntityEvent evt)イベント発生時の分岐と後続処理を担当します。
引数
EntityDamageByEntityEvent evt
throws
なし
主要な呼び出し順
getEntitygetUniqueIdequalsgetDamagergetShootermergegetDamage
onWitherDeath
public void onWitherDeath(EntityDeathEvent evt)イベント発生時の分岐と後続処理を担当します。
引数
EntityDeathEvent evt
throws
なし
主要な呼び出し順
getEntitygetScoreboardTagscontainsgetUniqueIdequalscancelmaxgetDrops
onWitherExplode
public void onWitherExplode(EntityExplodeEvent e)イベント発生時の分岐と後続処理を担当します。
引数
EntityExplodeEvent e
throws
なし
主要な呼び出し順
getEntityequalsblockListclear
onWitherBlockChange
public void onWitherBlockChange(EntityChangeBlockEvent e)イベント発生時の分岐と後続処理を担当します。
引数
EntityChangeBlockEvent e
throws
なし
主要な呼び出し順
getEntityequalssetCancelled
onWitherSkullHit
public void onWitherSkullHit(ProjectileHitEvent e)イベント発生時の分岐と後続処理を担当します。
引数
ProjectileHitEvent e
throws
なし
主要な呼び出し順
getEntitygetTypesetCancelled
onChunkLoad
public void onChunkLoad(ChunkLoadEvent e)イベント発生時の分岐と後続処理を担当します。
引数
ChunkLoadEvent e
throws
なし
主要な呼び出し順
getChunkgetEntitiesgetScoreboardTagscontainsgetPersistentDataContainerequalscurrentTimeMillisdeleteBossEventRecord
代表的な処理フロー
- 初期化フロー
AwakenedWitherManager → specialBossesEnabled → getLogger → info → getServer → getPluginManager依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 - onChunkLoad フロー
onChunkLoad → getChunk → getEntities → getScoreboardTags → contains → getPersistentDataContainerイベント発生時の分岐と後続処理を担当します。 - onWitherDeath フロー
onWitherDeath → getEntity → getScoreboardTags → contains → getUniqueId → equalsイベント発生時の分岐と後続処理を担当します。 - onWitherDamage フロー
onWitherDamage → getEntity → getUniqueId → equals → getDamager → getShooterイベント発生時の分岐と後続処理を担当します。 - onWitherExplode フロー
onWitherExplode → getEntity → equals → blockList → clearイベント発生時の分岐と後続処理を担当します。 - onWitherBlockChange フロー
onWitherBlockChange → getEntity → equals → setCancelledイベント発生時の分岐と後続処理を担当します。
外部との接点
Web ルート
このクラス内に目立つ Web ルート定義は見つかりませんでした。
SQL / テーブル
boss_events
関連クラス
- AttributeModifierCompat (compat) — 1.21.11 / 26.1+ 両対応向けの AttributeModifier 互換ヘルパ。
- ScoreService ((root)) — Score Service に関するサービス層・業務処理を担当します。
補足
- メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
- 匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。