起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
主なメソッド
主なフィールド
Class: BingoRewardManager
ビンゴ達成時の報酬を管理し、プレイヤーにタイトルとアイテムドロップを行うクラス
5Fields
1Constructors
6Methods
231Lines
- Package
com.example.rankingplugin.bingo- Source
bingo/BingoRewardManager.java- Kind
class- Roles
- 初期化 / ブートストラップ集約 / 制御
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る
クラス説明
ビンゴ達成時の報酬を管理し、プレイヤーにタイトルとアイテムドロップを行うクラス
責務と見どころ
- 初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。
- 集約 / 制御 — 複数サービスや状態をまとめ、全体制御を行います。
重点クラスの詳細解説
ビンゴ達成時の報酬を管理し、プレイヤーにタイトルとアイテムドロップを行うクラス。bingo パッケージの 小〜中規模クラスで、責務境界の要点を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。
最初に追う読む順番
BingoRewardManager依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。isAllowedReward報酬候補として許可するかどうかisVanillaバニラ判定（IDのnamespaceが minecraft かどうか）computeBaseWeightクラフト回数から「素の重み」を計算する。chooseWeightedRandom重み付きランダムで 1 つ選ぶ。giveRewardsgiveRewards の主要処理を担当します。
内部サブシステムの地図
代表フロー詳解
初期化と起動の流れ
このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
通常運用の中心フロー
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
反映・保存・終了の流れ
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
変更時の注意点
- Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。
フィールド
コンストラクタ / 初期化
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public BingoRewardManager(JavaPlugin plugin, ScoreService scoreService) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | stream → values → filter → collect → toList |
メソッド索引
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| BingoRewardManager | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| isAllowedReward | private | メソッド | 報酬候補として許可するかどうか |
| isVanilla | private | メソッド | バニラ判定（IDのnamespaceが minecraft かどうか） |
| computeBaseWeight | private | メソッド | クラフト回数から「素の重み」を計算する。 |
| chooseWeightedRandom | private | メソッド | 重み付きランダムで 1 つ選ぶ。 |
| giveRewards | public | メソッド | giveRewards の主要処理を担当します。 |
メソッド詳細
BingoRewardManager
public BingoRewardManager(JavaPlugin plugin, ScoreService scoreService)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
引数
JavaPlugin pluginScoreService scoreService
throws
なし
主要な呼び出し順
streamvaluesfiltercollecttoList
isAllowedReward
private boolean isAllowedReward(Material m)報酬候補として許可するかどうか
引数
Material m
throws
なし
主要な呼び出し順
isItemisLegacygetMaxStackSizecontainsnameendsWith
isVanilla
private boolean isVanilla(Material mat)バニラ判定（IDのnamespaceが minecraft かどうか）
引数
Material mat
throws
なし
主要な呼び出し順
equalsgetKeygetNamespace
computeBaseWeight
private int computeBaseWeight(Player player, Material mat)クラフト回数から「素の重み」を計算する。
引数
Player playerMaterial mat
throws
なし
主要な呼び出し順
getStatisticround
chooseWeightedRandom
private Material chooseWeightedRandom(Player player, List<Material> pool)重み付きランダムで 1 つ選ぶ。
引数
Player playerList<Material> pool
throws
なし
主要な呼び出し順
isEmptysizecomputeBaseWeightisVanillaroundnextInt
giveRewards
public void giveRewards(Player player, int lines)giveRewards の主要処理を担当します。
引数
Player playerint lines
throws
なし
主要な呼び出し順
isAllowedRewardisEmptygetLoggerwarningminsizechooseWeightedRandomremove
代表的な処理フロー
- 初期化フロー
BingoRewardManager → stream → values → filter → collect → toList依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 - giveRewards フロー
giveRewards → isAllowedReward → isEmpty → getLogger → warning → mingiveRewards の主要処理を担当します。 - chooseWeightedRandom フロー
chooseWeightedRandom → isEmpty → size → computeBaseWeight → isVanilla → round重み付きランダムで 1 つ選ぶ。 - isAllowedReward フロー
isAllowedReward → isItem → isLegacy → getMaxStackSize → contains → name報酬候補として許可するかどうか - isVanilla フロー
isVanilla → equals → getKey → getNamespaceバニラ判定（IDのnamespaceが minecraft かどうか） - computeBaseWeight フロー
computeBaseWeight → getStatistic → roundクラフト回数から「素の重み」を計算する。
外部との接点
Web ルート
このクラス内に目立つ Web ルート定義は見つかりませんでした。
SQL / テーブル
テーブル名の抽出はありませんでした。
関連クラス
- ScoreService ((root)) — Score Service に関するサービス層・業務処理を担当します。
補足
- メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
- 匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。