Highlight Features
The ultimate combat management plugin for SwordPvP & CrystalPVP servers. Prevent combat logging, ensure fair battles, and create an engaging PvP experience with powerful features and stunning visual effects.
Combat System
- Intelligent Combat Tagging - Tracks players in combat with customizable duration
- Flexible Command Blocking - Blacklist/whitelist modes for complete control
- Staff-Friendly - Admin actions (kick/ban) won't trigger combat kill punishments
PvP Restriction
- Ender Pearl Cooldowns - Smart management with combat integration
- Trident Restrictions - Per-world bans and cooldown systems
- Item Restrictions - Block Chorus Fruit, Elytra, and more during fights
Newbie Protection
- New Player Shield - Configurable protection for newcomers
- Smart Removal - Auto-remove when dealing damage to others
- Visual Indicators - Boss bar and action bar displays
WorldGuard Integration
- SafeZone Barriers - Visual barriers prevent entering safe zones during combat
- Customizable Materials - Choose from invisible barriers to colored glass
- Performance Optimized - Client-side barriers for smooth gameplay
Kill Reward System
- Kill Rewards - Execute commands on player defeats
- Smart Cooldowns - Global or per-player cooldowns
- Anti-Farming Protection - Prevent reward exploitation
kill_rewards:
enabled: true
commands:
- "eco give %killer% 100"
- "say %killer% eliminated %victim%!"
cooldown:
duration: "10h"
Multi-Language Support
Built-in English and Vietnamese with easy custom translation system.
# Example messages
combat_countdown:
action_bar: "A90E2Combat: &#FFFFFF%time%s"
player_died_combat_logout:
message: "&cYou previously logged out during combat and have been penalized."
title: "&#E94E77COMBAT PENALTY"
subtitle: "&#BF3A49Don't log out during fights!"
sound: entity.wither.hurt
combat_expired:
enabled: true
message: "CAF50You are no longer in combat."
sound: entity.experience_orb.pickup
Plugin Integrations
Protection Plugins
WorldGuard
- Safe Zone Barriers - Visual barriers prevent players from entering protected regions during combat
- Custom Barrier Materials - Choose from glass, barriers, or invisible blocks
- Performance Optimized - Client-side barriers rendering for smooth gameplay
GriefPrevention
- Claim Protection - Visual barriers prevent players from entering protected claims during combat
- Custom Barrier Materials - Choose from glass, barriers, or invisible blocks
- Performance Optimized - Client-side barriers rendering for smooth gameplay
- Land Trust Integration - Works with player trust levels and permissions
Quick Setup
- Download and place in your plugins folder
- Restart your server to generate configs
- Customize settings with
/cc reload - Enjoy enhanced PvP combat!
Commands & Usage
Main Command: /celestcombat (aliases: /cc, /combat)
| Command | Description |
|---|---|
/cc help |
Show command help |
/cc reload |
Reload plugin configuration |
/cc tag <player1> <player2> |
Tag player(s) in combat |
/cc removeTag <player> |
Remove combat tags (player/world/all) |
/cc killReward <action> |
Manage kill reward cooldowns |
/cc newbieProtection <action> |
Control newbie protection |
Permissions
| Permission | Description | Default |
|---|---|---|
celestcombat.command.use |
Access all plugin commands | OP |
celestcombat.update.notify |
Receive update notifications | OP |
celestcombat.bypass.tag |
Bypass combat tagging | False |
Plugin Statistics
Support & Community
Need Help?
- Bug Reports: GitHub Issues
- Discord Support: Join Our Server
- Rate & Review: Help others discover CelestCombat!
### 🛡️ New Features
- GriefPrevention Integration**: Added comprehensive barrier system for GriefPrevention claims
- Configurable barrier materials and detection radius
- Permission-based bypass system with multiple access levels
- Customizable push-back force for claim boundaries
- Per-World Configuration**: Both WorldGuard and GriefPrevention protections now support per-world enable/disable settings
- Granular control over which worlds have protection active
- Improved server performance by disabling protection in unused worlds
### ⚡ Performance Improvements
- WorldGuard Barrier Optimization**: Significantly improved WorldGuard barrier performance
- Reduced CPU overhead during barrier detection
- More efficient boundary checking algorithms
- Smoother player experience when approaching protected zones
### 🐛 Bug Fixes
- Fixed potential memory leaks in barrier detection systems
- Resolved edge cases where barriers could appear in wrong locations
- Improved error handling for invalid world configurations
## 🛠️ **Bug Fixes**
- Fixed Folia compatibility issue** - Kill reward execute error commands now run properly on Folia servers
- Improved data persistence** - Kill reward and newbie protection data is now saved to
.ymlfiles for better reliability and performance
## 🔄 **Changes & Improvements**
- Removed permission-based kill rewards** - Streamlined the kill reward system by removing permission dependencies
- Refactored command structure** - Complete overhaul of the command system for better organization and maintainability
## ✨ **New Features**
- Trident Riptide Cooldown** - Added cooldown functionality for tridents with the Riptide enchantment to prevent spam usage
- Kill Reward Commands** - Introduced comprehensive kill reward command system with the following options:
/cc killReward check <player> [target]- Check kill reward cooldown status/cc killReward clear <player>- Clear kill reward cooldowns for specific players/cc killReward clearAll- Clear all kill reward cooldowns server-wide
- Newbie Protection System** - Brand new feature to protect new players with dedicated commands:
/cc newbieProtection give <player>- Grant protection to new players/cc newbieProtection remove <player>- Remove protection when no longer needed/cc newbieProtection check <player>- Check current protection status
## 🆕 New Features
### Enhanced WorldGuard Safezone Protection
- Client-Side Barriers**: Barriers are now entirely client-side for improved server performance
- Selective Visibility**: Only combatants see barriers - other players can pass through without issues
- Configurable Barrier Blocks**: Customize barrier materials to match your server theme
### Complete Trident Management System
- Trident Cooldowns**: Full cooldown system with per-world configuration
- Combat Timer Integration**: Optional combat timer refresh when trident lands
- World-Specific Bans**: Restrict trident usage in specific worlds
### New Administrative Commands
/celestcombat removeTag <player>- Remove a player from combat/celestcombat removeTagWorld <world>- Remove all players from combat in a world/celestcombat removeTagAll- Remove all players from combat server-wide- Console Support**: All commands can now be executed from console
## 🔧 Improvements
### Simplified Permissions
- Unified Structure**: All command permissions merged into
celestcombat.command.use - Easier Management**: Single permission node for all administrative functions
### Enhanced Multi-World Support
- Better Compatibility**: Improved integration with Multiverse-Core and Worlds plugins
- Per-World Settings**: More granular control over world-specific configurations
## 📋 Configuration Updates
New configuration options have been added for:
- Trident management settings
- Enhanced WorldGuard barrier customization
- Debug mode toggle
### New Features
#### 🛡️ SafeZone Protection Improvements
- Push Force Control**: Added new
push_forcesetting that determines how strongly players are repelled when attempting to enter SafeZones while in combat. Higher values will push players further from SafeZone borders. - Configurable in
safezone_protection.push_force(default: 1.5)
#### 🏹 Combat Mechanics Enhancements
- Ender Pearl Combat Reset**: Added new
refresh_combat_on_landoption to control whether a player's combat timer should be refreshed when landing an Ender Pearl. - Configurable in
enderpearl.refresh_combat_on_land(default: false) - When enabled, landing an Ender Pearl will reset the combat timer, preventing escape tactics
### Bug Fixes
- Fixed various minor bugs and improved performance
- Enhanced compatibility with latest Minecraft version
### Reminders
- Remember to back up your config before updating
- The language system now supports custom languages - check the config header for instructions
### 📋 Config Example for New Features
``
yaml
safezone_protection:
enabled: true
push_force: 1.5 # New setting - controls knockback strength
enderpearl:
refresh_combat_on_land: false # New setting - toggles combat timer reset
``## Version 1.0.5 (May 2025)
### Bug Fixes
- WorldGuard Integration**: Improved barrier system to prevent players from entering protected regions without visible barrier blocks - now more accurate and less intrusive
- Folia Compatibility**: Resolved a scheduler conflict that prevented kill reward commands from executing properly
### New Features
- Command Control System**: Added a whitelist mode for commands during combat
- Players can now switch between blacklist mode (blocked commands) and whitelist mode (allowed commands)
- Provides more flexibility for server configurations
### Kill Reward System Improvements
- Global Cooldown**: Added option for a server-wide kill reward cooldown that affects all players
- New
use_global_cooldownsetting in the configuration - When enabled, any kill will trigger a cooldown for all kill rewards across the server
- Permission-Based Cooldowns**: Added support for permission-specific cooldown durations
- Configure different cooldown times based on player permissions
- Permission format:
celestcombat.cooldown.[group](e.g.,celestcombat.cooldown.vip) - Custom groups include VIP, MVP, and Elite with respective cooldowns of 12h, 6h, and 3h
### Notes for Server Administrators
- The new whitelist mode for commands provides greater flexibility for controlling which commands can be used during combat
- When upgrading, review your cooldown settings as the new global cooldown option may change behavior if enabled
- Permission-based cooldowns allow for rewarding premium players with faster cooldown times
For any issues or feedback, please report them on our GitHub repository or Discord server.
## 🛠️ Bug Fixes
- 🔊 **Sound System Overhaul (1.21.1 Compatibility)**
- Resolved an issue where
Sound.valueOf(String)caused errors on Minecraft 1.21.1. - The plugin now uses
NamespaceKeystrings for sounds inmessage.yml, improving performance and ensuring better compatibility across Minecraft versions.
> ℹ️ **Note:** Sounds in
message.yml must now use the namespace format. > Example:
>
BLOCK_NOTE_BLOCK_PLING ➜ block.note_block.pling- ⚰️ **Duplicate Death Animations**
- Fixed a bug that caused death animations to trigger multiple times under specific conditions.
## ✨ New Features & Improvements
- 🧱 **Toggleable Safe Zone Barrier**
- Added a config option to enable or disable the WorldGuard safezone barrier feature.
``
yaml
safezone_barrier:
# Enable/disable WorldGuard integration for safezone barriers
enabled: true
# Barrier duration
duration: 3s
# Barrier block type
block: RED_STAINED_GLASS_PANE
# Barrier dimensions
height: 4
width: 8
``## 🛠️ Bug Fixes
- 🌀 **Reload Command**
- Fixed an issue where changes in the config file wouldn't apply after using
/celestcombat reload.
- 🪖 **Elytra Restriction**
- Fixed bug won't allowing players to equip a chestplate when Elytra usage was blocked in combat.
- 🎁 **Kill Reward Duplication**
- Fixed a duplication bug causing kill reward commands to trigger multiple times under specific conditions.
## ✨ New Features & Improvements
- 🧊 **Flight Permission During Combat**
- Introduced a new permission to allow specific players to fly even while in combat.
``
yaml
# Permission: celestcombat.combat.fly
# Description: Allows players to fly while in combat
# Default: op
`
- 🛑 **Admin Kick/Ban Protection**
- Players kicked or banned by server staff will no longer be punished for combat logging.
`yaml
combat:
exempt_admin_kick: true
`
- 🔒 **Toggleable Item Restrictions**
- Item restrictions during combat can now be toggled on/off in the config.
`yaml
item_restrictions:
enabled: true
`
- 🧭 **Per-World Ender Pearl Cooldowns**
- Customize ender pearl cooldowns per world, both in and out of combat.
`yaml
enderpearl_cooldown:
enabled: true
duration: 10s
in_combat_only: true
worlds:
minigames: false
`
- 🧱 **Custom Barrier Block**
- You can now customize the block used for the WorldGuard safezone barrier.
`yaml
safezone_barrier:
block: RED_STAINED_GLASS_PANE
`
- 🌐 **Custom Language System**
- You can now add your own custom language folder for personalized messages.
`yaml
# For custom languages:
# 1. Create a new folder in the language directory
# 2. Use en_US/messages.yml as a template
# 3. Modify messages.yml as needed
# 4. Set 'language' in config to your custom folder name
# ⚠️ Do not modify default language files directly!
``## ✨ New Features & Improvements
- ⏱️ **New Time Format Support**
- Configuration files now support a new, flexible time format.
"20s", "5m", or "1d_2h_30m".- ⚠️ **Important:** Update your old config to match this format or delete it to let the plugin generate a new one.
- 🕰️ **Ender Pearl Cooldown**
- Added a configurable cooldown timer for Ender Pearls that works alongside combat.
- Helps players better time their escapes or movement in combat.
- 🚫 **Creative Fly Disabled in Combat**
- Players are now automatically prevented from using **Creative Fly** while tagged in combat.
- ⚙️ **Combat Tag Optimization**
- Code improvements in how players are tagged during combat.
- Increases performance and reduces server strain in high-activity environments.
- 📝 **Updated Messages File**
- Refreshed language and formatting of message files.
- Delete your current
messages.ymlto let the plugin create an updated version.
👉 *⚠️ Important: Please update your old configuration files to match the new format to avoid errors.
Alternatively, delete your current config file and let the plugin regenerate it.*
## ✨ New Features
- 🔔 **Update Checker**
- Automatically notifies server administrators when a new plugin version is available.
- 💀 **Death Animation System**
- Added configurable death animations to enhance combat immersion.
- Supports multiple animations; a random one plays if more than one is enabled.
``
yaml
death_animation:
enabled: true
# Only play death animation for player kills
only_player_kill: true
# Enable/disable each
# If multiple are enabled, random one will play each time
animation:
lightning: true
fire_particles: false
`
- 🛡️ **WorldGuard Safezone Barrier**
- Introduced a visual barrier for WorldGuard no-PvP regions.
- Helps visually indicate protected zones during combat.
- Players **cannot** enter the safezone while in combat.
- Players **cannot** use ender pearls to teleport into the safezone during combat.
`yaml
safezone_barrier:
duration: 5 # How long the barrier stays in seconds
height: 4 # How tall the barrier is
width: 5 # How wide the barrier is
`
- ⛔ **Combat Item Restrictions**
- Added the ability to block specific items during combat.
- Prevents unfair advantages by restricting key items.
`yaml
# Items that are blocked during combat
# Available items: Foods, Potions, and Elytra
disabled_items:
- CHORUS_FRUIT
- ELYTRA
``