WARDENX COMBAT
Advanced Combat Tag System for PvP/HCF Servers
Paper 1.21.4+ | Java 21 | WorldGuard Required | PlaceholderAPI Support
What is WardenxCombat?
WardenxCombat is a complete combat management solution for PvP and HCF servers. When players engage in combat, they get "tagged" and cannot escape using exploits like disconnecting, flying, using elytras, or entering safezones.
More than just a combat tag - it includes killing sprees, kill effects, duels, statistics, rewards, and a full GUI system!
ActionBar showing combat timer countdown during PvP
Main Features
Combat Tag System
The core of the plugin - a robust combat tagging system that prevents combat logging and exploits:
- Configurable Duration - Set how long players stay in combat (default: 15 seconds)
- Visual Countdown - ActionBar or BossBar display with dynamic colors
- Battle Summary - Detailed post-combat statistics with hover text
- Smart Detection - Detects all damage types including Mace, Wind Charge, and Trident
BossBar display showing combat timer with color changing as time decreases
Complete Anti-Exploit System
8 different anti-exploit modules to prevent ALL escape methods:
- Anti Combat Log - Instant death when disconnecting during combat
- Anti Elytra - Prevents elytra usage during combat
- Anti Pearl - Configurable ender pearl cooldown/block
- Anti Riptide - Blocks trident riptide enchantment
- Anti Portal - Prevents Nether/End portal usage
- Anti Safezone - Pushes players out of WorldGuard safezones
- Anti Fly - Disables flight during combat
- Anti Vehicle/Mount - Prevents mounting horses, boats, etc.
Player being pushed back when trying to enter a safezone during combat
Each module can be individually enabled/disabled and has its own bypass permission!
Killing Spree System - "El Cosechador"
A unique feature that tracks consecutive kills and grants special status:
- Cosechador Title - Player with the highest kill streak becomes "El Cosechador" (The Harvester)
- Particle Effects - Special visual effects follow the spree holder
- Persistent Data - Spree status survives server restarts
- Ragnarok Arena - Special battle when multiple players contest the title!
Player with Cosechador status showing particle effects
Ragnarok System:
When another player reaches the required kills to challenge the Cosechador, both are teleported to a special arena at Y=200 (built with bedrock walls) for an epic 1v1 battle!
Kill Effects System
Let players choose custom death animations for their victims:
- SkySmash Effect - Launches victim to the sky then crashes them down
- Preview System - Players can preview effects before selecting
- Permission Based - Control access to each effect
- Easy to Extend - Simple interface to add custom effects
Kill Effect selection GUI with preview option
1v1 Duel System
Complete duel system for fair fights:
- Duel Requests - Challenge any player to a 1v1
- Custom Arenas - Configure multiple duel arenas
- Spawn Points - Set specific spawn locations for each arena
- Accept/Deny - Players can accept or decline challenges
Duel request message with clickable accept/deny buttons
Statistics & Leaderboards
Complete statistics tracking with database support:
- Total Kills & Deaths
- Kill/Death Ratio (KDR)
- Current Kill Streak
- Best Kill Streak (Historical)
- Weapon-Specific Kills - Mace, Trident, Wind Charge tracking
- Top 10 Leaderboards - For kills, deaths, KDR, and streaks
Player statistics GUI showing kills, deaths, KDR, and streaks
Database Support:
- SQLite - Default, no configuration needed
- MySQL - For networks and large servers
Reward System
Reward players for kills with customizable rewards:
- Command Rewards - Execute any command on kill
- Item Rewards - Give items directly
- Money Rewards - Compatible with any economy plugin
- Configurable Chances - Set probability for each reward
YAML:
rewards:
diamond_reward:
chance: 25
commands:
- "give {player} diamond 1"
- "eco give {player} 100"Command & Item Blocking
Prevent players from using certain commands or items during combat:
Command Blocker:
- Block ALL commands except whitelisted ones
- Configurable whitelist via GUI or config
- Prevents /home, /spawn, /tpa abuse
Item Blocker:
- Block shulker box opening
- Block ender chest access
- Block chorus fruit teleportation
- Easily add more items
Message shown when player tries to use a blocked command during combat
Full GUI System
Beautiful and functional GUIs for everything:
- Player Menu (/wct) - Main hub for all features
- Stats Menu - View personal and leaderboard statistics
- Settings Menu - Toggle personal settings
- Combat Menu - Combat-related options
- Duels Menu - Duel management
- Kill Effects GUI - Select death animations
- Spree Effects GUI - Toggle Cosechador particle effects
Main player menu GUI showing all available options
All GUIs are 100% configurable via YAML files in the guis/ folder!
PvP Toggle
Allow players to toggle their PvP status:
- Players can enable/disable personal PvP
- Configurable cooldown between toggles
- Permission-based access
- Visual indicators
Visual Effects
Display Options
Choose how to display combat information:
- ActionBar - Clean, minimal display above hotbar
- BossBar - Large bar at top of screen with progress
- Scoreboard - Sidebar display during combat
BossBar Customization:
- Colors: RED, YELLOW, GREEN, BLUE, PURPLE, PINK, WHITE
- Styles: SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
- Dynamic color change based on remaining time
Comparison of ActionBar, BossBar, and Scoreboard display options
Damage Indicators
Visual feedback for combat damage:
- Floating damage numbers
- Critical hit indicators
- Configurable colors and formats
Universal Color Support
Supports all color formats with automatic detection:
- MiniMessage:
<red>,<gradient:red:blue>,<bold>,<rainbow> - HEX Codes:
#FF5555or&#FF5555 - Legacy Codes:
&c,&l,&o,&n
Uses Kyori Adventure API for modern text components!
PlaceholderAPI Integration
Full PlaceholderAPI support for scoreboards, holograms, TAB plugins, and more:
Combat Placeholders:
%wardenxcombat_incombat%- true/false%wardenxcombat_incombat_formatted%- "In Combat" / "Safe" with colors%wardenxcombat_time%- Remaining seconds%wardenxcombat_time_formatted%- Formatted time (12s)%wardenxcombat_opponent%- Last attacker name
Statistics Placeholders:
%wardenxcombat_kills%- Total kills%wardenxcombat_deaths%- Total deaths%wardenxcombat_kdr%- Kill/Death ratio%wardenxcombat_streak%- Current kill streak%wardenxcombat_beststreak%- Best kill streak%wardenxcombat_mace_kills%- Kills with Mace%wardenxcombat_trident_kills%- Kills with Trident%wardenxcombat_windcharge_kills%- Kills with Wind Charge
Leaderboard Placeholders:
%wardenxcombat_top_kills_1%- #1 killer name%wardenxcombat_top_kills_1_value%- #1 killer kills%wardenxcombat_top_kdr_1%- #1 KDR player%wardenxcombat_top_streak_1%- #1 streak holder- ...supports positions 1-10 for kills, deaths, kdr, streak
Scoreboard using WardenxCombat placeholders
Commands
Main Commands
- /combat - Main admin command (Aliases: /ct, /combattag, /wcombat)
- /combat reload - Reload configuration
- /combat stats [player] - View statistics
- /combat status [player] - Check combat status
- /combat tag <player> [seconds] - Manually tag a player
- /combat untag <player> - Remove combat tag
- /combat gui - Open admin GUI
- /combat summary - View last battle summary
Player Commands
- /wct - Open player menu (Alias: /wardenxcombat)
- /killeffect - Select kill effect (Alias: /ke)
- /pvp - Toggle personal PvP (Alias: /togglepvp)
- /duel <player> - Challenge player to duel
- /duel accept - Accept duel request
- /duel deny - Decline duel request
Output of /combat help showing all available subcommands
Permissions
Admin Permissions
- wardenx.combat.* - All permissions (Default: op)
- wardenx.combat.admin - Admin commands (Default: op)
- wardenx.combat.gui - Access admin GUI (Default: op)
Bypass Permissions
- wardenx.combat.bypass.commands - Bypass command blocking
- wardenx.combat.bypass.elytra - Bypass elytra restriction
- wardenx.combat.bypass.pearl - Bypass pearl cooldown
- wardenx.combat.bypass.safezone - Bypass safezone pushback
- wardenx.combat.bypass.portal - Bypass portal restriction
- wardenx.combat.bypass.items - Bypass item blocking
- wardenx.combat.bypass.fly - Bypass flight restriction
- wardenx.combat.bypass.vehicle - Bypass vehicle restriction
Player Permissions
- wardenx.combat.stats - View own stats (Default: true)
- wardenx.combat.stats.others - View other players' stats (Default: op)
- wardenx.killeffect.* - Access to all kill effects
- wardenx.killeffect.preview - Preview effects before selecting
Configuration Files
WardenxCombat uses multiple configuration files for maximum flexibility:
- config.yml - Main plugin settings
- messages.yml - All user-facing messages
- killing-spree.yml - Killing spree system
- rewards.yml - Kill reward definitions
- duels.yml - Duel system settings
- pve-death-messages.yml - PvE death messages
- guis/ - All GUI layouts (player-menu.yml, stats-menu.yml, etc.)
Example config.yml
YAML:
# Combat Settings
combat:
duration: 15 # Seconds in combat
refresh-on-hit: true # Reset timer on each hit
# Display Type: ACTIONBAR, BOSSBAR, BOTH
display:
type: BOSSBAR
bossbar:
color: RED
style: SOLID
# Anti-Exploit Modules
anti-exploit:
combat-log:
enabled: true
kill-on-logout: true
elytra:
enabled: true
pearl:
enabled: true
cooldown: 16
riptide:
enabled: true
portal:
enabled: true
safezone:
enabled: true
push-strength: 1.5
fly:
enabled: true
vehicle:
enabled: true
# Command Blocking
commands:
block-all-except-whitelist: true
whitelist:
- "msg"
- "r"
- "tell"
# Item Blocking
items:
block-shulker: true
block-enderchest: true
block-chorus: true
# Database
storage:
type: sqlite # sqlite or mysql
mysql:
host: localhost
port: 3306
database: wardenxcombat
username: root
password: ""Requirements
- Server: Paper 1.21.4 or higher
- Java: 21
- Required: WorldGuard (for safezone detection)
- Optional: PlaceholderAPI (for placeholders)
Installation
- Download WardenxCombat.jar
- Place in your plugins/ folder
- Make sure WorldGuard is installed
- Restart your server
- Configure in plugins/WardenxCombat/config.yml
- Use /combat reload to apply changes
Support
Need help? Have suggestions? Feel free to:
- Leave a message in the discussion section
- Contact me via private message
- Open a ticket for technical issues
Thank you for choosing WardenxCombat!
Made with love for the PvP/HCF community
