# \u2694\ufe0f TownyCombat<\/p>\n
## Overview
\n– **TownyCombat** is a lightweight combat control plugin built specifically for **Towny servers**.
\n– It prevents PvP abuse while respecting **Town PvP settings** and **WorldGuard regions**.
\n– Designed for modern servers and tested on **Minecraft 1.21.1 (Paper)**.<\/p>\n
—<\/p>\n
## Core Behavior<\/p>\n
### Town PvP Logic
\n– If a town has **PvP ENABLED**
\n – PvP works normally
\n – Players in combat can enter the town<\/p>\n
– If a town has **PvP DISABLED**
\n – PvP is blocked inside the town
\n – Players in combat are **knocked back** when trying to enter<\/p>\n
—<\/p>\n
### Combat Outside \u2192 Entering Town
\n– If PvP starts **outside a town**:
\n – Entering a **PvP-enabled town** is allowed
\n – Entering a **PvP-disabled town** will cause knockback<\/p>\n
—<\/p>\n
### WorldGuard Integration
\n– Optional WorldGuard support
\n– Configure allowed regions in the config:
\n – PvP is **not allowed** inside configured WorldGuard regions
\n – If PvP starts **outside** and a player enters one of these regions, entry is allowed
\n– Useful for:
\n – Spawn zones
\n – Safe areas
\n – Controlled PvP corridors<\/p>\n
—<\/p>\n
## Features
\n– Configurable combat timer (default: 10 seconds)
\n– Adjustable knockback strength
\n– Town-aware PvP checks
\n– WorldGuard region support
\n– Customizable block message
\n– Permission-based bypass
\n– Live configuration reload
\n– Lightweight and optimized<\/p>\n
—<\/p>\n
## Commands
\n– `\/townycombat reload`
\n – Reloads the configuration without restarting the server<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Description | Default |
\n|———|————|———|
\n| `townycombat.bypass` | Bypass combat restrictions | OP |
\n| `townycombat.reload` | Reload plugin configuration | OP |<\/p>\n
—<\/p>\n
## Configuration Example
\n“`yaml
\ncombat:
\n duration-seconds: 10 # Duration in seconds a player stays in combat after being hit<\/p>\n
behavior:
\n knockback-enabled: true # Enable knockback when a player tries to enter a PvP-disabled town
\n knockback-strength: 1.5 # Knockback power (recommended: 0.5 – 3.0)
\n allow-entry-if-pvp-enabled: true # If true, players can enter towns with PvP enabled<\/p>\n
worldguard:
\n enabled: true # Enable WorldGuard integration
\n allowed-regions:
\n – “southlands” # Players who start combat outside these regions can enter towns freely
\n # Add more region names here (case-sensitive)<\/p>\n
bypass:
\n ops-only: true # Only OPs can use the bypass permission by default
\n permission-node: townycombat.bypass # Permission for bypassing entry restrictions<\/p>\n
messages:
\n blocked_message: “\u00a7cYou are in combat \u2014 you cannot enter a town!” # Message when entry is blocked<\/p>\n","protected":false},"excerpt":{"rendered":"
A smart Towny combat control plugin that prevents PvP abuse while respecting Town & WorldGuard. rules.<\/p>\n","protected":false},"featured_media":126833,"template":"","meta":{"_minecraft_slug":"pvp-focused-towny-addon","_minecraft_project_id":"qaHB5dCe","_minecraft_author":"Corrupted_Games","_minecraft_license":"MIT","_minecraft_downloads":56,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pvp-focused-towny-addon.zip","_minecraft_size_bytes":13629,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:56:05.428089Z","_minecraft_date_created":"2026-01-05T22:49:04.899023Z","_minecraft_date_modified":"2026-01-01T08:48:22.627261Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pvp-focused-towny-addon","_minecraft_icon_attachment_id":126833,"_minecraft_imported_at":"2026-06-07T10:59:07+00:00","_minecraft_import_hash":"90f8ed783725c7f35dbdd383094ff7ef","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-126832","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n