Class: FairGroundTask | RankingPlugin Wiki

円盤（R半径）の床を Y 高さに敷き詰める。

16Fields

1Constructors

15Methods

325Lines

Package: com.example.rankingplugin.fantasy.task
Source: fantasy/task/FairGroundTask.java
Kind: class
Roles: 非同期 / スケジューラ初期化 / ブートストラップ

このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。全クラス章立てガイドを見る

クラス説明

円盤（R半径）の床を Y 高さに敷き詰める。
- 1tick内で「訪問セル数」と「配置セル数」の2つの予算を厳守（フリーズ防止）
- チャンクロード判定をチャンク単位でキャッシュ（軽量化）
- 未ロードチャンク上のセルは deferred に積んで後で消化（穴埋め）
- MilestonedTask への返値＝「実際に置けた数」なので、100%で置き残しが出なくなる

責務と見どころ

非同期 / スケジューラ — 重い処理をメインスレッドから切り離し、定期実行も管理します。
初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。

重点クラスの詳細解説

円盤（R半径）の床を Y 高さに敷き詰める。fantasy.task パッケージの小〜中規模クラスで、スケジューラを確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

FairGroundTask
依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
ensureChunkLoadedAsync
不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
ensureChunkLoadedCache
不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
releaseTickets
releaseTickets の主要処理を担当します。
exactCellCount
半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）
step
step の主要処理を担当します。
isDone
条件判定を行い、後続処理の分岐に使える真偽値を返します。
pmod
pmod の主要処理を担当します。

内部サブシステムの地図

起動・前提準備

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

主なメソッド

FairGroundTask ensureChunkLoadedCache ensureChunkLoadedAsync

主なフィールド

plugin

非同期処理と定期実行

メインスレッド境界とバックグラウンド処理が交差します。重い処理やタイミング起因の不具合を追うときの要所です。

主なメソッド

ensureChunkLoadedAsync releaseTickets

主なフィールド

なし

代表フロー詳解

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

通常運用の中心フロー

FairGroundTask
ensureChunkLoadedAsync
ensureChunkLoadedCache
releaseTickets
exactCellCount
step

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

反映・保存・終了の流れ

FairGroundTask
ensureChunkLoadedAsync
ensureChunkLoadedCache
releaseTickets
exactCellCount

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

変更時の注意点

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

フィールド

Visibility	Type	Name	役割
`private`	`JavaPlugin`	`plugin`	プラグイン本体参照です。
`private`	`World`	`world`	world の状態を保持します。
`private`	`int cx, cz, y, r,`	`r2`	r2 の状態を保持します。
`private`	`int[]`	`halfWidth`	halfWidth の状態を保持します。
`private`	`int`	`dz`	dz の状態を保持します。
`private`	`int`	`x`	x の状態を保持します。
`private`	`int`	`xEnd`	xEnd の状態を保持します。
`private`	`Deque<Long>`	`deferred`	deferred の状態を保持します。
`private`	`int`	`DEFER_LIMIT`	DEFER_LIMIT の状態を保持します。
`private`	`Set<Long>`	`inflight`	inflight の状態を保持します。
`private`	`int`	`lastChunkX`	lastChunkX の状態を保持します。
`private`	`boolean`	`lastChunkLoaded`	lastChunkLoaded の状態を保持します。
`private`	`Set<Long>`	`ticketed`	ticketed の状態を保持します。
`private`	`boolean`	`ticketsReleased`	ticketsReleased の状態を保持します。
`private`	`Phase`	`phase`	phase の状態を保持します。
`private`	`int pDz, pX,`	`pXEnd`	pXEnd の状態を保持します。

コンストラクタ / 初期化

Signature	説明	主要呼び出し
`public FairGroundTask(JavaPlugin plugin,Location center, int radius, int y)`	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。	getWorld → getBlockX → getBlockZ → max → floor → sqrt

メソッド索引

