メインコンテンツまでスキップ

CannonRTP API

CannonRTP は、他のプラグインがフックできる 3 つの Bukkit イベントを公開しています。すべてのイベントは com.magmaguy.cannonrtp.api パッケージにあり、メインサーバースレッドで発火します。

リスナーを登録するには通常の Bukkit @EventHandler を登録します -- 別途の登録手順は不要です。

CannonRTPLaunchEvent​

プレイヤーがキャノン発射シーケンスを開始しようとしているまさにその瞬間、ビジュアルやエフェクトが適用される 前 に発火します。キャンセル可能です。

プロパティ型説明
playerPlayerキャノンを起動したプレイヤー
cannonIdStringキャノンの設定 ID (.yml を除いたファイル名)
cannonDisplayNameStringキャノンの displayName フィールド
cannonLocationLocation起動された正確な配置位置
destinationLocationこの発射のために選ばれた、事前検証済みの安全な着地地点

イベントをキャンセルする と発射は完全に中止されます: プレイヤーはその場にとどまり、エフェクトは適用されず、組み込みの発射クールダウンも開始されず、目的地はキャノンキューの先頭に戻されます。常にキャンセルされるイベントをプレイヤースキャンのティックごとに発火させ続けないよう、CannonRTP はそのプレイヤーがトリガー内にとどまっている間、再試行の間隔を 1 秒から最大 30 秒まで段階的に延ばします。トリガーから離れるか、受理された発射が完了すると、このバックオフは解除されます。リージョンベースのブラックリスト、クールダウンプラグイン、経済システムによるゲート、PvP リージョンチェックなどに有用です。

@EventHandler
public void onLaunch(CannonRTPLaunchEvent event) {
    if (event.getPlayer().getWorld().getName().equals("event_world")) {
        event.setCancelled(true);
    }
}

CannonRTPLocationValidationEvent​

事前読み込み検索中に CannonRTP が候補着地地点を検証する際、各候補に対して発火します。さらに、発射がコミット時(エアドロップのテレポート直前)に、消費される目的地を再検証する際にも 再度 発火します。組み込みのすべてのチェック(ワールドボーダー、地表、危険マテリアル、保護統合)が通過した 後にのみ 発火します。

プロパティ型説明
cannonIdString検索を行っているキャノンの設定 ID
cannonDisplayNameStringキャノンの displayName フィールド
candidateLocation検討中の候補着地地点

このイベントは Bukkit の意味でのキャンセル可能ではありません。候補を拒否するには以下を呼び出します:

event.setRejected("inside arena spawn protection");

事前読み込み中であれば、CannonRTP は内部チェックに失敗した場合と同様にその候補を破棄し、検索を続行します。コミット時に拒否した場合は、リスナーがもはや受け入れない地点へプレイヤーをテレポートするのではなく、発射をキャンセルしてプレイヤーを復帰させます。リスナーは、組み込みの保護アダプターを超えるカスタムリージョンルールを実装できます。

注: どちらの発火もメインスレッドで行われ、事前読み込みの試行は全体でティックあたり 1 回、アクティブキャノン間でラウンドロビンに実行されます。ハンドラーは高速に保ってください。

CannonRTPLandingEvent​

プレイヤーが目的地にテレポートされ、発射シーケンスが完全に完了した後(LANDING フェーズが実行され、低速落下が解除され、衝撃エフェクトが再生された後)に発火します。キャンセル不可 -- 発射前に拒否するには CannonRTPLaunchEvent を使用してください。

プロパティ型説明
playerPlayerちょうど着地したプレイヤー
cannonIdStringプレイヤーを発射したキャノンの設定 ID
cannonDisplayNameStringキャノンの displayName フィールド
destinationLocationプレイヤーが送られた目的地のコピー

初到着時の報酬付与、後続エフェクトのトリガー、リージョン権限の付与、到着の通知、分析などに有用です。

スレッディングとライフサイクル​

  • 3 つのイベントすべてがメインスレッドで配信されます。
  • CannonRTPLocationValidationEvent はグローバルな事前読み込みティック中に配信されるため(サーバーティックあたり 1 試行、アクティブキャノン間でラウンドロビン)、リスナーで重い処理を行うとキャノンがキューを充電する速度が目に見えて遅くなります。さらに発射ごとに 1 回、コミット時にキューに入っていた目的地が再検証される際にも配信されます。
  • CannonRTPLaunchEvent は LaunchSequence が構築される直前に配信されるため、変更した状態(ポーション効果、インベントリ、ゲームモード)は Searching フェーズの開始前に反映されます。
  • CannonRTPLandingEvent は発射ごとに 1 回、衝撃エフェクト後の LANDING フェーズティックで配信されます。

cannonId の扱い​

cannonId は、すべての管理者コマンド(/wc place、/wc target など)で使用されるのと同じ ID であり、.yml を除いたキャノン設定のファイル名と一致します。1 つのキャノン設定がワールド内で多数の配置を制御する場合がありますが、それらはすべて同じ cannonId と cannonDisplayName を共有します。正確な配置が必要な場合は、CannonRTPLaunchEvent の cannonLocation を使用してください。