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:

- `multi-chunk` — ideal for arenas or circular event areas. - `multi-chunk` — rectangular bases, pavilions, or outposts. - `multi-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: - `multiplier`: 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 `block` mode with `single-entity: true` 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`)

```yaml 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`)

```yaml 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`)

```yaml 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!