Configuration

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

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

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

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

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

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

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

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

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

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

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

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

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

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