Class: MobKillQuest

Mob Kill Quest を担当するclassです。

6Fields
1Constructors
12Methods
98Lines
Package
com.example.rankingplugin.miniquests
Source
miniquests/MobKillQuest.java
Kind
class
Roles
自動抽出なし
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る

クラス説明

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

責務と見どころ

重点クラスの詳細解説

Mob Kill Quest を担当するclassです。miniquests パッケージの 小規模クラスで、責務境界の要点を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. MobKillQuest
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. recordKill
    結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
  3. getKey
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  4. getStartTime
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  5. announceStart
    announceStart の主要処理を担当します。
  6. getKillCount
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  7. getRequiredCount
    目標討伐数を返す
  8. getTargetName
    クエスト対象の名を返す（単一対象向け）

内部サブシステムの地図

起動・前提準備

初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。

主なメソッド
MobKillQuest
主なフィールド
key

状態反映と永続化

メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。

主なメソッド
recordKill
主なフィールド
なし

代表フロー詳解

通常運用の中心フロー

  1. recordKill

イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。

反映・保存・終了の流れ

  1. recordKill

結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。

変更時の注意点

  • Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。

フィールド

VisibilityTypeName役割
privateStringkeykey の状態を保持します。
privateSet<EntityType>targetstargets の状態を保持します。
privateintrequiredCountrequiredCount の状態を保持します。
privateLocalDateTimestartTimestartTime の状態を保持します。
privateLocalDateTimeexpireTimeexpireTime の状態を保持します。
privateMap<UUID, Integer>killCountskillCounts の状態を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public MobKillQuest(String key, Set<EntityType> targets, int requiredCount, LocalDateTime startTime, LocalDateTime expireTime)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。主要呼び出しなし

メソッド索引

NameVisibilityKind説明
MobKillQuestpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
getKeypublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getKeypublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getStartTimepublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getStartTimepublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getStartTimepublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
announceStartpublicメソッドannounceStart の主要処理を担当します。
getKillCountpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getRequiredCountpublicメソッド目標討伐数を返す
getTargetNamepublicメソッドクエスト対象の名を返す（単一対象向け）
recordKillpublicメソッド外部から kill イベントを呼び出してカウント
tryCompletepublicメソッドtryComplete の主要処理を担当します。

メソッド詳細

MobKillQuest

コンストラクタpublic
public MobKillQuest(String key, Set<EntityType> targets, int requiredCount, LocalDateTime startTime, LocalDateTime expireTime)

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

引数

  • String key
  • Set<EntityType> targets
  • int requiredCount
  • LocalDateTime startTime
  • LocalDateTime expireTime

throws

なし

主要な呼び出し順

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

getKey

メソッドpublic
public String getKey()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

getKey

メソッドpublic
public String getKey() { return key; } public MiniQuest createInstance(LocalDateTime start, LocalDateTime expire)

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

引数

  • ) { return key; } public MiniQuest createInstance(LocalDateTime start, LocalDateTime expire

throws

なし

主要な呼び出し順

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

getStartTime

メソッドpublic
public LocalDateTime getStartTime()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

getStartTime

メソッドpublic
public LocalDateTime getStartTime() { return startTime; } public LocalDateTime getExpireTime()

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

引数

  • ) { return startTime; } public LocalDateTime getExpireTime(

throws

なし

主要な呼び出し順

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

getStartTime

メソッドpublic
public LocalDateTime getStartTime() { return startTime; } public LocalDateTime getExpireTime() { return expireTime; } public String getDisplayName()

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

引数

  • ) { return startTime; } public LocalDateTime getExpireTime() { return expireTime; } public String getDisplayName(

throws

なし

主要な呼び出し順

streammapnametoLowerCasereplacecollectjoining

announceStart

メソッドpublic
public void announceStart()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

streammapreduceorElsebroadcastMessage

getKillCount

メソッドpublic
public int getKillCount(UUID playerId)

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

引数

  • UUID playerId

throws

なし

主要な呼び出し順

getOrDefault

getRequiredCount

メソッドpublic
public int getRequiredCount()

目標討伐数を返す

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

getTargetName

メソッドpublic
public String getTargetName()

クエスト対象の名を返す（単一対象向け）

引数

  • 引数なし

throws

なし

主要な呼び出し順

streammapnametoLowerCasereplacecollectjoining

recordKill

メソッドpublic
public void recordKill(UUID playerId, EntityType killedType)

外部から kill イベントを呼び出してカウント

引数

  • UUID playerId
  • EntityType killedType

throws

なし

主要な呼び出し順

containsmerge

tryComplete

メソッドpublic
public boolean tryComplete(UUID playerId)

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

引数

  • UUID playerId

throws

なし

主要な呼び出し順

getOrDefault

代表的な処理フロー

  1. getStartTime フロー
    getStartTime → stream → map → name → toLowerCase → replace
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  2. getTargetName フロー
    getTargetName → stream → map → name → toLowerCase → replace
    クエスト対象の名を返す（単一対象向け）
  3. announceStart フロー
    announceStart → stream → map → reduce → orElse → broadcastMessage
    announceStart の主要処理を担当します。
  4. recordKill フロー
    recordKill → contains → merge
    外部から kill イベントを呼び出してカウント
  5. getKillCount フロー
    getKillCount → getOrDefault
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

外部との接点

Web ルート

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

SQL / テーブル

テーブル名の抽出はありませんでした。

関連クラス

補足