No further updates, bug fixes, or support will be provided.
MasterCombat is a modern Minecraft combat plugin inspired by DonutSMP and made for MasterSMP (mastersmp.net), developed by OPmasterLEO.
It features advanced combat tagging, PvP protection for new players, action bar timers, WorldGuard region support, and more.
| Feature | Description |
|---|---|
| 🏷️ Combat Tagging | Smart tagging system based on real damage, not just hits |
| 🛡️ PvP Protection | Configurable newbie protection system |
| ⏱️ Action Bar Timer | Visual combat duration display |
| 🌍 WorldGuard Support | Respects PvP-denied regions |
| ⚡ Folia Support | Full async scheduling compatibility |
| 💥 Advanced Damage Linking | Accurate attacker tracking for: • End Crystal • TNT • Respawn Anchor • Bed • Pet • Projectile • Fishing Rod |
| ✨ Glowing Indicator | Visual effect for tagged players |
| 🚫 Command Blocking | Customizable command restrictions |
| 🔄 Update System | Automatic updates with download support |
Any issues or suggestions should be reported in the Issues tab.
You are free to DM me on Discord (opmasterleo)!
🚀 Quick Start Guide
- 📦 Download latest jar from GitHub Releases
- 📁 Place
MasterCombat-v<version>.jarin your server'spluginsfolder - 🔄 Restart your server
⚠️ Do not use/reload
| Step | Action |
|---|---|
| 1️⃣ | Run /combat update to check for updates |
| 2️⃣ | If available, run command again to download |
| 3️⃣ | Restart server to apply update |
| 4️⃣ | (Optional) Delete old config.yml for defaults |
💡 Updates can be checked from both in-game and console
📁 Location: plugins/MasterCombat/config.yml
🔧 Customizable Features:
├── ⏱️ Combat duration
├── 🛡️ Protection time
├── 🚫 Blocked commands
├── ✨ Glowing effects
└── 📝 Messages (PlaceholderAPI support)| Command | Description | Permission |
|---|---|---|
/combat reload |
🔄 Reload configuration | combat.admin |
/combat toggle |
🔀 Toggle combat tagging | combat.admin |
/combat visibility |
👁️ Toggle combat UI visibility | none |
/combat update |
📥 Check/download updates | combat.admin |
/combat api |
📊 View API status | combat.admin |
/combat protection |
🛡️ Check protection time | combat.protection |
/removeprotect |
🚫 Disable newbie protection | combat.protection |
💡 Command names are configurable in settings
| Permission | Description | Default |
|---|---|---|
combat.admin |
👑 Administrative access | op |
combat.protection |
🛡️ Protection commands | true |
💡 Permissions can be managed with any permission plugin
Add the JitPack repository to your pom.xml:
<repositories>
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
</repositories>Add the dependency:
<dependency>
<groupId>com.github.OPmasterLEO</groupId>
<artifactId>MasterCombat</artifactId>
<version>VERSION</version> <!-- Replace with latest version from JitPack badge -->
</dependency>Add the JitPack repository:
repositories {
maven { url 'https://jitpack.io' }
}Add the dependency:
dependencies {
implementation 'com.github.OPmasterLEO:MasterCombat:VERSION' // Replace VERSION
}💡 Check the JitPack badge at the top for the latest version number
| Method | Description | Returns |
|---|---|---|
tagPlayer(UUID) |
Tag a player for combat | void |
untagPlayer(UUID) |
Remove combat tag | void |
getMasterCombatState(UUID) |
Get combat state ("Fighting"/"Idle") | String |
isPlayerGlowing(UUID) |
Check if player is glowing | boolean |
getMasterCombatStateWithGlow(UUID) |
State with glow annotation | String |
getRemainingCombatTime(UUID) |
Get remaining combat seconds | int |
getTotalCombatTime(UUID) |
Get total combat duration | long |
getCombatOpponent(UUID) |
Get opponent's UUID | UUID |
isCombatSystemEnabled() |
Check if system is active | boolean |
getActiveCombatCount() |
Count active combat players | int |
setCombatVisibility(UUID, boolean) |
Show/hide combat UI | void |
isCombatVisible(UUID) |
Check UI visibility | boolean |
💡 Combat Visibility Feature: Hide combat UI (messages, action bar timer) while keeping mechanics active. Perfect for custom UIs or stealth modes!
import net.opmasterleo.combat.api.MasterCombatAPI;
import net.opmasterleo.combat.api.MasterCombatAPIProvider;
public class Example {
public void example() {
// Get API instance
MasterCombatAPI api = MasterCombatAPIProvider.get();
// Basic combat operations
api.tagPlayer(player.getUniqueId());
api.untagPlayer(player.getUniqueId());
// Check combat status
String state = api.getMasterCombatState(player.getUniqueId());
boolean glowing = api.isPlayerGlowing(player.getUniqueId());
String stateWithGlow = api.getMasterCombatStateWithGlow(player.getUniqueId());
// Combat timing information
int remainingTime = api.getRemainingCombatTime(player.getUniqueId());
long totalTime = api.getTotalCombatTime(player.getUniqueId());
// Combat relationships
UUID opponent = api.getCombatOpponent(player.getUniqueId());
// System status
boolean systemEnabled = api.isCombatSystemEnabled();
int activeCombats = api.getActiveCombatCount();
// Combat visibility control (NEW in v5.2.4+)
api.setCombatVisibility(player.getUniqueId(), false); // Hide combat UI
boolean isVisible = api.isCombatVisible(player.getUniqueId());
api.setCombatVisibility(player.getUniqueId(), true); // Show combat UI
// Example: Print combat status
if (api.isCombatSystemEnabled()) {
System.out.printf("Player %s is %s with %d seconds remaining%n",
player.getName(),
api.getMasterCombatStateWithGlow(player.getUniqueId()),
api.getRemainingCombatTime(player.getUniqueId()));
UUID opponentId = api.getCombatOpponent(player.getUniqueId());
if (opponentId != null) {
System.out.printf("Fighting against: %s%n",
Bukkit.getPlayer(opponentId).getName());
}
// Check if player has UI visible
if (!api.isCombatVisible(player.getUniqueId())) {
System.out.println("Player has combat UI hidden (combat still active)");
}
}
}
}MasterCombat supports placeholders in its messages and UI. These resolve automatically, and if PlaceholderAPI is installed, any PAPI placeholders inside your messages will be applied too.
Built-in placeholders provided by the plugin (all prefixed with mastercombat_):
| Placeholder | Description |
|---|---|
%mastercombat_time% |
Remaining combat time formatted as MM:SS |
%mastercombat_command% |
The configured “disable protection” command name (from NewbieProtection.settings.disableCommand, defaults to removeprotect) |
%mastercombat_prefix% |
Message prefix from config (Messages.Prefix) |
%mastercombat_duration% |
Configured combat duration in seconds (General.duration) |
%mastercombat_enabled% |
Whether combat system is currently enabled (true/false) |
%mastercombat_status% |
Plugin status: Fighting or Idle |
%mastercombat_visibility% |
Player’s combat UI visibility: ᴏɴ or ᴏꜰꜰ (lowercase) |
Notes:
- You can also use any PlaceholderAPI placeholders if PlaceholderAPI is present.
- Developers can register additional custom placeholders at runtime via
PlaceholderAPI.registerCustomPlaceholder(String placeholder, String value). %mastercombat_time%is only meaningful in contexts where the message is rendered with a known remaining time (e.g., actionbar or combat messages).- Legacy tokens like
%prefix%,%combat_enabled%,%combat_duration%, and%command%are still accepted for backward compatibility, but new configs should prefer themastercombat_variants.
Example (config):
Messages:
Prefix: "&7[&cCombat&7] "
NowInCombat:
type: both
text: "%mastercombat_prefix% &fYou are now in combat for &c%mastercombat_time%&f."
ElytraDisabled:
type: actionbar
text: "%mastercombat_prefix% &cElytra disabled during combat (&f%mastercombat_time%&c left)"This plugin features advanced multi-threading support across all major Minecraft server platforms:
| Platform | Version | Key Features |
|---|---|---|
| Paper | 1.16.5+ | ✨ Native async scheduler ⚡ Multi-threaded worker pool |
| Folia | Latest | 🌍 Region-aware scheduling ⚡ Native async support |
| Canvas | Latest | 🌍 Region-aware tasks ⚡ Async capabilities |
| Platform | Version | Key Features |
|---|---|---|
| Legacy Paper | Pre-1.16.5 | 🔄 Custom thread pool ⚙️ Legacy task compatibility |
| Modern Spigot | 1.14+ | ⚡ Async scheduling 🔄 Multi-thread support |
| Legacy Spigot | Pre-1.14 | 🔄 Custom thread pool ⚙️ Backward compatibility |
| Platform | Features |
|---|---|
| ArcLight | 🔒 ClassLoader-aware execution ⚡ Specialized task handling |
- Adaptive Threading: Auto-scales worker pool (2-16 threads) based on CPU cores
- Smart Scheduling: Automatic platform detection for optimal task distribution
- Region Awareness: Enhanced performance with Folia/Canvas region support
- Legacy Support: Seamless operation on older server versions
- Custom Pooling: Dedicated thread management for legacy platforms
📝 For detailed compatibility information and latest updates, check our GitHub Releases page.
| Method | Contact |
|---|---|
| 🐛 GitHub Issues | Create Issue |
| 💬 Discord | DM opmasterleo |
⚡ Quick Response Guarantee: All security reports receive priority attention
🛡️ Supported Versions: Security fixes are backported to maintained releases
