CelestCombat Pro

# CelestCombat Pro

[!(https://img.shields.io/modrinth/dt/celestcombat-pro?logo=modrinth&logoColor=white&label=downloads&labelColor=%23139549&color=%2318c25f)](https://modrinth.com/plugin/celestcombat-pro) [!(https://img.shields.io/badge/Folia-Supported-brightgreen.svg?logo=papermc&logoColor=white&labelColor=%23139549&color=%2318c25f)](https://github.com/PaperMC/Folia) [!(https://img.shields.io/badge/bStats-Metrics-blue.svg?logo=chart-line&logoColor=white)](https://bstats.org/plugin/bukkit/CelestCombat-Pro/27299)

CelestCombat Pro is a highly optimized, feature-rich, and enterprise-grade combat management plugin for Minecraft servers specializing in PvP environments. Fully compatible with Paper, Purpur, and Folia, it provides comprehensive combat logging prevention, forcefields, anti-glitch systems, newbie protections, and kill rewards without sacrificing server performance.

# Crediting original: https://github.com/NighterDevelopment/CelestCombat #

!(https://cdn.modrinth.com/data/cached_images/ab640999a9ec99dc64810dbb4d1ba434a9b1d01c_0.webp) !(https://cdn.modrinth.com/data/cached_images/8de3349089aab365ed0bcc040ecfec420bac0045_0.webp) !(https://cdn.modrinth.com/data/cached_images/56e52bc2ac6152f79580072084bfeee4f41a88c6_0.webp) !(https://cdn.modrinth.com/data/cached_images/74025a2942cdccc372c00e5e51f790b01583adba_0.webp)

## 📖 Table of Contents 1. [🚀 Core Features](#-core-features) 2. [📋 Requirements & Installation](#-requirements--installation) 3. [💻 Commands & Permissions](#-commands--permissions) 4. [⚙️ Quick-Start Configuration Guide](#️-quick-start-configuration-guide) 5. [🛠️ Developer API](#️-developer-api) 6. [🤝 Contributing & Support](#-contributing--support) 7. [📄 License](#-license)

## 🚀 Core Features

### ⚔️ Combat Tagging & Anti-Log System Auto-Tagging: Automatically tags players in combat when they deal or receive damage. Combat Flight Control: Disables flight and Elytra usage immediately upon entering combat to prevent players from fleeing. Command Blocking: Prevent players from escaping PvP using teleportation or utility commands. Supports both blacklist and whitelist command modes. Combat Logout Punishment: Kills players who log out during combat, drops their items, executes custom server commands (like global chat announcements), and awards attacker rewards. Exempt Admin Actions: Optionally bypasses combat tagging during administrative kicks to prevent false logging punishments.

### 🛡️ Forcefield Border & Area Protection WorldGuard Safezones: Tagged players are pushed back with customizable force when they attempt to enter WorldGuard safe zones. Features a beautiful stained-glass forcefield visualizer (default: `RED_STAINED_GLASS`). GriefPrevention Claims: Pushes combatants out of active GriefPrevention claims to prevent "claim-hopping" during fights. Renders a distinct visual boundary (default: `BLUE_STAINED_GLASS`). UXM Claims: Comprehensive control over player entry, combat, item restrictions (Chorus Fruit, Pearls, Totems), and command blocking inside UXM claims. Supports separate rule profiles for Admin, Player, and Public claims.

### 🧬 Ender Pearl & Trident Mechanics Ender Pearl Glitch Prevention: Employs advanced physics checks to prevent players from getting stuck in blocks, doing micro-teleports, passing through doors/gates, and glitching through walls or tight spaces. Pearl & Trident Cooldowns: Enforces custom cooldown timers (global or combat-only) with world-specific toggles. Combat Refresh: Option to refresh/renew the combat timer when an Ender Pearl or Trident lands. Trident Restrictions: Option to ban trident usage entirely in configured worlds (e.g., Nether).

### 🎁 Player Progression & Rewards Newbie Protection: Grants temporary PvP and mob damage protection to new players. Features customizable bossbar/actionbar countdown displays and removes protection early if they deal damage to others. Kill Rewards: Triggers custom commands (e.g., giving keys/currencies) upon player kills with global and same-player farming cooldowns to prevent exploitation. Death Animations: Plays stunning visual effects (lightning strikes and fire particles) when players die.

## 📋 Requirements & Installation

### Requirements Minecraft Version: 1. 21 - 26. X Server Software: Paper, Purpur, Folia Java Version: Java 21+

### Installation 1. Download the latest release from (https://modrinth.com/plugin/celestcombat-pro). 2. Place the `.jar` file in your server's `plugins` folder. 3. Restart your server. 4. Configure the settings in `plugins/CelestCombat/config.yml` and language files in `plugins/CelestCombat/language/`. 5. Reload the configuration with `/cc reload`.

## 💻 Commands & Permissions

### Commands | Command | Aliases | Permission | Description | |---------