起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
毎日ランダム時間に巨人ボスをスポーン・管理するクラス。
com.example.rankingplugin.bossboss/GiantBossManager.javaclass毎日ランダム時間に巨人ボスをスポーン・管理するクラス。 データベースで設定を管理し、プレイヤー別ダメージを記録、討伐時にスコアを付与。
毎日ランダム時間に巨人ボスをスポーン・管理するクラス。boss パッケージの中でも 1050 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。
GiantBossManagercreateTablesloadBaseDamageFromDBspawnBossonPlayerJoinonBossAnyDamageonBossDamageonBossDeathrecordPlayerDamage初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。
イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。
メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。
DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。
このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public GiantBossManager(JavaPlugin plugin, DataSource ds, ScoreService scoreService) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | specialBossesEnabled → getLogger → info → getServer → getPluginManager → getPlugin |
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| specialBossesEnabled | private | メソッド | specialBossesEnabled の主要処理を担当します。 |
| GiantBossManager | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| beginArenaKeep | private | メソッド | beginArenaKeep の主要処理を担当します。 |
| endArenaKeep | private | メソッド | endArenaKeep の主要処理を担当します。 |
| tryGetDomeRadius | private | メソッド | tryGetDomeRadius の主要処理を担当します。 |
| purgeOldGiants | private | メソッド | purgeOldGiants の主要処理を担当します。 |
| onPlayerJoin | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| getBossLevel | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| createTables | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| hasSpawnRecord | private | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| scheduleNextSpawn | private | メソッド | 翌日12:00〜23:59間のランダム時間にスポーンをスケジュール |
| scheduleDbPolling | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| spawnBoss | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| findSpawnLocation | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| clearDamageData | private | メソッド | プレイヤー別ダメージ記録をクリア |
| onBossAnyDamage | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onBossDamage | public | イベント処理 | ダメージイベントで記録 |
| damagePlayerInternal | private | メソッド | damagePlayerInternal の主要処理を担当します。 |
| loadBaseDamageFromDB | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| scheduleBaseDamageRefresh | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| currentTenthStep | private | メソッド | currentTenthStep の主要処理を担当します。 |
| computeBossAttackDamage | private | メソッド | computeBossAttackDamage の主要処理を担当します。 |
| onBossDeath | public | イベント処理 | 討伐時にスコア付与 |
| removeBossBar | private | メソッド | 対象データや登録状態を削除・解除します。 |
| getNextMidnight | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| despawnLocalBoss | private | メソッド | despawnLocalBoss の主要処理を担当します。 |
| scheduleMidnightCleanup | private | メソッド | 日付が変わったらボスを消す |
| recordPlayerDamage | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
private boolean specialBossesEnabled()specialBossesEnabled の主要処理を担当します。
なし
public GiantBossManager(JavaPlugin plugin, DataSource ds, ScoreService scoreService)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
JavaPlugin pluginDataSource dsScoreService scoreServiceなし
private void beginArenaKeep()beginArenaKeep の主要処理を担当します。
なし
private void endArenaKeep()endArenaKeep の主要処理を担当します。
なし
private int tryGetDomeRadius(World w, int fallback)tryGetDomeRadius の主要処理を担当します。
World wint fallbackなし
private void purgeOldGiants()purgeOldGiants の主要処理を担当します。
なし
public void onPlayerJoin(PlayerJoinEvent e)イベント発生時の分岐と後続処理を担当します。
PlayerJoinEvent eなし
private int getBossLevel()必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
なし
private void createTables()DB への問い合わせまたは更新処理を担当します。
なし
private boolean hasSpawnRecord(LocalDate date)条件判定を行い、後続処理の分岐に使える真偽値を返します。
LocalDate dateなし
private void scheduleNextSpawn()翌日12:00〜23:59間のランダム時間にスポーンをスケジュール
なし
private void scheduleDbPolling()DB への問い合わせまたは更新処理を担当します。
なし
private void spawnBoss()DB への問い合わせまたは更新処理を担当します。
なし
private Location findSpawnLocation(double minRadius, double maxRadius, World world)必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
double minRadiusdouble maxRadiusWorld worldなし
private void clearDamageData()プレイヤー別ダメージ記録をクリア
なし
public void onBossAnyDamage(EntityDamageEvent e)イベント発生時の分岐と後続処理を担当します。
EntityDamageEvent eなし
public void onBossDamage(EntityDamageByEntityEvent e)ダメージイベントで記録
EntityDamageByEntityEvent eなし
private void damagePlayerInternal(Player target, double damage)damagePlayerInternal の主要処理を担当します。
Player targetdouble damageなし
private double loadBaseDamageFromDB()必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
なし
private void scheduleBaseDamageRefresh()DB への問い合わせまたは更新処理を担当します。
なし
private int currentTenthStep()currentTenthStep の主要処理を担当します。
なし
private double computeBossAttackDamage()computeBossAttackDamage の主要処理を担当します。
なし
public void onBossDeath(EntityDeathEvent e)討伐時にスコア付与
EntityDeathEvent eなし
private void removeBossBar()対象データや登録状態を削除・解除します。
なし
private LocalDateTime getNextMidnight()必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
なし
private void despawnLocalBoss()despawnLocalBoss の主要処理を担当します。
なし
private void scheduleMidnightCleanup()日付が変わったらボスを消す
なし
private void recordPlayerDamage(String uuid, double d)DB への問い合わせまたは更新処理を担当します。
String uuiddouble dなし
GiantBossManager → specialBossesEnabled → getLogger → info → getServer → getPluginManageronBossAnyDamage → getEntity → getUniqueId → equals → getFinalDamage → maxonBossDamage → getDamager → getUniqueId → equals → getEntity → hasMetadataonBossDeath → getEntity → getUniqueId → equals → max → getDropsonPlayerJoin → isDead → addPlayer → getPlayerloadBaseDamageFromDB → getConnection → prepareStatement → setDate → valueOf → now