Dcombat

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： folia paper purpur spigot

标签： game-mechanics management utility

?️ Dcombat — Complete Wiki

A powerful combat plugin for Paper and Folia servers. Combat tag players, punish loggers, control drops, restrict abilities, render visual borders, and integrate with your existing server stack — all from a single config file.

? Table of Contents

• Requirements & Installation
• Commands & Permissions
• Configuration Reference
  • Settings
  • Pearl Settings
  • Trident Settings
  • Effect Settings
  • Death Settings
  • Drop Settings
  • Knockback Settings
  • Border Settings
  • Block Placement Settings
  • Crystal PvP Settings
  • Command Settings
  • Admin Settings
  • Region Settings
  • Combat Settings
  • Inventory Settings
  • Placeholder Settings
  • Messages Settings
  • Lifesteal Settings
• PlaceholderAPI
• Developer API
• Plugin Integrations
• License

? Requirements & Installation

Requirements

Optional integrations (the plugin loads fine without these):

Installation

1. Download Dcombat and drop the jar into your plugins/ folder.
2. Install PacketEvents and any optional plugins you want.
3. Start the server — plugins/Dcombat/config.yml and a wiki.txt reference will be generated automatically.
4. Edit config.yml to your liking.
5. Run /dcombat reload to apply changes without a restart.

⌨️ Commands & Permissions

All commands use the root label /combatlog (alias: /combat).

Admin Commands

Tag-Out Commands

Tag-out grants a player temporary immunity from being combat-tagged.

Alias: /tagout can also be used as /tagimmunity

Bypass Permission

⚙️ Configuration Reference

After making changes, run /combatlog reload. A wiki.txt quick-reference is also written to the plugin's data folder automatically.

1️⃣ Settings

settings:
  notifyAboutUpdates: true
  combatTimerDuration: 20s
  ignoredWorlds:
    - your_world

2️⃣ Pearl Settings

pearl:
  pearlThrowDamageEnabled: true
  pearlThrowDisabledDuringCombat: true
  pearlCooldownEnabled: false
  pearlExtendsCombatTag: false
  pearlThrowDelay: 3s

3️⃣ Trident Settings

trident:
  tridentRiptideDisabledDuringCombat: false
  tridentRiptideExtendsCombatTag: false
  tridentRiptideDelay: 10s

4️⃣ Effect Settings

effect:
  customEffectsEnabled: false
  customEffects:
    SPEED: 1
    RESISTANCE: 0

5️⃣ Death Settings

Controls visual effects triggered on player death.

death:
  lightning:
    afterEveryDeath: false
    inCombat: true
  firework:
    afterEveryDeath: false
    inCombat: false
    power: 2
    fireworkType: BALL
    primaryColor: "#a80022"
    fadeColor: "#0a0a0a"
    particlesEnabled: true
    mainParticle: CAMPFIRE_COSY_SMOKE
    mainParticleCount: 3
    secondaryParticle: SMALL_FLAME
    secondaryParticleCount: 3

⚡ Lightning

? Firework

6️⃣ Drop Settings

Controls how a player's inventory is handled when they die during combat.

drop:
  dropEventPriority: NORMAL
  dropType: UNCHANGED
  dropItemPercent: 100
  playersHealthPercentClamp: 20
  affectExperience: false

dropType options:

7️⃣ Knockback Settings

knockback:
  multiplier: 1.0
  vertical: 0.2
  forceTeleport:
    delay: 1s
    unsafeGroundBlocks: []
    airBlocks: []

8️⃣ Border Settings

A visual border rendered around the player while they are in combat.

border:
  distance: 6.5
  block:
    # block-based border animation options
  particle:
    # particle-based border animation options

9️⃣ Block Placement Settings

blockPlacement:
  disableBlockPlacing: true
  blockPlacementMode: ABOVE
  blockPlacementModeDisplayName: "above"
  blockPlacementYCoordinate: 40
  restrictedBlockTypes: []

? Crystal PvP Settings

crystalPvp:
  tagFromCrystals: true
  tagFromRespawnAnchor: true

? Command Settings

command:
  commandRestrictionMode: BLACKLIST
  restrictedCommands:
    - spawn
    - home

?️ Admin Settings

admin:
  excludeAdminsFromCombat: false
  excludeCreativePlayersFromCombat: false

?️ Region Settings

Requires WorldGuard to be installed.

region:
  blockedRegions:
    - your_region
  preventPvpInRegions: true
  restrictedRegionRadius: 10

⚔️ Combat Settings

combat:
  releaseAttackerOnVictimDeath: true
  disableElytraUsage: true
  disableElytraOnDamage: true
  disableFlying: true
  unequipElytraOnCombat: true
  disableFireworks: true
  enableDamageCauseLogging: false
  damageCauseRestrictionMode: WHITELIST
  loggedDamageCauses: []
  ignoredProjectileTypes:
    - ENDER_PEARL
    - EGG
  quitPunishmentEventPriority: NORMAL
  whitelistedKickReasons: []

? Inventory Settings

inventory:
  inventoryAccessMode: ALLOW_ALL
  restrictedInventoryTypes:
    - CHEST
    - ENDER_CHEST

? Placeholder Settings

placeholders:
  isInCombatFormattedTrue: "In Combat"
  isInCombatFormattedFalse: "Not In Combat"

? Messages Settings

All messages use MiniMessage formatting and can target chat, action bar, title, or play a sound.

Available placeholders:

Message keys:

❤️ Lifesteal Settings

Requires LifestealCore to be installed.

lifesteal:
  enabled: false
  heartsToSteal: 1
  stealOnlyInCombat: true
  stealOnKill: true
  stealOnDeath: false
  eliminateOnZeroHearts: true
  notifyOnKill: true

? PlaceholderAPI

Requires PlaceholderAPI to be installed. The identifier is dcombat.

? Developer API

Dcombat exposes a DcombatApi interface for other plugins.

DcombatApi api = DcombatProvider.get();

FightManager           fightManager  = api.getFightManager();
RegionProvider         regions       = api.getRegionProvider();
PearlService           pearls        = api.getFightPearlService();
FightTagOutService     tagOut        = api.getFightTagOutService();
FightEffectService     effects       = api.getFightEffectService();
DropService            drops         = api.getDropService();
DropKeepInventoryService keepInv     = api.getDropKeepInventoryService();

Events

FightTagEvent — fired when a player is combat-tagged (cancellable)

@EventHandler
public void onTag(FightTagEvent event) {
    UUID player = event.getPlayer();
    CauseOfTag cause = event.getCause(); // PVP, COMMAND, etc.
    event.setCancelled(true); // prevent the tag
}

FightUntagEvent — fired when a player's combat tag is removed (cancellable)

@EventHandler
public void onUntag(FightUntagEvent event) {
    UUID player = event.getPlayer();
    CauseOfUnTag cause = event.getCause(); // DEATH, TIMER, COMMAND, etc.
}

BorderShowAsyncEvent / BorderHideAsyncEvent

Fired asynchronously when the visual combat border is shown or hidden for a player.

? Plugin Integrations

? License

Copyright (c) 2026 Devamy. All rights reserved.

This project is proprietary source code. No permission is granted to copy, modify, distribute, sell, sublicense, or claim this code as someone else's work without prior written permission from the copyright holder.