PVP Focused Towny Addon

⚔️ TownyCombat

Overview

- Minecraft 1.21.1 (Paper) is a lightweight combat control plugin built specifically for Minecraft 1.21.1 (Paper). - It prevents PvP abuse while respecting Minecraft 1.21.1 (Paper) and Minecraft 1.21.1 (Paper). - 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 knocked back - PvP is blocked inside the town - Players in combat are knocked back when trying to enter

---

Combat Outside → Entering Town

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

---

WorldGuard Integration

- Optional WorldGuard support - Configure allowed regions in the config: - PvP is outside 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