eternalcombat
8 min read
Configuration
Complete configuration reference for EternalCombat
Complete configuration reference for EternalCombat
This page documents all configuration options available in plugins/EternalCombat/config.yml.
After making changes, reload the configuration with:
/combatlog reloadBasic 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 |
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 |
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
Configure which projectiles should NOT trigger combat:
combat:
# Projectiles that don't trigger combat
ignoredProjectileTypes:
- ENDER_PEARL
- EGG
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"
Adding "Server is restarting" to whitelisted kick reasons prevents players from being punished when you restart your server.
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 |
Survival Server (Blacklist mode)
restrictedCommands:
- spawn
- home
- tpa
- tpaccept
- warp
Anarchy Server (minimal restrictions)
restrictedCommands:
- gamemode
- fly
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 |
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: []
Set blockPlacementMode: ABOVE with blockPlacementYCoordinate: 40 to prevent players from building up and escaping during combat.
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 |
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
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 |
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"
Configure combat tagging from explosives.
crystalPvp:
# Tag players from crystal damage
tagFromCrystals: true
# Tag players from respawn anchor damage
tagFromRespawnAnchor: true
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
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
If you experience lag, try:
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
To block a region during combat, you need to add its exact name to the blockedRegions list:
Players in combat will now be blocked from entering that region.
For more details, see the Regions page.
EternalCombat uses MiniMessage format for all messages. You can customize colors, gradients, and formatting.
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>'