PVP Focused Towny Addon

# ⚔️ 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 ```yaml 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