Solutions to common EternalCombat problems
This documentation page was created by volunteers. Learn how to contribute
Recent editors for this page
Latest edits
Expand to view recent commits.
This page covers common issues and their solutions. If you don't find your answer here, join our Discord server for support.
EternalCombat requires Java 17 or newer. Check your Java version:
Look for this line in your server startup log:
[INFO] Loading Java ...
Or run your server with java -version to check.
EternalCombat requires PacketEvents to be installed. Verify:
Look for error messages in your server console at startup. Common causes:
If you see java.util.zip.ZipException, the JAR file may be corrupted. Re-download from the official source.
1. Check Border Settings
border:
block:
enabled: true # <-- Must be true
particle:
enabled: true # <-- Must be true
distance: 6.5 # <-- Must be > 0
2. Verify PacketEvents
The border uses packets to display fake blocks. Ensure PacketEvents is working.
3. Check Region Setup
Make sure the region is properly configured. See Regions for setup guide.
1. Check Ignored Worlds
settings:
ignoredWorlds:
- creative_world # Remove your world if listed here
2. Check Admin Settings
admin:
excludeAdminsFromCombat: false # Set to false
excludeCreativePlayersFromCombat: false
3. Check Bypass Permission
Players with eternalcombat.bypass permission won't be tagged (only if excludeAdminsFromCombat: true).
4. Check Projectile Settings
combat:
ignoredProjectileTypes:
- ENDER_PEARL
- EGG
# Make sure the weapon type isn't listed here
Check Command Restriction Mode:
If you're using BLACKLIST mode, commands NOT in the list are allowed. If you're using WHITELIST mode, commands NOT in the list are blocked.
Check Command Aliases:
restrictedCommands:
- spawn
- /spawn # Don't include the slash!
- espawn # Remember plugin prefixes like /essentials:spawn
pearl:
# Set to true to block pearls during combat
pearlThrowDisabledDuringCombat: true
# Or enable cooldown
pearlCooldownEnabled: true
pearlThrowDelay: 3s
1. Check Drop Type
drop:
dropType: PERCENT # Use PERCENT or PLAYERS_HEALTH
dropItemPercent: 100 # 100% of items drop
2. Check Server's Keep Inventory
If your server has keepInventory gamerule enabled, EternalCombat cannot override it:
/gamerule keepInventory false
3. Check World Settings
Some worlds may have keep inventory enabled via plugins. Check your world management plugins.
1. Reduce Border Updates
border:
block:
updateDelay: 500ms # Increase from 250ms
chunkCacheDelay: 500ms # Increase from 300ms
distance: 4.0 # Reduce from 6.5
2. Disable One Animation
border:
block:
enabled: true
particle:
enabled: false # Disable particles
3. Reduce Particle Count
border:
particle:
count: 1 # Keep at 1
scale: 1.0 # Reduce from 1.7
Changes to updateDelay and chunkCacheDelay require a server restart.
1. Check Notification Type
messagesSettings:
combatNotification:
actionbar: '<red>Combat ends in: {TIME}' # Check this exists
2. Check MiniMessage Syntax
Invalid MiniMessage format can cause messages to fail silently:
# Wrong
combatNotification: '<red>Text' # Missing closing tag (may work)
# Better
combatNotification: '<red>Text</red>' # Explicit closing
3. Verify Plugin Is Working
Run /combatlog status to verify the plugin is responsive.
crystalPvp:
tagFromCrystals: true # Enable crystal tagging
tagFromRespawnAnchor: true # Enable anchor tagging
If your issue isn't listed here:
When reporting issues, please include: