CaptureZones

CaptureZones adds configurable capture-zone gameplay to Minecraft servers:

• Circle and cuboid zones
• Per-zone rules and rewards
• Optional KOTH mode
• Reinforcements, shops, statistics, holograms, map integrations
• Towny-aware or standalone ownership modes

This README is intentionally short. Full documentation lives in the wiki.

Premium Sponsor addons

If you like CaptureZones and want it to get better, please consider becoming a sponsor on GitHub or Patreon! All sponsors recieve access to all premium addons. List of premium addons:

• CZPanels - companion plugin for CaptureZones that self-hosts a built-in web admin panel with full control over the plugin and statistics. Becoming a sponsor: - Patreon - Github

Quick Start

1. Put the plugin jar in plugins/.
2. Start server once.
3. Edit plugins/CaptureZones/config.yml.
4. Use /cap help in game.

Full Documentation

Wiki:

• Wiki Home
• Installation
• Command Reference
• Permission Reference
• Global Config Reference
• Per-Zone Config Reference
• Setup Guides
• KOTH Mechanics
• Shops
• Discord
• PlaceholderAPI
• Repair and Migration
• Troubleshooting

GitHub wiki:

• https://github.com/logichh/capturezones/wiki

Requirements

• Java 17+
• Paper/Spigot 1.20+

Optional integrations:

• Towny
• Vault + economy plugin
• Dynmap
• BlueMap
• PlaceholderAPI
• MythicMobs
• WorldGuard

Addon API

CaptureZones now registers a Bukkit service for addon plugins:

• Service interface: com.logichh.capturezones.api.CaptureZonesApi
• Result type: com.logichh.capturezones.api.CaptureZonesActionResult
• API version constant: CaptureZonesApi.API_VERSION

Resolve the service from another plugin

RegisteredServiceProvider<CaptureZonesApi> rsp =
    Bukkit.getServicesManager().getRegistration(CaptureZonesApi.class);
CaptureZonesApi api = rsp == null ? null : rsp.getProvider();

Your addon should declare a dependency on CaptureZones in its own plugin.yml:

depend: [CaptureZones]

What the API exposes

• Full snapshots: overview, zones, active captures, KOTH, shops, statistics, configs, data files.
• Mutations/actions: zone lifecycle, capture controls, KOTH controls, shop controls, stats controls, config writes/reloads.
• Capability discovery via getCapabilities() so addons can feature-gate safely.

Build From Source

mvn clean package

Support

• Wiki: https://github.com/logichh/capturezones/wiki
• Discord: https://discord.gg/t96nrf7Nav
• Patreon: https://www.patreon.com/cw/logich
• GitHub Sponsors: https://github.com/sponsors/logichh