半径Rをチャンク単位で“雲海の白い地面”を少しずつ配置するタスク

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

クラス説明

半径Rをチャンク単位で“雲海の白い地面”を少しずつ配置するタスク

責務と見どころ

重点クラスの詳細解説

半径Rをチャンク単位で“雲海の白い地面”を少しずつ配置するタスク。fantasy.task パッケージの 小〜中規模クラスで、スケジューラを確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. DreamGroundTask
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. enqueueDisc
    enqueueDisc の主要処理を担当します。
  3. step
    step の主要処理を担当します。
  4. isDone
    条件判定を行い、後続処理の分岐に使える真偽値を返します。
  5. pick
    pick の主要処理を担当します。

内部サブシステムの地図

起動・前提準備

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

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

代表フロー詳解

初期化と起動の流れ

  1. DreamGroundTask

このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。

通常運用の中心フロー

  1. DreamGroundTask
  2. enqueueDisc
  3. step
  4. isDone
  5. pick

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

反映・保存・終了の流れ

  1. DreamGroundTask
  2. enqueueDisc
  3. step
  4. isDone
  5. pick

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

変更時の注意点

フィールド

VisibilityTypeName役割
privateWorldww の状態を保持します。
privateintgroundYgroundY の状態を保持します。
privateQueue<Vector>chunkschunks の状態を保持します。
privateQueue<Location>voxelsvoxels の状態を保持します。
privateRandomseedRandseedRand の状態を保持します。
privateintplatesLeftInChunkplatesLeftInChunk の状態を保持します。
privateMaterial[]BASESBASES の状態を保持します。
privateMaterial[]ACCENTSACCENTS の状態を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public DreamGroundTask(World world, int radiusBlocks, int groundY)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。max → getSpawnLocation → getBlockX → getBlockZ → sort → comparingLong

メソッド索引

NameVisibilityKind説明
DreamGroundTaskpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
steppublicメソッドstep の主要処理を担当します。
isDonepublicメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
enqueueDiscprivateメソッドenqueueDisc の主要処理を担当します。
pickprivateメソッドpick の主要処理を担当します。

メソッド詳細

DreamGroundTask

コンストラクタpublic
public DreamGroundTask(World world, int radiusBlocks, int groundY)

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

引数

throws

なし

主要な呼び出し順

maxgetSpawnLocationgetBlockXgetBlockZsortcomparingLonggetXgetZ

step

メソッドpublic
public int step(int budget)

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

引数

throws

なし

主要な呼び出し順

isEmptypollgetBlockAtgetTypeisAirpicksetTypenextInt

isDone

メソッドpublic
public boolean isDone()

条件判定を行い、後続処理の分岐に使える真偽値を返します。

引数

throws

なし

主要な呼び出し順

isEmpty

enqueueDisc

メソッドprivate
private void enqueueDisc(Location c, int r, Random rand)

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

引数

throws

なし

主要な呼び出し順

getBlockXgetBlockZoffernextInt

pick

メソッドprivate
private Material pick(Location l)

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

引数

throws

なし

主要な呼び出し順

absgetBlockXgetBlockZ

代表的な処理フロー

  1. 初期化フロー
    DreamGroundTask → max → getSpawnLocation → getBlockX → getBlockZ → sort
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. step フロー
    step → isEmpty → poll → getBlockAt → getType → isAir
    step の主要処理を担当します。
  3. enqueueDisc フロー
    enqueueDisc → getBlockX → getBlockZ → offer → nextInt
    enqueueDisc の主要処理を担当します。
  4. pick フロー
    pick → abs → getBlockX → getBlockZ
    pick の主要処理を担当します。
  5. isDone フロー
    isDone → isEmpty
    条件判定を行い、後続処理の分岐に使える真偽値を返します。

外部との接点

Web ルート

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

SQL / テーブル

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

関連クラス

補足