Configuration

Configuration Reference

This page documents all configuration options available in plugins/EternalCombat/config.yml.

Reload Configuration

After making changes, reload the configuration with:

/combatlog reload

General settings

Basic plugin settings that control core behavior.

settings:
  # Notify players about new plugin updates when they join
  notifyAboutUpdates: true
  
  # How long a player stays in combat after being attacked
  combatTimerDuration: 20s
  
  # Worlds where combat logging is disabled
  ignoredWorlds:
    - your_world

Option	Type	Default	Description
notifyAboutUpdates	boolean	true	Notify admins about plugin updates
combatTimerDuration	duration	20s	Combat duration after last hit
ignoredWorlds	list	[]	Worlds where combat is disabled

Combat Duration Examples

10s - Fast-paced servers, quick fights
20s - Standard, recommended for most servers
30s - Longer combat, harder to escape

Combat settings

Controls what players can and cannot do during combat.

combat:
  # Release attacker when victim dies
  releaseAttackerOnVictimDeath: true
  
  # Disable elytra during combat
  disableElytraUsage: true
  disableElytraOnDamage: true
  
  # Disable flying during combat
  disableFlying: true
  
  # Disable firework boosting during combat
  disableFireworks: true
  
  # Block inventory access during combat
  disableInventoryAccess: false

Option	Type	Default	Description
releaseAttackerOnVictimDeath	boolean	true	End combat for attacker when victim dies
disableElytraUsage	boolean	true	Prevent elytra deployment during combat
disableElytraOnDamage	boolean	true	Deactivate elytra when taking damage
disableFlying	boolean	true	Force flying players to the ground
disableFireworks	boolean	true	Block firework boosting during elytra flight
disableInventoryAccess	boolean	false	Block opening containers during combat

Damage cause logging

Control which environmental damage sources trigger combat:

combat:
  # Enable combat from environmental damage
  enableDamageCauseLogging: false
  
  # WHITELIST = only listed causes trigger combat
  # BLACKLIST = all causes except listed ones trigger combat
  damageCauseRestrictionMode: WHITELIST
  
  # Damage causes affected by the mode
  loggedDamageCauses:
    - LAVA
    - CONTACT
    - FIRE
    - FIRE_TICK

Projectile settings

Configure which projectiles should NOT trigger combat:

combat:
  # Projectiles that don't trigger combat
  ignoredProjectileTypes:
    - ENDER_PEARL
    - EGG

Kick punishment settings

Configure when kicked players should NOT be punished for combat logging:

combat:
  # Kick reasons that won't punish the player
  whitelistedKickReasons:
    - "Kicked for inactivity"
    - "Timed out"
    - "Server is restarting"

Server Restart Protection

Adding "Server is restarting" to whitelisted kick reasons prevents players from being punished when you restart your server.

Command restrictions

Block or allow specific commands during combat.

commands:
  # WHITELIST = only listed commands are ALLOWED
  # BLACKLIST = listed commands are BLOCKED
  commandRestrictionMode: BLACKLIST
  
  restrictedCommands:
    - gamemode
    - spawn
    - tp
    - tpa
    - tpaccept

Mode	Behavior
BLACKLIST	Commands in the list are blocked during combat
WHITELIST	Only commands in the list are allowed during combat

Typical Configurations

Survival Server (Blacklist mode)

restrictedCommands:
  - spawn
  - home
  - tpa
  - tpaccept
  - warp

Anarchy Server (minimal restrictions)

restrictedCommands:
  - gamemode
  - fly

Admin settings

Special settings for server administrators.

admin:
  # Exclude admins from combat (requires eternalcombat.bypass)
  excludeAdminsFromCombat: false
  
  # Exclude creative mode players from combat
  excludeCreativePlayersFromCombat: false

Option	Type	Default	Description
excludeAdminsFromCombat	boolean	false	Players with eternalcombat.bypass can't be tagged
excludeCreativePlayersFromCombat	boolean	false	Creative mode players can't be tagged

Block placement restrictions

Prevent players from building during combat.

blockPlacement:
  # Enable block placement restrictions
  disableBlockPlacing: true
  
  # ABOVE = can't place blocks above Y coordinate
  # BELOW = can't place blocks below Y coordinate
  blockPlacementMode: ABOVE
  blockPlacementModeDisplayName: "above"
  
  # Y coordinate for the restriction
  blockPlacementYCoordinate: 40
  
  # Specific blocks to restrict (empty = all blocks)
  restrictedBlockTypes: []

Preventing Sky Base Escapes

Set blockPlacementMode: ABOVE with blockPlacementYCoordinate: 40 to prevent players from building up and escaping during combat.

Ender pearl settings

Configure ender pearl behavior during combat.

pearl:
  # Enable pearl fall damage
  pearlThrowDamageEnabled: true
  
  # Disable throwing pearls during combat
  pearlThrowDisabledDuringCombat: true
  
  # Enable pearl cooldown
  pearlCooldownEnabled: false
  
  # Cooldown duration
  pearlThrowDelay: 3s

Option	Type	Default	Description
pearlThrowDamageEnabled	boolean	true	Pearl damage applies globally
pearlThrowDisabledDuringCombat	boolean	true	Block pearl throwing during combat
pearlCooldownEnabled	boolean	false	Enable cooldown between pearls
pearlThrowDelay	duration	3s	Cooldown duration if enabled

