Saltar al contenido principal

Integraciones de Protección de CannonRTP

CannonRTP puede validar posibles ubicaciones de aterrizaje contra varios plugins de protección antes de ponerlas en cola para su uso.

Integraciones Compatibles​

Las dependencias opcionales actuales son:

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

Estas se declaran como softdepend en plugin.yml. CannonRTP funciona sin ninguna de ellas instalada.

Cómo Funcionan las Comprobaciones de Protección​

  • Los adaptadores se revisan en un orden fijo: WorldGuard, Towny, Lands, GriefPrevention, HuskTowns, HuskClaims.
  • El primer adaptador que bloquea una ubicación detiene la comprobación y se convierte en el motivo reportado.
  • Si un adaptador está desactivado en la configuración o el plugin no está presente, se omite.
  • Si una API de protección lanza un error, CannonRTP bloquea ese aterrizaje por defecto.

El interruptor global de seguridad para fallos de API es:

  • landing.failOpenOnProtectionErrors

Predeterminado: false

Cuando se establece en true, CannonRTP permitirá que los aterrizajes continúen cuando un plugin de protección no pueda consultarse de forma segura.

El Comando /wc probe​

Los administradores pueden situarse en cualquier ubicación y ejecutar /wc probe para probar si esa ubicación pasa todas las comprobaciones de protección. El resultado informa qué plugin bloqueó la ubicación y por qué, o confirma que la ubicación es válida.

Rutas de Configuración​

Todos los interruptores de protección están bajo protection.* en plugins/CannonRTP/config.yml.

Comportamiento por Plugin​

WorldGuard​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las ubicaciones cubiertas solo por __global__ se permiten por defecto
  • las regiones con build=ALLOW se permiten por defecto
  • las regiones con passthrough=ALLOW se permiten por defecto
  • otras regiones protegidas coincidentes se bloquean

Towny​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las zonas salvajes se permiten
  • las zonas de nación se bloquean
  • los bloques de ciudad reclamados se bloquean

Lands​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las áreas no reclamadas se permiten
  • las áreas reclamadas se bloquean

GriefPrevention​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las zonas salvajes se permiten
  • las reivindicaciones de administrador se bloquean
  • las reivindicaciones de jugador se bloquean

HuskTowns​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las zonas salvajes se permiten
  • las reivindicaciones de administrador se bloquean
  • las reivindicaciones normales de ciudad se bloquean
  • las reivindicaciones de granja se bloquean
  • las reivindicaciones de parcela se bloquean

HuskClaims​

Claves de configuración:

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

Comportamiento predeterminado:

  • activado por defecto
  • las zonas salvajes se permiten
  • las reivindicaciones de administrador se bloquean
  • las reivindicaciones de jugador se bloquean

La Validación no Relacionada con Protección Sigue Aplicándose​

Las integraciones de protección son solo una parte de la validación del aterrizaje. Una ubicación aún puede ser rechazada porque:

  • está fuera del borde del mundo
  • no existe una superficie segura
  • el espacio de los pies o de la cabeza está bloqueado
  • el terreno coincide con las listas configuradas de materiales inseguros

Informe de Fallos​

Cuando un cañón se agota (no puede encontrar suficientes ubicaciones válidas antes del tiempo límite de búsqueda), la salida de estado y los mensajes dirigidos a los jugadores incluyen un desglose de las razones de rechazo comunes. Si la mayoría de los rechazos provienen de terreno protegido, eso se informa. Esto ayuda a los administradores a diagnosticar si los ajustes de protección son demasiado restrictivos para su servidor.