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`) ```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: 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 : (https://cutteshi.gitbook.io/catchzones-docs/)
• 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!