Combat effects

Apply potion effects to players during combat.

effect:
  # Enable custom effects during combat
  customEffectsEnabled: false
  
  # Effects to apply (format: EFFECT_TYPE: AMPLIFIER)
  # Amplifier 0 = Level 1, Amplifier 1 = Level 2, etc.
  customEffects:
    SPEED: 1
    DAMAGE_RESISTANCE: 0

Effect Examples

SPEED: 0 - Speed I (slight boost)
SPEED: 1 - Speed II (noticeable boost)
DAMAGE_RESISTANCE: 0 - Resistance I (8% damage reduction)
GLOWING: 0 - Make players glow (visible through walls)

Drop settings

Configure what players drop when killed during combat.

drop:
  # Drop type:
  # UNCHANGED - Default Minecraft behavior
  # PERCENT - Drop a fixed percentage of items
  # PLAYERS_HEALTH - Drop based on health when logging out
  dropType: UNCHANGED
  
  # Percentage of items to drop (only for PERCENT type)
  dropItemPercent: 100
  
  # Minimum drop percentage for PLAYERS_HEALTH type
  playersHealthPercentClamp: 20
  
  # Apply drop modification to experience
  affectExperience: false

Drop Type	Behavior
UNCHANGED	Normal Minecraft drop behavior
PERCENT	Drop exactly X% of inventory
PLAYERS_HEALTH	Drop more items when logging out with high health

Head drop system

drop:
  # Enable player head drops
  headDropEnabled: false
  
  # Chance to drop head (0-100)
  headDropChance: 0.0
  
  # Only drop heads during combat
  headDropOnlyInCombat: true
  
  # Display name of dropped head
  headDropDisplayName: "{PLAYER}'s Head"
  
  # Lore lines
  headDropLore:
    - "Slain by {KILLER}"
    - "Collected in battle"

Crystal PvP settings

Configure combat tagging from explosives.

crystalPvp:
  # Tag players from crystal damage
  tagFromCrystals: true
  
  # Tag players from respawn anchor damage
  tagFromRespawnAnchor: true

Knockback settings

Configure knockback when players try to enter protected regions.

knockback:
  # Knockback strength multiplier
  multiplier: 1
  
  # Delay before forcing player out of safe zone
  forceDelay: 1s

Border settings

Configure the visual combat border that shows protected regions.

border:
  # How far the border is visible (in blocks)
  distance: 6.5
  
  block:
    # Enable block animation
    enabled: true
    
    # Block type for border
    # Custom: RAINBOW_GLASS, RAINBOW_WOOL, RAINBOW_TERRACOTTA, RAINBOW_CONCRETE
    type: RAINBOW_GLASS
    
    # Animation update delay (lower = smoother but more resource intensive)
    updateDelay: 250ms
    chunkCacheDelay: 300ms
  
  particle:
    # Enable particle animation
    enabled: true
    
    # Particle type
    type: DUST
    
    # Color: hex color like "#ca4c45" or "RAINBOW"
    color: RAINBOW
    
    count: 1
    scale: 1.7

Performance Tip

If you experience lag, try:

Increasing updateDelay and chunkCacheDelay
Disabling one of the animations (block or particle)
Reducing distance

Region settings

Configure protected regions where players can't enter during combat.

regions:
  # Regions where combat is blocked - PUT YOUR REGION NAMES HERE
  blockedRegions:
    - spawn
    - safezone
  
  # Prevent entering WorldGuard regions with PvP disabled
  preventPvpInRegions: true
  
  # Default spawn region radius (if WorldGuard is not used)
  restrictedRegionRadius: 10

Setting Up Regions

To block a region during combat, you need to add its exact name to the blockedRegions list:

Create a WorldGuard region (e.g., /rg define spawn)
Add the region name to blockedRegions in config
Reload with /combatlog reload

Players in combat will now be blocked from entering that region.

For more details, see the Regions page.

Message settings

EternalCombat uses MiniMessage format for all messages. You can customize colors, gradients, and formatting.

Combat notification types

You can display combat status using different notification types. Use CodeTabs to see examples:

messagesSettings:
  combatNotification:
    actionbar: '<dark_red>Combat ends in: <red>{TIME}</red>'

Configuration

Configuration Reference

Reload Configuration

General settings

Combat Duration Examples

Combat settings

Damage cause logging

Projectile settings

Kick punishment settings

Server Restart Protection

Command restrictions

Typical Configurations

Admin settings

Block placement restrictions

Preventing Sky Base Escapes

Ender pearl settings

Combat effects

Effect Examples

Drop settings

Head drop system

Crystal PvP settings

Knockback settings

Border settings

Performance Tip

Region settings

Setting Up Regions

Message settings

Combat notification types

Next steps

Commands

Regions

Configuration Reference

Reload Configuration

General settings

Combat Duration Examples

Combat settings

Damage cause logging

Projectile settings

Kick punishment settings

Server Restart Protection

Command restrictions

Typical Configurations

Admin settings

Block placement restrictions

Preventing Sky Base Escapes

Ender pearl settings

Combat effects

Effect Examples

Drop settings

Head drop system

Crystal PvP settings

Knockback settings

Border settings

Performance Tip

Region settings

Setting Up Regions

Message settings

Combat notification types

Next steps

Commands

Regions