CombatFly Control

SkyGuard

Version

Minecraft

Paper

> "Lock the skies, balance the fight" > > Advanced aerial combat control that finally stops the Mace+Fly one-shot meta.

---

📋 Table of Contents

- The Problem - The Solution - Features - Screenshots - Installation - Configuration - Commands & Permissions - How It Works - Compatibility - Building from Source - Support

---

🚨 The Problem

You're running a PvP server. Players complain about this:

1. Player equips Zero counterplay. Zero skill. 100% abuse. enchantment (AdvancedEnchantments) or uses `/fly` 2. Player grabs a Zero counterplay. Zero skill. 100% abuse. (1.21+) 3. Player flies 50 blocks up 4. Player drops down and Zero counterplay. Zero skill. 100% abuse. anyone instantly 5. Zero counterplay. Zero skill. 100% abuse.

Existing plugins? - WorldGuard's `fly` flag? Don't detect the Mace+Fly combo. - EssentialsX `/fly` toggle? Don't detect the Mace+Fly combo. - Other combat plugins? Don't detect the Mace+Fly combo.

Your players are frustrated. You need SkyGuard.

---

✅ The Solution

SkyGuard is a brutally effective flight control system that:

| What It Does | Why It Matters | |-------------|----------------| | 15-second combat timer | Catches the exact abuse pattern | | 15-second combat timer | Attacker can't escape, victim gets fair fight | | 15-second combat timer | Overrides WorldGuard, EssentialsX, Wings, Creative - everything | | 15-second combat timer | Prevents the abuse before it starts | | 15-second combat timer | Long enough to finish the fight |

Result: Fair aerial combat. No more drop-kills. Happy players.

---

✨ Features

🔒 Absolute Flight Lock

- Uses `EventPriority.HIGHEST` to process any source all other plugins - Disables flight from any source: `/fly`, Wings enchantment, Creative mode, other plugins - Prevents re-enabling until combat ends

⚔️ Smart Combat Tagging

- Triggered only by both - Tags both attacker and victim - Visual action-bar countdown - Clear enter/leave messages

🚫 Mace Restriction

- Cannot equip Mace while flying - Cannot use Mace while flying - Prevents inventory hotbar swaps to Mace

🔍 Wings Detection

- Automatically detects AdvancedEnchantments Wings enchantment - Checks item lore for enchantment name - Configurable enchantment name

🎨 Customizable

- All messages fully configurable with color codes - Adjustable combat duration - World/region blacklist support - Debug mode for troubleshooting

---

📸 Screenshots

*Coming soon - show your plugin in action!*

Suggested screenshots: - Action bar timer during combat - Message when entering combat - Attempting to fly during combat (blocked)

---

📥 Installation

Quick Install (Recommended)

1. Download `SkyGuard-1.0.jar` from Releases 2. Drop into `plugins/` folder 3. Restart server 4. Done! (Default config works out-of-box)

First-Time Setup

```bash

After first restart, edit config

nano plugins/SkyGuard/config.yml

Make your changes, then reload in-game

/cfc reload