Name	Visibility	Kind	説明
FairGroundTask	`public`	コンストラクタ	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
ensureChunkLoadedCache	`private`	メソッド	必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
ensureChunkLoadedAsync	`private`	メソッド	必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
releaseTickets	`private`	メソッド	releaseTickets の主要処理を担当します。
exactCellCount	`public`	メソッド	半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）
step	`public`	メソッド	step の主要処理を担当します。
isDone	`public`	メソッド	条件判定を行い、後続処理の分岐に使える真偽値を返します。
exactCellCount	`public`	メソッド	半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）
pmod	`private`	メソッド	pmod の主要処理を担当します。
hash32	`private`	メソッド	条件判定を行い、後続処理の分岐に使える真偽値を返します。
patternMaterial	`private`	メソッド	patternMaterial の主要処理を担当します。
exactCellCount	`public`	メソッド	半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）
exactCellCount	`public`	メソッド	半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）
unpackX	`private`	メソッド	unpackX の主要処理を担当します。
unpackZ	`private`	メソッド	unpackZ の主要処理を担当します。

メソッド詳細

FairGroundTask

コンストラクタpublic

public FairGroundTask(JavaPlugin plugin,Location center, int radius, int y)

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

引数

JavaPlugin plugin
Location center
int radius
int y

throws

なし

主要な呼び出し順

getWorldgetBlockXgetBlockZmaxfloorsqrt

ensureChunkLoadedCache

メソッドprivate

private boolean ensureChunkLoadedCache(int wx, int wz)

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

引数

int wx
int wz

throws

なし

主要な呼び出し順

isChunkLoadedensureChunkLoadedAsync

ensureChunkLoadedAsync

メソッドprivate

private void ensureChunkLoadedAsync(int x, int z)

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

引数

int x
int z

throws

なし

主要な呼び出し順

isChunkLoadedgetClassgetMethodinvokeremovesetChunkForceLoadedgetSchedulerrunTask

releaseTickets

メソッドprivate

private void releaseTickets()

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

引数

引数なし

throws

なし

主要な呼び出し順

isChunkLoadedgetChunkAtgetClassgetMethodinvokesetChunkForceLoadedclear

exactCellCount

メソッドpublicstatic

public static long exactCellCount(int radius)

半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）

引数

int radius

throws

なし

主要な呼び出し順

maxfloorsqrt

step

メソッドpublic

public int step(int budget)

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

引数

int budget

throws

なし

主要な呼び出し順

maxensureChunkLoadedCacheplaceTilesizeaddLastpackminisEmpty

isDone

メソッドpublic

public boolean isDone()

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

引数

引数なし

throws

なし

主要な呼び出し順

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

exactCellCount

メソッドpublicstatic

public static long exactCellCount(int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz)

半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）

引数

int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz

throws

なし

主要な呼び出し順

absmaxmin

pmod

メソッドprivatestatic

private static int pmod(int a, int m)

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

引数

int a
int m

throws

なし

主要な呼び出し順

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

hash32

メソッドprivatestatic

private static int hash32(int x, int z)

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

引数

int x
int z

throws

なし

主要な呼び出し順

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

patternMaterial

メソッドprivate

private Material patternMaterial(int x, int z)

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

引数

int x
int z

throws

なし

主要な呼び出し順

approxRadpmodhash32

exactCellCount

メソッドpublicstatic

