Configuration

Configuration Reference#

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

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 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"

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: []

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

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

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

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>'

Next steps#

Commands

Learn all available commands

Regions

Set up protected regions