Class: AdvancementsManager

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

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

クラス説明

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

責務と見どころ

重点クラスの詳細解説

Advancements Manager に関する管理・集約処理を担当します。progress パッケージの 小〜中規模クラスで、責務境界の要点を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. AdvancementsManager
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureRoot
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. ensureAchievement
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  4. ensureRootAward
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  5. loadWithIconFallback
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  6. syncProgress
    現在値→リング同期（SLICES=1 なら 0/1 表示）
  7. root
    root の主要処理を担当します。
  8. escape
    escape の主要処理を担当します。

内部サブシステムの地図

入口 API と対象解決

外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。

主なメソッド
loadWithIconFallback
主なフィールド
plugin

代表フロー詳解

変更時の注意点

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

フィールド

VisibilityTypeName役割
privateJavaPluginpluginプラグイン本体参照です。
privateintSLICESSLICES の状態を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public AdvancementsManager(JavaPlugin plugin)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。ensureRoot

メソッド索引

NameVisibilityKind説明
AdvancementsManagerpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
rootpublicメソッドroot の主要処理を担当します。
ensureRootpublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
ensureAchievementpublicメソッド親つき・SLICES 分割つきの子実績を作成（id→item フォールバックつき）
escapeprivateメソッドescape の主要処理を担当します。
tryLoadAdvprivateメソッドtryLoadAdv の主要処理を担当します。
loadWithIconFallbackprivateメソッドicon 部だけプレースホルダにして、1.
keyOfpublicメソッドkeyOf の主要処理を担当します。
ensureRootAwardpublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
syncProgresspublicメソッド現在値→リング同期（SLICES=1 なら 0/1 表示）

メソッド詳細

AdvancementsManager

コンストラクタpublic
public AdvancementsManager(JavaPlugin plugin)

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

引数

  • JavaPlugin plugin

throws

なし

主要な呼び出し順

ensureRoot

root

メソッドpublic
public NamespacedKey root()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

ensureRoot

メソッドpublic
public void ensureRoot()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

getAdvancementrootloadWithIconFallback

ensureAchievement

メソッドpublic
public void ensureAchievement(String id, String title, String description, String iconItem, NamespacedKey parent)

親つき・SLICES 分割つきの子実績を作成（id→item フォールバックつき）

引数

  • String id
  • String title
  • String description
  • String iconItem
  • NamespacedKey parent

throws

なし

主要な呼び出し順

keyOfgetAdvancementappendformattedtoStringescapeloadWithIconFallback

escape

メソッドprivatestatic
private static String escape(String s)

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

引数

  • String s

throws

なし

主要な呼び出し順

replace

tryLoadAdv

メソッドprivate
private boolean tryLoadAdv(NamespacedKey key, String json)

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

引数

  • NamespacedKey key
  • String json

throws

なし

主要な呼び出し順

getUnsafeloadAdvancementgetLoggerwarning

loadWithIconFallback

メソッドprivate
private void loadWithIconFallback(NamespacedKey key, String jsonTemplate, String iconIdWithNs)

icon 部だけプレースホルダにして、1.

引数

  • NamespacedKey key
  • String jsonTemplate
  • String iconIdWithNs

throws

なし

主要な呼び出し順

getUnsaferemoveAdvancementreplacetryLoadAdvgetLoggerwarning

keyOf

メソッドpublic
public NamespacedKey keyOf(String id)

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

引数

  • String id

throws

なし

主要な呼び出し順

toLowerCase

ensureRootAward

メソッドpublic
public void ensureRootAward(Player p)

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

引数

  • Player p

throws

なし

主要な呼び出し順

getAdvancementrootgetAdvancementProgressgetAwardedCriteriacontainsawardCriteria

syncProgress

メソッドpublic
public void syncProgress(Player p, String id, int current, int target)

現在値→リング同期（SLICES=1 なら 0/1 表示）

引数

  • Player p
  • String id
  • int current
  • int target

throws

なし

主要な呼び出し順

getAdvancementkeyOfminfloorgetAdvancementProgressgetAwardedCriteriacontainsawardCriteria

代表的な処理フロー

  1. 初期化フロー
    AdvancementsManager → ensureRoot
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. loadWithIconFallback フロー
    loadWithIconFallback → getUnsafe → removeAdvancement → replace → tryLoadAdv → getLogger
    icon 部だけプレースホルダにして、1.
  3. ensureAchievement フロー
    ensureAchievement → keyOf → getAdvancement → append → formatted → toString
    親つき・SLICES 分割つきの子実績を作成（id→item フォールバックつき）
  4. ensureRootAward フロー
    ensureRootAward → getAdvancement → root → getAdvancementProgress → getAwardedCriteria → contains
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  5. ensureRoot フロー
    ensureRoot → getAdvancement → root → loadWithIconFallback
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  6. syncProgress フロー
    syncProgress → getAdvancement → keyOf → min → floor → getAdvancementProgress
    現在値→リング同期（SLICES=1 なら 0/1 表示）

外部との接点

Web ルート

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

SQL / テーブル

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

関連クラス

補足