Regions & WorldGuard

Regions & WorldGuard#

EternalCombat protects players from escaping fights, by preventing them from entering safe zones.

How it works#

When a player is in combat and tries to enter a protected region:

1. Visual Border - An animated border appears showing the region boundary
2. Knockback - The player is pushed back from the region
3. Message - A warning message is displayed

This prevents players from escaping fights by running to spawn or other safe zones.

Setting up protected regions#

//wand
# Select two corners of your region
/rg define spawn

regions:
  blockedRegions:
    - spawn
    - safezone
    - pvp-arena-lobby

/combatlog tag YourName
# Now try to walk into the protected region

Configuration options#

regions:
  # List of blocked region names - ADD YOUR REGIONS HERE
  blockedRegions:
    - spawn
    - safezone
  
  # Block regions where WorldGuard has PvP disabled
  preventPvpInRegions: true
  
  # Spawn region radius if WorldGuard is not installed
  restrictedRegionRadius: 10

WorldGuard integration#

Automatic PvP region detection#

When preventPvpInRegions is enabled, EternalCombat will automatically block entry to:

• Regions with the pvp flag set to deny

This means you don't need to manually add every safe region to blockedRegions.

Priority order#

If a region is in both WorldGuard (with PvP disabled) AND blockedRegions:

1. blockedRegions takes priority
2. WorldGuard check is secondary

Without WorldGuard#

If you don't have WorldGuard installed, EternalCombat will create a circular spawn protection zone:

regions:
  # Radius of the protected spawn area
  restrictedRegionRadius: 10

This creates a 10-block radius protection zone around the world spawn point.

Border appearance#

The visual border that appears at protected regions can be customized:

border:
  # How far players can see the border
  distance: 6.5
  
  block:
    enabled: true
    type: RAINBOW_GLASS
  
  particle:
    enabled: true
    type: DUST
    color: RAINBOW

See Configuration for all border options.

Knockback settings#

Configure how strongly players are pushed away from protected regions:

knockback:
  # Knockback strength (1.0 = 2-4 blocks)
  multiplier: 1
  
  # Delay before forcing the player out
  forceDelay: 1s

Common issues#

Border not showing#

1. Check that border.block.enabled or border.particle.enabled is true
2. Verify PacketEvents is installed and working
3. Check border.distance is not set too low

Players can still enter region#

1. Verify the region name is spelled correctly (exact match)
2. Check that the player doesn't have eternalcombat.bypass permission
3. Ensure the world isn't in ignoredWorlds

Region not detected#

1. Make sure WorldGuard is installed and the region exists
2. Try running /rg info <region> to verify the region
3. Check for typos in the region name

Next steps#