https://github.com/logichh/capturezones
CaptureZones adds configurable PvP capture zones to Minecraft, with rewards, reinforcements, optional KOTH events, and map/shop/stat integrations.
https://github.com/logichh/capturezones
fun minecraft minecraft-plugin modrinth pvp spigot towny
Last synced: 14 days ago
JSON representation
CaptureZones adds configurable PvP capture zones to Minecraft, with rewards, reinforcements, optional KOTH events, and map/shop/stat integrations.
- Host: GitHub
- URL: https://github.com/logichh/capturezones
- Owner: logichh
- Created: 2025-11-10T22:48:24.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T03:15:38.000Z (4 months ago)
- Last Synced: 2026-02-27T09:32:13.619Z (4 months ago)
- Topics: fun, minecraft, minecraft-plugin, modrinth, pvp, spigot, towny
- Language: Java
- Homepage:
- Size: 365 KB
- Stars: 4
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# 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.
## 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](https://github.com/logichh/townycapturezones/wiki)
- [Installation](https://github.com/logichh/townycapturezones/wiki#installation)
- [Command Reference](https://github.com/logichh/townycapturezones/wiki#command-reference)
- [Permission Reference](https://github.com/logichh/townycapturezones/wiki#command-reference)
- [Global Config Reference](https://github.com/logichh/townycapturezones/wiki#global-configuration-reference-configyml)
- [Per-Zone Config Reference](https://github.com/logichh/townycapturezones/wiki#global-configuration-reference-configyml)
- [Setup Guides](https://github.com/logichh/townycapturezones/wiki#global-configuration-reference-configyml)
- [KOTH Mechanics](https://github.com/logichh/townycapturezones/wiki#global-configuration-reference-configyml)
- [Shops](https://github.com/logichh/townycapturezones/wiki#global-configuration-reference-configyml)
- [Discord](https://github.com/logichh/townycapturezones/wiki#discord-webhooks)
- [PlaceholderAPI](https://github.com/logichh/townycapturezones/wiki#discord-webhooks)
- [Repair and Migration](https://github.com/logichh/townycapturezones/wiki#discord-webhooks)
- [Troubleshooting](https://github.com/logichh/townycapturezones/wiki#discord-webhooks)
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 (For External Web Panel Plugins)
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
```java
RegisteredServiceProvider 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`:
```yaml
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
```bash
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
