Class: BossArenaProtection | RankingPlugin Wiki

ボスアリーナのドーム内部を「地形破壊なし」に保護するリスナー。

3Fields

1Constructors

19Methods

140Lines

Package: com.example.rankingplugin.minigame.arena
Source: minigame/arena/BossArenaProtection.java
Kind: class
Roles: イベント駆動初期化 / ブートストラップ

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

クラス説明

ボスアリーナのドーム内部を「地形破壊なし」に保護するリスナー。
- 破壊/設置/流体/火/爆発/ピストン/モブ改変 を全て阻止
- 爆発はダメージやノックバックは通し、blockList だけ除去
使い方:
  BossArenaProtection.register(this); // onEnableで一度だけ
  BossArenaProtection.addDome(world, cx, y0, cz, rDome); // ドーム生成ごと

責務と見どころ

イベント駆動 — Bukkit イベントやコールバックを受けて後続処理を分岐します。
初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。

重点クラスの詳細解説

ボスアリーナのドーム内部を「地形破壊なし」に保護するリスナー。minigame.arena パッケージの小〜中規模クラスで、運用中の主ループを確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

BossArenaProtection
依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
onBreak
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onPlace
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onBucketEmpty
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onBucketFill
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onPistonExtend
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onPistonRetract
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
onEntityExplode
運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。

内部サブシステムの地図

起動・前提準備

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

主なメソッド

BossArenaProtection register

主なフィールド

plugin

運用中の主ループ

イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。

主なメソッド

onBreak onPlace onBucketEmpty onBucketFill onPistonExtend onPistonRetract onEntityExplode onBlockExplode

主なフィールド

なし

イベント受理と主処理

Bukkit イベントや内部イベントを受けたあと、どの状態を更新するかをまとめています。

主なメソッド

BossArenaProtection onBreak onPlace onBucketEmpty onBucketFill onPistonExtend onPistonRetract onEntityExplode

主なフィールド

なし

代表フロー詳解

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

通常運用の中心フロー

onBreak
onPlace
onBucketEmpty
onBucketFill
onPistonExtend
onPistonRetract

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

反映・保存・終了の流れ

BossArenaProtection
onBreak
onPlace
onBucketEmpty
onBucketFill

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

変更時の注意点

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

フィールド

Visibility	Type	Name	役割
`private`	`boolean`	`registered`	registered の状態を保持します。
`private`	`JavaPlugin`	`plugin`	プラグイン本体参照です。
`private`	`List<Dome>`	`DOMES`	DOMES の状態を保持します。

コンストラクタ / 初期化

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

メソッド索引

Name	Visibility	Kind	説明
BossArenaProtection	`private`	コンストラクタ	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
register	`public`	メソッド	onEnable で一度だけ呼ぶ
addDome	`public`	メソッド	ドームを登録（y0 から r+6 までの高さを保護）
inside	`private`	メソッド	inside の主要処理を担当します。
onBreak	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onPlace	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onBucketEmpty	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onBucketFill	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onPistonExtend	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onPistonRetract	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onEntityExplode	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onBlockExplode	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onEntityChangeBlock	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onHangingBreak	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onIgnite	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onBurn	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onSpread	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onFromTo	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。
onInventoryMove	`public`	イベント処理	イベント発生時の分岐と後続処理を担当します。

メソッド詳細

BossArenaProtection

コンストラクタprivate

private BossArenaProtection()

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

引数

引数なし

throws

なし

主要な呼び出し順

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

register

メソッドpublicstatic

public static void register(JavaPlugin pl)

onEnable で一度だけ呼ぶ

引数

JavaPlugin pl

throws

なし

主要な呼び出し順

getPluginManagerregisterEvents

addDome

メソッドpublicstatic

public static void addDome(World w, int cx, int y0, int cz, int r)

ドームを登録（y0 から r+6 までの高さを保護）

引数

World w
int cx
int y0
int cz
int r

throws

なし

主要な呼び出し順

maxgetMinHeightmingetMaxHeightgetUID

inside

メソッドprivatestatic

private static boolean inside(Location l)

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

引数

Location l

throws

なし

主要な呼び出し順

getWorldgetUIDgetBlockYgetXgetZequals

onBreak

イベント処理public

public void onBreak(BlockBreakEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockBreakEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onPlace

イベント処理public

public void onPlace(BlockPlaceEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockPlaceEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onBucketEmpty

イベント処理public

public void onBucketEmpty(PlayerBucketEmptyEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

PlayerBucketEmptyEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onBucketFill

イベント処理public

public void onBucketFill(PlayerBucketFillEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

PlayerBucketFillEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onPistonExtend

イベント処理public

public void onPistonExtend(BlockPistonExtendEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockPistonExtendEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelledgetBlocks

onPistonRetract

イベント処理public

public void onPistonRetract(BlockPistonRetractEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockPistonRetractEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelledgetBlocks

onEntityExplode

イベント処理public

public void onEntityExplode(EntityExplodeEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

EntityExplodeEvent e

throws

なし

主要な呼び出し順

blockListremoveIfinsidegetLocationsetYield

onBlockExplode

イベント処理public

public void onBlockExplode(BlockExplodeEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockExplodeEvent e

throws

なし

主要な呼び出し順

blockListremoveIfinsidegetLocationsetYield

onEntityChangeBlock

イベント処理public

public void onEntityChangeBlock(EntityChangeBlockEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

EntityChangeBlockEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onHangingBreak

イベント処理public

public void onHangingBreak(HangingBreakByEntityEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

HangingBreakByEntityEvent e

throws

なし

主要な呼び出し順

insidegetEntitygetLocationsetCancelled

onIgnite

イベント処理public

public void onIgnite(BlockIgniteEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockIgniteEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onBurn

イベント処理public

public void onBurn(BlockBurnEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockBurnEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onSpread

イベント処理public

public void onSpread(BlockSpreadEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockSpreadEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationsetCancelled

onFromTo

イベント処理public

public void onFromTo(BlockFromToEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

BlockFromToEvent e

throws

なし

主要な呼び出し順

insidegetBlockgetLocationgetWorldgetToBlockgetXgetYgetZ

onInventoryMove

イベント処理public

public void onInventoryMove(InventoryMoveItemEvent e)

イベント発生時の分岐と後続処理を担当します。

引数

InventoryMoveItemEvent e

throws

なし

主要な呼び出し順

getInitiatorgetLocationinsidesetCancelled

代表的な処理フロー

onFromTo フロー
onFromTo → inside → getBlock → getLocation → getWorld → getToBlock
イベント発生時の分岐と後続処理を担当します。
onBlockExplode フロー
onBlockExplode → blockList → removeIf → inside → getLocation → setYield
イベント発生時の分岐と後続処理を担当します。
onEntityExplode フロー
onEntityExplode → blockList → removeIf → inside → getLocation → setYield
イベント発生時の分岐と後続処理を担当します。
onPistonExtend フロー
onPistonExtend → inside → getBlock → getLocation → setCancelled → getBlocks
イベント発生時の分岐と後続処理を担当します。
onPistonRetract フロー
onPistonRetract → inside → getBlock → getLocation → setCancelled → getBlocks
イベント発生時の分岐と後続処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

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

補足

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