public static long exactCellCount(int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz) { int ax = Math.abs(dx), az = Math.abs(dz); int hi = Math.max(ax, az), lo = Math.min(ax, az); return hi + (lo >> 1); } private static int pmod(int a, int m) { int r = a % m; return r < 0 ? r + m : r; } private static int hash32(int x, int z) { int h = x * 0x9E3779B1 ^ z * 0x85EBCA77; h ^= (h >>> 16); h *= 0x7FEB352D; h ^= (h >>> 15); return h; } private Material patternMaterial(int x, int z) { int dx = x - cx, dz = z - cz; int rad = approxRad(dx, dz); boolean ringRoad = (pmod(rad, 48) <= 1); boolean axialRoad = (pmod(dx, 96) <= 1) || (pmod(dz, 96) <= 1); boolean diagRoad = (pmod(dx + dz, 96) <= 1) || (pmod(dx - dz, 96) <= 1); if (ringRoad || axialRoad || diagRoad) { if (((hash32(x, z) & 0xFF) == 0) || (ringRoad && (pmod(rad, 12) == 0))) { return Material.SEA_LANTERN; } return (((dx >> 2) ^ (dz >> 2)) & 1) == 0 ? Material.SMOOTH_QUARTZ : Material.QUARTZ_BLOCK; } int band = pmod(rad >> 3, 6); int checker = ((dx >> 2) + (dz >> 2)) & 1; switch ((band << 1) | checker) { case 0: return Material.WHITE_CONCRETE; case 1: return Material.LIGHT_BLUE_CONCRETE; case 2: return Material.PURPLE_CONCRETE; case 3: return Material.MAGENTA_CONCRETE; case 4: return Material.PINK_CONCRETE; case 5: return Material.BLUE_CONCRETE; case 6: return Material.AMETHYST_BLOCK; default: return Material.QUARTZ_BRICKS; } } /* ★実際に置く：必ず patternMaterial() を使う */ private void placeTile(int x, int y, int z)

半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）

引数

