zCombat - Advanced Combat Tagging Plugin -----
dvanced Combat Tagging Plugin
zCombat - Advanced Combat Tagging Plugin
ᴀᴅᴠᴀɴᴄᴇᴅ ᴄᴏᴍʙᴀᴛ ᴛᴀɢɢɪɴɢ ꜱʏꜱᴛᴇᴍ ꜰᴏʀ ᴍɪɴᴇᴄʀᴀꜰᴛ
A comprehensive combat tagging plugin that prevents players from escaping PvP situations by logging out or using commands. Features a modern GUI system with real-time statistics and configurable settings.
⚔️ Features
- Combat Tagging - 20-second configurable combat timer activation on damage
- Action Bar Display - Real-time countdown with ᴍɪɴᴇᴄʀᴀꜰᴛ ꜱᴍᴀʟʟ ꜰᴏɴᴛ styling
- Command Blocking - Configurable command restrictions during combat
- Inventory Protection - Prevents inventory manipulation during combat
- Logout Prevention - Eliminates combat logging by killing disconnected players
- Admin GUI - Dynamic statistics panel with player management
- Statistics Tracking - Combat counts, logout kills, and active player monitoring
- Adventure API - Modern text components with color and formatting support
Commands & Permissions
| Command | Permission | Description |
| /zcombat | zcombat.use | Main command - shows help |
| /zcombat admin | zcombat.admin | Opens admin GUI panel |
| /zcombat reload | zcombat.reload | Reloads plugin configuration |
| /zcombat status | zcombat.admin | Shows plugin statistics |
| /zcombat version | zcombat.use | Displays plugin version |
| Permission | Default | Description |
| zcombat.use | true | Basic plugin usage |
| zcombat.admin | op | Admin access and GUI |
| zcombat.bypass | false | Bypass combat tagging |
| zcombat.reload | op | Reload configuration |
Requirements
- Minecraft Version: 1.20+ to 1.21.7+
- Java Version: 17 or higher
- Server Software: Spigot/Paper/Purpur
- Dependencies: None (all bundled)
⚙️ Configuration
Code (Text):
[color=#55FF55]combat:
# Combat timer duration in seconds
duration: 20
# Kill player on logout during combat
kill-on-logout: true
# Commands allowed during combat
allowed-commands:
- "shop"
- "help"
- "rules"
# Block all commands except allowed ones
block-commands: true
# Block inventory interactions during combat
block-inventory: true
gui:
# GUI title with small font styling
title: "ᴢᴄᴏᴍʙᴀᴛ ᴀᴅᴍɪɴ ᴘᴀɴᴇʟ"
# Auto refresh interval in seconds
refresh-interval: 5
# Enable sound effects
sounds: true
actionbar:
# Enable action bar messages
enabled: true
# Action bar update interval in ticks
update-interval: 20
# Use small font for action bar
use-small-font: true[/color]
# Combat timer duration in seconds
duration: 20
# Kill player on logout during combat
kill-on-logout: true
# Commands allowed during combat
allowed-commands:
- "shop"
- "help"
- "rules"
# Block all commands except allowed ones
block-commands: true
# Block inventory interactions during combat
block-inventory: true
gui:
# GUI title with small font styling
title: "ᴢᴄᴏᴍʙᴀᴛ ᴀᴅᴍɪɴ ᴘᴀɴᴇʟ"
# Auto refresh interval in seconds
refresh-interval: 5
# Enable sound effects
sounds: true
actionbar:
# Enable action bar messages
enabled: true
# Action bar update interval in ticks
update-interval: 20
# Use small font for action bar
use-small-font: true[/color]
Message Customization
All messages support Minecraft color codes with & formatting:
Code (Text):
[color=#FF5555]combat:
tagged: "&c&lᴄᴏᴍʙᴀᴛ! &7You are now in combat for &c{time} &7seconds!"
countdown: "&c⚔ &7ᴄᴏᴍʙᴀᴛ: &c{time}s"
ended: "&a&lᴄᴏᴍʙᴀᴛ ᴇɴᴅᴇᴅ! &7You are now safe."[/color]
tagged: "&c&lᴄᴏᴍʙᴀᴛ! &7You are now in combat for &c{time} &7seconds!"
countdown: "&c⚔ &7ᴄᴏᴍʙᴀᴛ: &c{time}s"
ended: "&a&lᴄᴏᴍʙᴀᴛ ᴇɴᴅᴇᴅ! &7You are now safe."[/color]
- Download the zCombat-1.0.0.jar file
- Place it in your server's plugins folder
- Restart your server
- Configure config.yml and messages.yml to your preferences
- Use /zcombat reload to apply changes
Statistics
The plugin tracks:
- ᴛᴏᴛᴀʟ ᴄᴏᴍʙᴀᴛ ɪɴᴄɪᴅᴇɴᴛꜱ - Total combat tags initiated
- ʟᴏɢᴏᴜᴛ ᴋɪʟʟꜱ - Players killed for combat logging
- ᴀᴄᴛɪᴠᴇ ᴄᴏᴍʙᴀᴛ - Currently tagged players
- ᴀᴠᴇʀᴀɢᴇ ᴄᴏᴍʙᴀᴛ ᴛɪᴍᴇ - Statistical analysis
API Usage
Access the combat manager in your plugins:
Code (Text):
[color=#FF5555]ZCombat plugin = (ZCombat) Bukkit.getPluginManager().getPlugin("zCombat");
CombatManager combatManager = plugin.getCombatManager();
// Check if player is in combat
boolean inCombat = combatManager.isInCombat(player);
// Get remaining combat time
int timeLeft = combatManager.getCombatTime(player);[/color]
CombatManager combatManager = plugin.getCombatManager();
// Check if player is in combat
boolean inCombat = combatManager.isInCombat(player);
// Get remaining combat time
int timeLeft = combatManager.getCombatTime(player);[/color]
For issues or suggestions:
- Check the console for error messages
- Verify your configuration files
- Ensure all required permissions are set
- Use /zcombat status for diagnostics
License
This project is licensed under the MIT License.
ᴍᴀᴅᴇ ᴡɪᴛʜ ❤️ ʙʏ GamingHuzai
Resource Information
Author:
----------
Total Downloads:
39
First Release:
Jul 8, 2025
Last Update:
Jul 8, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings