# CaptureZones \u2014 Dynamic Capture-Based Zones with Visual Effects & Team Support<\/p>\n
**CaptureZones** is a powerful and highly customizable plugin for Paper\/Spigot Minecraft servers (1.16\u20131.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!<\/p>\n
> \u26a0\ufe0f **Requires Paper or Spigot. Not compatible with Forge\/Fabric.**<\/p>\n
—<\/p>\n
## \ud83d\udd25 Key Features<\/p>\n
### \ud83d\uddfa\ufe0f Four Zone Types:
\n– **`circle`** \u2014 ideal for arenas or circular event areas.
\n– **`cube`** \u2014 rectangular bases, pavilions, or outposts.
\n– **`single-chunk`** \u2014 simple 16\u00d7256\u00d716 block zone.
\n– **`multi-chunk`** \u2014 large territories spanning multiple chunks (e.g., a 3-chunk farm).<\/p>\n
### \ud83c\udfaf Capture Mechanics
\n– Two capture modes:
\n – **`ADD`**: Players gradually fill a capture bar over time.
\n – **`multiplier`**: Speeds up capture for your team (requires `use-teams: true`).
\n– Fully configurable capture speed, max value, and victory messages.<\/p>\n
### \ud83d\udc65 Built-in Team System
\n– Define teams in `teams.yml` with permissions, display names, and HEX particle colors.
\n– Zones can be restricted to specific teams.
\n– Particle effects automatically update to the capturing team\u2019s color when `team-colors: true`.<\/p>\n
### \ud83c\udf08 Advanced Visual Effects
\nOver **8 effect types** with rich customization:
\n– Particles: `FLAME`, `VILLAGER_HAPPY`, `REDSTONE`, `DUST`, `BLOCK_CRACK`, and more.
\n– Animations: rotation, pulsing radius, “breathing” density, zigzag lines, color cycling.
\n– Special `perimeter` mode for chunk-based zones.
\n– **`block` mode with `single-entity: true`** spawns a custom invisible ArmorStand with:
\n – Custom block head (`material`)
\n – Custom name & lore (`nbt-name`, `nbt-lore`)
\n – Glow effect (`glow: true`, `glow-color`)
\n – Scale adjustment (`scale`)
\n – Rotation animation (`animate-mode: loop` \/ `custom`)<\/p>\n
### \ud83c\udf81 Rewards & Events
\n– Execute commands on capture (e.g., `give %player% diamond 3`).
\n– Optional random chances: `chance:30;give %player% …`
\n– Reward distribution modes: `all`, `random`, or `leader`.<\/p>\n
### \u23f3 Zone Lifecycle
\n– Zones can auto-spawn, despawn, and respawn on timers.
\n– Run custom commands on spawn, respawn, or despawn.
\n– BossBar placeholders with live data:
\n – `%zone_name%`
\n – `%zonecapture_percent%`
\n – `%zonecapture_despawn_timer%` (in seconds)
\n – `%capturezones_team_name%`<\/p>\n
—<\/p>\n
## \ud83d\udee0\ufe0f Configuration Examples<\/p>\n
### Resource Farm (`multi-chunk`)
\n“`yaml
\nfarm:
\n name: “&aResource Farm”
\n position-type: multi-chunk
\n chunk-list:
\n – “-1,0”
\n – “0,0”
\n – “1,0”
\n capture:
\n mode: ADD
\n max-capture: 100
\n add-interval: 20
\n rewards:
\n – “give %player% wheat 16”
\n“`
\n### Death Arena (`circle`)
\n“`yaml
\narena:
\n name: “&cDeath Arena”
\n position-type: circle
\n position: “200,64,200”
\n horizontal-radius: 25
\n vertical-radius: 20
\n effect:
\n 1:
\n type: hollow
\n particle: FLAME
\n pulse: true
\n pulse-min: 20
\n pulse-max: 30
\n“`
\n### Alpha Pavilion (`cube` + `team`)
\n“`yaml
\nalpha_pavilion:
\n use-teams: true
\n teams: [red]
\n capture:
\n mode: multiplier
\n multiplier: 1.2
\n effect:
\n 1:
\n type: hollow
\n particle: REDSTONE
\n team-colors: true
\n“`<\/p>\n
## \ud83d\udce6 Installation <\/p>\n
1. Download the `.jar` file.
\n2. Place it into your `plugins\/ folder`.
\n3. Start the server \u2014 `config.yml` and `teams.yml` will be generated.
\n4. Configure your zones and teams.
\n5. Reload or restart the server.<\/p>\n
## \ud83d\udca1 Support & Docs <\/p>\n
– Full documentation : GitBook
\n– If you find a flaw\/ bug, write to ds: zero.xuky<\/p>\n
## \ud83d\udccc Compatibility <\/p>\n
Minecraft Versions: 1.16 \u2013 1.21+
\n Platforms: Paper, Spigot
\n Dependencies: None (standalone plugin)<\/p>\n
Create epic battlegrounds, dynamic resource zones, and team-based conquests with CaptureZones!<\/p>\n","protected":false},"excerpt":{"rendered":"
Capturing territories for a reward<\/p>\n","protected":false},"featured_media":36945,"template":"","meta":{"_minecraft_slug":"capture-zones","_minecraft_project_id":"ORqOoa2M","_minecraft_author":"zero.xuky","_minecraft_license":"MIT","_minecraft_downloads":85,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"capture-zones.zip","_minecraft_size_bytes":95313,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:04:01.943686Z","_minecraft_date_created":"2025-11-02T06:26:16.225512Z","_minecraft_date_modified":"2025-11-01T04:10:09.085675Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/capture-zones","_minecraft_icon_attachment_id":36945,"_minecraft_imported_at":"2026-06-01T18:33:34+00:00","_minecraft_import_hash":"063665f9fb3965cf1d8a8829e66d808b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,866,127,92],"mod_loader":[132],"minecraft_version":[36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-36944","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n