⚔️ TownyCombat

Overview

• TownyCombat is a lightweight combat control plugin built specifically for Towny servers.
• It prevents PvP abuse while respecting Town PvP settings and WorldGuard regions.
• Designed for modern servers and tested on Minecraft 1.21.1 (Paper).

---

Core Behavior

Town PvP Logic

• If a town has PvP ENABLED

  • PvP works normally
  • Players in combat can enter the town

• If a town has PvP DISABLED

  • PvP is blocked inside the town
  • Players in combat are knocked back when trying to enter

---

Combat Outside → Entering Town

• If PvP starts outside a town:
  • Entering a PvP-enabled town is allowed
  • Entering a PvP-disabled town will cause knockback

---

WorldGuard Integration

• Optional WorldGuard support
• Configure allowed regions in the config:
  • PvP is not allowed inside configured WorldGuard regions
  • If PvP starts outside and a player enters one of these regions, entry is allowed
• Useful for:
  • Spawn zones
  • Safe areas
  • Controlled PvP corridors

---

Features

• Configurable combat timer (default: 10 seconds)
• Adjustable knockback strength
• Town-aware PvP checks
• WorldGuard region support
• Customizable block message
• Permission-based bypass
• Live configuration reload
• Lightweight and optimized

---

Commands

• /townycombat reload
  • Reloads the configuration without restarting the server

---

Permissions

Permission	Description	Default
townycombat.bypass	Bypass combat restrictions	OP
townycombat.reload	Reload plugin configuration	OP

---

Configuration Example

combat:
  duration-seconds: 10  # Duration in seconds a player stays in combat after being hit

behavior:
  knockback-enabled: true  # Enable knockback when a player tries to enter a PvP-disabled town
  knockback-strength: 1.5  # Knockback power (recommended: 0.5 - 3.0)
  allow-entry-if-pvp-enabled: true  # If true, players can enter towns with PvP enabled

worldguard:
  enabled: true  # Enable WorldGuard integration
  allowed-regions:
    - "southlands"  # Players who start combat outside these regions can enter towns freely
  # Add more region names here (case-sensitive)

bypass:
  ops-only: true  # Only OPs can use the bypass permission by default
  permission-node: townycombat.bypass  # Permission for bypassing entry restrictions

messages:
  blocked_message: "§cYou are in combat — you cannot enter a town!"  # Message when entry is blocked