int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz) { int ax = Math.abs(dx), az = Math.abs(dz); int hi = Math.max(ax, az), lo = Math.min(ax, az); return hi + (lo >> 1); } private static int pmod(int a, int m) { int r = a % m; return r < 0 ? r + m : r; } private static int hash32(int x, int z) { int h = x * 0x9E3779B1 ^ z * 0x85EBCA77; h ^= (h >>> 16); h *= 0x7FEB352D; h ^= (h >>> 15); return h; } private Material patternMaterial(int x, int z) { int dx = x - cx, dz = z - cz; int rad = approxRad(dx, dz); boolean ringRoad = (pmod(rad, 48) <= 1); boolean axialRoad = (pmod(dx, 96) <= 1) || (pmod(dz, 96) <= 1); boolean diagRoad = (pmod(dx + dz, 96) <= 1) || (pmod(dx - dz, 96) <= 1); if (ringRoad || axialRoad || diagRoad) { if (((hash32(x, z) & 0xFF) == 0) || (ringRoad && (pmod(rad, 12) == 0))) { return Material.SEA_LANTERN; } return (((dx >> 2) ^ (dz >> 2)) & 1) == 0 ? Material.SMOOTH_QUARTZ : Material.QUARTZ_BLOCK; } int band = pmod(rad >> 3, 6); int checker = ((dx >> 2) + (dz >> 2)) & 1; switch ((band << 1) | checker) { case 0: return Material.WHITE_CONCRETE; case 1: return Material.LIGHT_BLUE_CONCRETE; case 2: return Material.PURPLE_CONCRETE; case 3: return Material.MAGENTA_CONCRETE; case 4: return Material.PINK_CONCRETE; case 5: return Material.BLUE_CONCRETE; case 6: return Material.AMETHYST_BLOCK; default: return Material.QUARTZ_BRICKS; } } /* ★実際に置く：必ず patternMaterial() を使う */ private void placeTile(int x, int y, int z

throws

なし

主要な呼び出し順

isProtectedpatternMaterialgetBlockAtgetTypesetType

exactCellCount

メソッドpublicstatic

public static long exactCellCount(int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz) { int ax = Math.abs(dx), az = Math.abs(dz); int hi = Math.max(ax, az), lo = Math.min(ax, az); return hi + (lo >> 1); } private static int pmod(int a, int m) { int r = a % m; return r < 0 ? r + m : r; } private static int hash32(int x, int z) { int h = x * 0x9E3779B1 ^ z * 0x85EBCA77; h ^= (h >>> 16); h *= 0x7FEB352D; h ^= (h >>> 15); return h; } private Material patternMaterial(int x, int z) { int dx = x - cx, dz = z - cz; int rad = approxRad(dx, dz); boolean ringRoad = (pmod(rad, 48) <= 1); boolean axialRoad = (pmod(dx, 96) <= 1) || (pmod(dz, 96) <= 1); boolean diagRoad = (pmod(dx + dz, 96) <= 1) || (pmod(dx - dz, 96) <= 1); if (ringRoad || axialRoad || diagRoad) { if (((hash32(x, z) & 0xFF) == 0) || (ringRoad && (pmod(rad, 12) == 0))) { return Material.SEA_LANTERN; } return (((dx >> 2) ^ (dz >> 2)) & 1) == 0 ? Material.SMOOTH_QUARTZ : Material.QUARTZ_BLOCK; } int band = pmod(rad >> 3, 6); int checker = ((dx >> 2) + (dz >> 2)) & 1; switch ((band << 1) | checker) { case 0: return Material.WHITE_CONCRETE; case 1: return Material.LIGHT_BLUE_CONCRETE; case 2: return Material.PURPLE_CONCRETE; case 3: return Material.MAGENTA_CONCRETE; case 4: return Material.PINK_CONCRETE; case 5: return Material.BLUE_CONCRETE; case 6: return Material.AMETHYST_BLOCK; default: return Material.QUARTZ_BRICKS; } } /* ★実際に置く：必ず patternMaterial() を使う */ private void placeTile(int x, int y, int z) { if (com.example.rankingplugin.fantasy.util.NoBuildMask.isProtected(world, x, y, z)) return; Material m = patternMaterial(x, z); Block b = world.getBlockAt(x, y, z); if (b.getType() != m) b.setType(m, false); } /* x,z を long にパックしてキューに積む */ private static long pack(int x, int z)

半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）

引数

int radius) { radius = Math.max(1, radius); long r2 = (long) radius * (long) radius; long total = 0; for (int z = -radius; z <= radius; z++) { long zz = (long) z * (long) z; long hw = (long) Math.floor(Math.sqrt(Math.max(0L, r2 - zz))); total += (hw * 2L + 1L); } return total; } public int step(int budget) { if (budget <= 0) return 0; if (phase == Phase.FILL) { final int visitCap = Math.max(256, budget << 2); int visited = 0, placed = 0; while (visited < visitCap && placed < budget && dz <= r) { int wx = cx + x, wz = cz + dz; visited++; if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { if (deferred.size() < DEFER_LIMIT) deferred.addLast(pack(wx, wz)); } x++; if (x > xEnd) { dz++; if (dz > r) break; xEnd = halfWidth[dz + r]; x = -xEnd; } } int retry = Math.min(512, Math.max(0, budget - placed)); while (retry-- > 0 && placed < budget && !deferred.isEmpty()) { long p = deferred.removeFirst(); int wx = unpackX(p), wz = unpackZ(p); if (ensureChunkLoadedCache(wx, wz)) { placeTile(wx, y, wz); placed++; } else { deferred.addLast(p); } } if (dz > r && deferred.isEmpty()) { pDz = -r; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; phase = Phase.PATCH; } return Math.max(1, placed); } if (phase == Phase.PATCH) { int placed = 0; while (placed < budget && pDz <= r) { int wx = cx + pX, wz = cz + pDz; if (ensureChunkLoadedCache(wx, wz)) { Material expect = patternMaterial(wx, wz); Block b = world.getBlockAt(wx, y, wz); if (b.getType() != expect) { b.setType(expect, false); placed++; } } else { ensureChunkLoadedAsync(wx, wz); } pX++; if (pX > pXEnd) { pDz++; if (pDz > r) break; pXEnd = halfWidth[pDz + r]; pX = -pXEnd; } } if (pDz > r) { releaseTickets(); phase = Phase.DONE; } return Math.max(1, placed); } return 0; } public boolean isDone() { return phase == Phase.DONE; } /* 近似半径・mod・ハッシュの小道具 */ private static int approxRad(int dx, int dz) { int ax = Math.abs(dx), az = Math.abs(dz); int hi = Math.max(ax, az), lo = Math.min(ax, az); return hi + (lo >> 1); } private static int pmod(int a, int m) { int r = a % m; return r < 0 ? r + m : r; } private static int hash32(int x, int z) { int h = x * 0x9E3779B1 ^ z * 0x85EBCA77; h ^= (h >>> 16); h *= 0x7FEB352D; h ^= (h >>> 15); return h; } private Material patternMaterial(int x, int z) { int dx = x - cx, dz = z - cz; int rad = approxRad(dx, dz); boolean ringRoad = (pmod(rad, 48) <= 1); boolean axialRoad = (pmod(dx, 96) <= 1) || (pmod(dz, 96) <= 1); boolean diagRoad = (pmod(dx + dz, 96) <= 1) || (pmod(dx - dz, 96) <= 1); if (ringRoad || axialRoad || diagRoad) { if (((hash32(x, z) & 0xFF) == 0) || (ringRoad && (pmod(rad, 12) == 0))) { return Material.SEA_LANTERN; } return (((dx >> 2) ^ (dz >> 2)) & 1) == 0 ? Material.SMOOTH_QUARTZ : Material.QUARTZ_BLOCK; } int band = pmod(rad >> 3, 6); int checker = ((dx >> 2) + (dz >> 2)) & 1; switch ((band << 1) | checker) { case 0: return Material.WHITE_CONCRETE; case 1: return Material.LIGHT_BLUE_CONCRETE; case 2: return Material.PURPLE_CONCRETE; case 3: return Material.MAGENTA_CONCRETE; case 4: return Material.PINK_CONCRETE; case 5: return Material.BLUE_CONCRETE; case 6: return Material.AMETHYST_BLOCK; default: return Material.QUARTZ_BRICKS; } } /* ★実際に置く：必ず patternMaterial() を使う */ private void placeTile(int x, int y, int z) { if (com.example.rankingplugin.fantasy.util.NoBuildMask.isProtected(world, x, y, z)) return; Material m = patternMaterial(x, z); Block b = world.getBlockAt(x, y, z); if (b.getType() != m) b.setType(m, false); } /* x,z を long にパックしてキューに積む */ private static long pack(int x, int z

throws

なし

主要な呼び出し順

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

unpackX

メソッドprivatestatic

private static int unpackX(long v)

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

引数

long v

throws

なし

主要な呼び出し順

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

unpackZ

メソッドprivatestatic

private static int unpackZ(long v)

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

引数

long v

throws

なし

主要な呼び出し順

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

代表的な処理フロー

初期化フロー
FairGroundTask → getWorld → getBlockX → getBlockZ → max → floor
依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
ensureChunkLoadedAsync フロー
ensureChunkLoadedAsync → isChunkLoaded → getClass → getMethod → invoke → remove
必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
ensureChunkLoadedCache フロー
ensureChunkLoadedCache → isChunkLoaded → ensureChunkLoadedAsync
必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
step フロー
step → max → ensureChunkLoadedCache → placeTile → size → addLast
step の主要処理を担当します。
releaseTickets フロー
releaseTickets → isChunkLoaded → getChunkAt → getClass → getMethod → invoke
releaseTickets の主要処理を担当します。
exactCellCount フロー
exactCellCount → isProtected → patternMaterial → getBlockAt → getType → setType
半径rに含まれる整数格子点の厳密個数（進捗見積りに使用）

外部との接点

Web ルート

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

SQL / テーブル

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

補足

メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。