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

CannonRTP 保護連携

CannonRTPは、着地候補地点をキューに入れる前に、複数の保護プラグインに対して検証できます。

サポートされている連携​

現在のソフト依存関係は以下の通りです：

  • WorldGuard
  • Towny
  • Lands
  • GriefPrevention
  • HuskTowns
  • HuskClaims

これらはplugin.ymlでsoftdependとして宣言されています。CannonRTPはこれらがインストールされていなくても動作します。

保護チェックの仕組み​

  • アダプターは固定の順序でチェックされます：WorldGuard、Towny、Lands、GriefPrevention、HuskTowns、HuskClaims。
  • 地点をブロックした最初のアダプターがチェックを停止し、報告される理由となります。
  • アダプターが設定で無効にされているか、プラグインが存在しない場合、スキップされます。
  • 保護APIがエラーを起こした場合、CannonRTPはデフォルトでその着地をブロックします。

APIエラーのグローバル安全スイッチは：

  • landing.failOpenOnProtectionErrors

デフォルト：false

trueに設定すると、保護プラグインを安全にクエリできない場合でも着地を続行できます。

/wc probeコマンド​

管理者は任意の場所に立ち、/wc probeを実行してその場所がすべての保護チェックに合格するかテストできます。結果はどのプラグインがその場所をブロックしたかとその理由を報告するか、その場所が有効であることを確認します。

設定パス​

すべての保護トグルはplugins/CannonRTP/config.ymlのprotection.*の下にあります。

プラグインごとの動作​

WorldGuard​

設定キー：

  • protection.worldGuard.enabled
  • protection.worldGuard.allowGlobalRegionOnly
  • protection.worldGuard.allowBuildAllowedRegions
  • protection.worldGuard.allowPassthroughRegions

デフォルトの動作：

  • デフォルトで有効
  • __global__のみにカバーされる地点はデフォルトで許可
  • build=ALLOWのリージョンはデフォルトで許可
  • passthrough=ALLOWのリージョンはデフォルトで許可
  • その他の一致する保護リージョンはブロック

Towny​

設定キー：

  • protection.towny.enabled
  • protection.towny.allowWilderness
  • protection.towny.allowNationZones
  • protection.towny.allowClaimedTownBlocks

デフォルトの動作：

  • デフォルトで有効
  • 荒野は許可
  • 国家ゾーンはブロック
  • 請求済みの町ブロックはブロック

Lands​

設定キー：

  • protection.lands.enabled
  • protection.lands.allowUnclaimedAreas
  • protection.lands.allowClaimedAreas

デフォルトの動作：

  • デフォルトで有効
  • 未請求エリアは許可
  • 請求済みエリアはブロック

GriefPrevention​

設定キー：

  • protection.griefPrevention.enabled
  • protection.griefPrevention.allowWilderness
  • protection.griefPrevention.allowAdminClaims
  • protection.griefPrevention.allowPlayerClaims

デフォルトの動作：

  • デフォルトで有効
  • 荒野は許可
  • 管理者クレームはブロック
  • プレイヤークレームはブロック

HuskTowns​

設定キー：

  • protection.huskTowns.enabled
  • protection.huskTowns.allowWilderness
  • protection.huskTowns.allowAdminClaims
  • protection.huskTowns.allowRegularClaims
  • protection.huskTowns.allowFarmClaims
  • protection.huskTowns.allowPlotClaims

デフォルトの動作：

  • デフォルトで有効
  • 荒野は許可
  • 管理者クレームはブロック
  • 通常の町クレームはブロック
  • 農場クレームはブロック
  • 区画クレームはブロック

HuskClaims​

設定キー：

  • protection.huskClaims.enabled
  • protection.huskClaims.allowWilderness
  • protection.huskClaims.allowAdminClaims
  • protection.huskClaims.allowPlayerClaims

デフォルトの動作：

  • デフォルトで有効
  • 荒野は許可
  • 管理者クレームはブロック
  • プレイヤークレームはブロック

保護以外の検証も適用されます​

保護連携は着地検証の一部に過ぎません。地点は以下の理由で拒否されることがあります：

  • ワールドボーダーの外にある
  • 安全な表面が存在しない
  • 足元または頭上の空間がブロックされている
  • 地形が設定済みの危険なマテリアルリストに一致

失敗レポート​

キャノンが消耗済みになると（検索タイムアウト前に十分な有効地点を見つけられない場合）、ステータス出力とプレイヤー向けメッセージには一般的な拒否理由の内訳が含まれます。ほとんどの拒否が保護された土地によるものであれば、それが報告されます。これは管理者が保護設定がサーバーに対して制限が厳しすぎるかどうかを診断するのに役立ちます。