Troubleshooting

Troubleshooting

This page covers common issues and their solutions. If you don't find your answer here, join our Discord server for support.

Plugin not loading

Symptoms

• EternalCombat doesn't appear in /plugins
• No EternalCombat messages in console
• Config file is not generated
• Players are not tagged during combat

Solutions

[INFO] Loading Java ...

Border not working

Symptoms

• No visual border appears at protected regions
• Players can walk into safe zones during combat

Solutions

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.

Players not getting tagged

Symptoms

• Players can attack each other without entering combat
• Combat timer never appears

Solutions

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

Commands can be used during combat

Symptoms

• Players can use /spawn, /home, etc. during combat
• Command blocking doesn't work

Solutions

Check Command Restriction Mode:

commands:
  commandRestrictionMode: BLACKLIST
  restrictedCommands:
    - spawn     # These are BLOCKED
    - home
    - tpa

Check Command Aliases:

restrictedCommands:
  - spawn
  - /spawn      # Don't include the slash!
  - espawn      # Remember plugin prefixes like /essentials:spawn

Ender pearls not blocked

Symptoms

• Players can throw ender pearls during combat
• Pearl cooldown doesn't work

Solution

pearl:
  # Set to true to block pearls during combat
  pearlThrowDisabledDuringCombat: true

  # Or enable cooldown
  pearlCooldownEnabled: true
  pearlThrowDelay: 3s

No items dropping on death

Symptoms

• Players don't drop items when killed during combat log
• Combat loggers escape without penalty

Solutions

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.

Performance issues

Symptoms

• Server TPS drops when players are in combat
• High CPU usage from EternalCombat

Solutions

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

Messages not showing

Symptoms

• Combat notifications don't appear
• ActionBar or BossBar not visible

Solutions

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.

Crystal PvP not tagging

Symptoms

• End crystal explosions don't trigger combat
• Respawn anchor deaths don't tag players

Solution

crystalPvp:
  tagFromCrystals: true       # Enable crystal tagging
  tagFromRespawnAnchor: true  # Enable anchor tagging

Still need help?

If your issue isn't listed here:

1. Check console logs for any error messages
2. Join our Discord - discord.gg/FQ7jmGBd6c
3. Report on GitHub - GitHub Issues

When reporting issues, please include:

• Server version (Paper/Spigot + Minecraft version)
• EternalCombat version
• PacketEvents version
• Full error message (if any)
• Your config.yml (remove sensitive data)