Capture Zones

CaptureZones — Dynamic Capture-Based Zones with Visual Effects & Team Support

CaptureZones is a powerful and highly customizable plugin for Paper/Spigot Minecraft servers (1.16–1.21+) that enables server owners to create interactive, time-limited zones with capture mechanics, team-based control, visual particle effects, and automatic rewards. Perfect for PvP arenas, PvE farms, territory wars, and custom minigames!

⚠️ Requires Paper or Spigot. Not compatible with Forge/Fabric.

🔥 Key Features

🗺️ Four Zone Types:

• circle — ideal for arenas or circular event areas.
• cube — rectangular bases, pavilions, or outposts.
• single-chunk — simple 16×256×16 block zone.
• multi-chunk — large territories spanning multiple chunks (e.g., a 3-chunk farm).

🎯 Capture Mechanics

• Two capture modes:
  • ADD: Players gradually fill a capture bar over time.
  • multiplier: Speeds up capture for your team (requires use-teams: true).
• Fully configurable capture speed, max value, and victory messages.

👥 Built-in Team System

• Define teams in teams.yml with permissions, display names, and HEX particle colors.
• Zones can be restricted to specific teams.
• Particle effects automatically update to the capturing team's color when team-colors: true.

🌈 Advanced Visual Effects

Over 8 effect types with rich customization:

• Particles: FLAME, VILLAGER_HAPPY, REDSTONE, DUST, BLOCK_CRACK, and more.
• Animations: rotation, pulsing radius, "breathing" density, zigzag lines, color cycling.
• Special perimeter mode for chunk-based zones.
• block mode with single-entity: true spawns a custom invisible ArmorStand with:
  • Custom block head (material)
  • Custom name & lore (nbt-name, nbt-lore)
  • Glow effect (glow: true, glow-color)
  • Scale adjustment (scale)
  • Rotation animation (animate-mode: loop / custom)

🎁 Rewards & Events

• Execute commands on capture (e.g., give %player% diamond 3).
• Optional random chances: chance:30;give %player% ...
• Reward distribution modes: all, random, or leader.

⏳ Zone Lifecycle

• Zones can auto-spawn, despawn, and respawn on timers.
• Run custom commands on spawn, respawn, or despawn.
• BossBar placeholders with live data:
  • %zone_name%
  • %zonecapture_percent%
  • %zonecapture_despawn_timer% (in seconds)
  • %capturezones_team_name%

🛠️ Configuration Examples

Resource Farm (multi-chunk)

farm:
  name: "&aResource Farm"
  position-type: multi-chunk
  chunk-list:
    - "-1,0"
    - "0,0"
    - "1,0"
  capture:
    mode: ADD
    max-capture: 100
    add-interval: 20
  rewards:
    - "give %player% wheat 16"

Death Arena (circle)

arena:
  name: "&cDeath Arena"
  position-type: circle
  position: "200,64,200"
  horizontal-radius: 25
  vertical-radius: 20
  effect:
    1:
      type: hollow
      particle: FLAME
      pulse: true
      pulse-min: 20
      pulse-max: 30

Alpha Pavilion (cube + team)

alpha_pavilion:
  use-teams: true
  teams: [red]
  capture:
    mode: multiplier
    multiplier: 1.2
  effect:
    1:
      type: hollow
      particle: REDSTONE
      team-colors: true

📦 Installation

1. Download the .jar file.
2. Place it into your plugins/ folder.
3. Start the server — config.yml and teams.yml will be generated.
4. Configure your zones and teams.
5. Reload or restart the server.

💡 Support & Docs

• Full documentation : GitBook
• If you find a flaw/ bug, write to ds: zero.xuky

📌 Compatibility

Minecraft Versions: 1.16 – 1.21+
Platforms: Paper, Spigot
Dependencies: None (standalone plugin)

Create epic battlegrounds, dynamic resource zones, and team-based conquests with CaptureZones!