# hCaptureEvent<\/p>\n
<\/p>\n
**hCaptureEvent** is a flexible capture-event plugin for Minecraft servers.<\/p>\n
Create timed capture zones inside WorldGuard regions, let players or clans fight for control, track progress in real time, and reward the best participants automatically.<\/p>\n
<\/p>\n
The plugin is designed for servers that need active PvP events, King of the Hill-style gameplay, clan competitions, scheduled hot zones, custom rewards and fully configurable event logic.<\/p>\n
—<\/p>\n
## Overview<\/p>\n
hCaptureEvent allows you to create capture zones using WorldGuard regions.<\/p>\n
When an event starts, players inside the configured region begin gaining capture progress. The plugin tracks participants, leaders, time left, final places and rewards.<\/p>\n
You can run simple player-based capture events or enable clan mode through hClans to create team-based competitions.<\/p>\n
Everything is configured through YAML files, so each capture zone can have its own settings, schedule, rewards, visuals and rules.<\/p>\n
—<\/p>\n
## Main Features<\/p>\n
### WorldGuard-Based Capture Zones<\/p>\n
hCaptureEvent uses WorldGuard regions as capture areas.<\/p>\n
Create a WorldGuard region, connect it to a capture zone config, and the plugin will track players inside that region while the event is active.<\/p>\n
Each capture zone is configured through its own file:<\/p>\n
“`text
\nplugins\/hCaptureEvent\/captures\/default.yml
\nplugins\/hCaptureEvent\/captures\/clan.yml
\n“`<\/p>\n
The zone ID is taken from the file name.<\/p>\n
For example:<\/p>\n
“`text
\ndefault.yml -> default
\nclan.yml -> clan
\n“`<\/p>\n
This makes it easy to create and manage multiple independent capture events.<\/p>\n
—<\/p>\n
### Multiple Capture Zones<\/p>\n
You can create as many capture zones as your server needs.<\/p>\n
Each zone can have its own:<\/p>\n
– WorldGuard region
\n– World
\n– Capture duration
\n– Minimum online player requirement
\n– Automatic schedule
\n– Boss bar
\n– Particle display
\n– Rewards
\n– Start actions
\n– Stop actions
\n– Enter actions
\n– Exit actions
\n– Progress rewards
\n– Final place rewards
\n– Clan mode settings<\/p>\n
This allows you to create different events for PvP arenas, clan wars, survival worlds, seasonal events, daily competitions or rotating hot zones.<\/p>\n
—<\/p>\n
### Player Capture Mode<\/p>\n
In normal mode, players participate individually.<\/p>\n
When a player enters an active capture zone, the plugin starts counting their progress. The longer the player stays inside the region, the more progress they gain.<\/p>\n
The plugin can track:<\/p>\n
– Current leader
\n– Player progress
\n– Capture time
\n– Event time left
\n– Final places
\n– Top participants
\n– Final winner<\/p>\n
This mode is suitable for King of the Hill events, PvP zones, competitive arenas and reward-based activity zones.<\/p>\n
—<\/p>\n
### Clan Capture Mode<\/p>\n
hCaptureEvent supports clan-based capture events through hClans.<\/p>\n
When clan mode is enabled, players participate together with their clan. The plugin calculates clan progress and determines the leading clan during the event.<\/p>\n
Clan mode can be used to:<\/p>\n
– Allow only players with a clan to participate
\n– Track clan progress
\n– Detect the leading clan
\n– Detect the winning clan
\n– Reward the winning clan
\n– Give clan experience
\n– Use the best player from the winning clan in reward actions<\/p>\n
This mode is useful for servers with clans, factions, guilds or team-based PvP systems.<\/p>\n
—<\/p>\n
### Scheduled Events<\/p>\n
Each capture zone can start automatically at configured times.<\/p>\n
Example:<\/p>\n
“`yaml
\ntime:
\n enable: true
\n start:
\n – “00:00”
\n – “00:30”
\n zone: “Europe\/Moscow”
\n format: “HH:mm”
\n“`<\/p>\n
You can configure:<\/p>\n
– Multiple start times
\n– Timezone
\n– Time format
\n– Minimum online requirement
\n– Separate schedule for each zone<\/p>\n
This is useful for servers that want regular automated events without manual staff involvement.<\/p>\n
—<\/p>\n
### Manual Event Control<\/p>\n
Administrators can start and stop events manually.<\/p>\n
You can start all zones at once or only a specific zone.<\/p>\n
Examples:<\/p>\n
“`text
\n\/hcaptureevent start
\n\/hcaptureevent start all
\n\/hcaptureevent start default<\/p>\n
\/hcaptureevent stop
\n\/hcaptureevent stop all
\n\/hcaptureevent stop default
\n“`<\/p>\n
This gives staff full control over active capture events.<\/p>\n
—<\/p>\n
### Minimum Online Requirement<\/p>\n
Each zone can require a minimum number of online players before it starts.<\/p>\n
If the server does not have enough players online, the event will not begin, and you can configure custom actions for this case.<\/p>\n
This helps prevent capture events from starting when there is not enough competition.<\/p>\n
—<\/p>\n
### Boss Bar Support<\/p>\n
Each active capture zone can display a boss bar with live event information.<\/p>\n
The boss bar can show:<\/p>\n
“`text
\n{leader}
\n{progress}
\n{timeLeft}
\n{clan}
\n{clanProgress}
\n“`<\/p>\n
You can configure:<\/p>\n
– Boss bar title
\n– Boss bar color
\n– Boss bar style
\n– Boss bar flags
\n– Worlds where the boss bar is visible<\/p>\n
The boss bar helps players understand the current event state without using commands.<\/p>\n
—<\/p>\n
### Particle Zone Display<\/p>\n
Capture zones can be visually highlighted with REDSTONE particles.<\/p>\n
You can configure:<\/p>\n
– Whether particles are enabled
\n– Particle color
\n– Particle size
\n– Display density<\/p>\n
This makes the capture area easier to see and understand in-game.<\/p>\n
—<\/p>\n
### Flexible Action System<\/p>\n
hCaptureEvent includes a powerful action system that lets you customize almost every important part of an event.<\/p>\n
Actions can be executed when:<\/p>\n
– An event starts
\n– An event stops
\n– A player enters the zone
\n– A player leaves the zone
\n– A player gains progress
\n– The leader changes
\n– There are not enough players online
\n– A player does not have permission
\n– A player has no clan in clan mode
\n– A player reaches a configured progress milestone
\n– Final places are calculated<\/p>\n
Supported action sections:<\/p>\n
“`text
\nactions.start
\nactions.stop
\nactions.enter
\nactions.exit
\nactions.progress
\nactions.leaderChange
\nactions.minPlayers
\nactions.noPermission
\nactions.clanNoClan
\nactions.seconds
\nactions.places
\n“`<\/p>\n
—<\/p>\n
## Supported Action Types<\/p>\n
The plugin supports different action types for messages, commands, sounds, titles, particles and rewards.<\/p>\n
Available action types include:<\/p>\n
“`text
\n[Message]
\n[Broadcast]
\n[Console]
\n[Player]
\n[Sound]
\n[Title]
\n[ActionBar]
\n[BossBar]
\n[Particle]
\n[Firework]
\n[Vault]
\n“`<\/p>\n
Example:<\/p>\n
“`yaml
\nactions:
\n start:
\n – “[Broadcast] &6The capture event has started!”
\n – “[Sound] ENTITY_ENDER_DRAGON_GROWL”<\/p>\n
enter:
\n – “[Message] &aYou entered the capture zone.”<\/p>\n
exit:
\n – “[Message] &cYou left the capture zone.”<\/p>\n
seconds:
\n 15:
\n – “[Console] eco give {player} 2500”
\n – “[Sound] ENTITY_PLAYER_LEVELUP:0.2:1.0”<\/p>\n
places:
\n 1:
\n – “[Console] eco give {player} 15000”
\n – “[Broadcast] &e{player} won the capture event!”
\n“`<\/p>\n
—<\/p>\n
## Progress Rewards<\/p>\n
You can reward players when they reach specific capture progress milestones.<\/p>\n
For example, you can give rewards after 15, 30 or 60 seconds of holding the zone.<\/p>\n
Example:<\/p>\n
“`yaml
\nactions:
\n seconds:
\n 15:
\n – “[Console] eco give {player} 1000”
\n 30:
\n – “[Console] give {player} diamond 3”
\n 60:
\n – “[Console] eco give {player} 5000”
\n“`<\/p>\n
This allows players to receive rewards not only for winning, but also for active participation.<\/p>\n
—<\/p>\n
## Final Place Rewards<\/p>\n
At the end of the event, you can reward players based on their final place.<\/p>\n
Example:<\/p>\n
“`yaml
\nactions:
\n places:
\n 1:
\n – “[Console] eco give {player} 15000”
\n 2:
\n – “[Console] eco give {player} 10000”
\n 3:
\n – “[Console] eco give {player} 5000”
\n“`<\/p>\n
This makes events more competitive and motivates players to fight for higher positions.<\/p>\n
—<\/p>\n
## Fair Participation Rules<\/p>\n
hCaptureEvent can prevent unfair participation during capture events.<\/p>\n
Players without the bypass permission can be restricted from participating while using unfair advantages.<\/p>\n
The plugin can check and block:<\/p>\n
– Creative mode
\n– Spectator mode
\n– Flight
\n– Essentials god mode
\n– Essentials vanish<\/p>\n
Bypass permission:<\/p>\n
“`text
\nhcaptureevent.bypass
\n“`<\/p>\n
This helps keep capture events fair for regular players.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Description | Default | Important: give `hcaptureevent.capture` to players or groups that should be allowed to participate in capture events.<\/p>\n —<\/p>\n ## PlaceholderAPI Support<\/p>\n If PlaceholderAPI is installed, hCaptureEvent registers its own placeholders.<\/p>\n The placeholder format depends on the zone ID.<\/p>\n The zone ID is the name of the capture file without `.yml`.<\/p>\n Example:<\/p>\n “`text Placeholders for the `default` zone:<\/p>\n “`text These placeholders can be used in scoreboards, TAB plugins, menus, holograms and other plugins that support PlaceholderAPI.<\/p>\n —<\/p>\n ## PlaceholderAPI List<\/p>\n | Placeholder | Description | Example:<\/p>\n “`text —<\/p>\n ## Internal Placeholders<\/p>\n These placeholders can be used inside plugin messages and actions.<\/p>\n | Placeholder | Description | Example:<\/p>\n “`yaml —<\/p>\n ## Requirements<\/p>\n ### Required<\/p>\n | Requirement | Status | ### Optional Integrations<\/p>\n | Plugin | Usage | Paper or Purpur is recommended for the best experience.<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Install WorldEdit and WorldGuard. “`text 6. Configure capture zones in:<\/p>\n “`text 7. Give players the required permission:<\/p>\n “`text 8. Start a zone manually:<\/p>\n “`text Or configure automatic start times in the zone file.<\/p>\n —<\/p>\n ## Example Zone Files<\/p>\n The plugin includes example capture zone configurations:<\/p>\n “`text `default.yml` is an example of a normal player-based capture zone.<\/p>\n `clan.yml` is an example of a clan-based capture zone using hClans.<\/p>\n You can use these files as templates for your own events.<\/p>\n —<\/p>\n ## Basic Setup Example<\/p>\n Create a WorldGuard region:<\/p>\n “`text Create or edit a capture config file:<\/p>\n “`text Set the region and world in the zone configuration, then start the event:<\/p>\n “`text Players with the required permission will be able to participate in the capture event.<\/p>\n —<\/p>\n ## What You Can Use It For<\/p>\n hCaptureEvent can be used for many different server event types:<\/p>\n – King of the Hill events The plugin does not force one specific gameplay style. You can configure each zone to match your server’s rules and economy.<\/p>\n —<\/p>\n ## Why Choose hCaptureEvent?<\/p>\n hCaptureEvent gives your server a complete capture-event system with flexible configuration and useful integrations.<\/p>\n You can create simple capture zones, competitive PvP events, clan wars or scheduled reward events without changing the plugin code.<\/p>\n The plugin includes:<\/p>\n – WorldGuard region support Everything is configurable through YAML files.<\/p>\n —<\/p>\n ## Notes<\/p>\n Make sure that your WorldGuard regions are created correctly and that players have the required permission:<\/p>\n “`text For clan events, install and configure hClans before enabling clan mode.<\/p>\n For PlaceholderAPI placeholders, make sure PlaceholderAPI is installed on the server.<\/p>\n","protected":false},"excerpt":{"rendered":" WorldGuard-based capture events with scheduled zones, player and clan modes, rewards, boss bars, particles and PlaceholderAPI support.<\/p>\n","protected":false},"featured_media":79841,"template":"","meta":{"_minecraft_slug":"hcaptureevent","_minecraft_project_id":"oO7jVWwf","_minecraft_author":"He3HaukaX","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":7,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hcaptureevent.zip","_minecraft_size_bytes":66267,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:20:16.333468Z","_minecraft_date_created":"2026-05-12T21:19:16.483799Z","_minecraft_date_modified":"2026-05-09T15:28:45.894339Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hcaptureevent","_minecraft_icon_attachment_id":79841,"_minecraft_imported_at":"2026-06-04T14:26:58+00:00","_minecraft_import_hash":"5e6e842646d5f767613325a1336759c4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,844,88,89,127,128,867,129],"mod_loader":[130,132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-79840","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-economy","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","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-11","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `\/hcaptureevent` | Shows the help menu |
\n| `\/hcaptureevent reload` | Reloads the main config and all capture zones |
\n| `\/hcaptureevent start` | Starts all loaded zones |
\n| `\/hcaptureevent start all` | Starts all loaded zones |
\n| `\/hcaptureevent start
\n| `\/hcaptureevent stop` | Stops all active zones |
\n| `\/hcaptureevent stop all` | Stops all active zones |
\n| `\/hcaptureevent stop
\n|—|—|—|
\n| `hcaptureevent.admin` | Allows access to administrative commands | OP |
\n| `hcaptureevent.capture` | Allows players to participate in capture zones | OP |
\n| `hcaptureevent.bypass` | Bypasses fair participation restrictions | OP |<\/p>\n
\ndefault.yml -> default
\n“`<\/p>\n
\n%hcaptureevent_default_winnerPlayerName%
\n%hcaptureevent_default_timeForNext%
\n%hcaptureevent_default_captureTime%
\n%hcaptureevent_default_place_1%
\n%hcaptureevent_default_place_2%
\n%hcaptureevent_default_place_3%
\n“`<\/p>\n
\n|—|—|
\n| `%hcaptureevent_
\n| `%hcaptureevent_
\n| `%hcaptureevent_
\n| `%hcaptureevent_
\n| `%hcaptureevent_
\n| `%hcaptureevent_
\n%hcaptureevent_default_winnerPlayerName%
\n%hcaptureevent_default_timeForNext%
\n%hcaptureevent_default_captureTime%
\n“`<\/p>\n
\n|—|—|
\n| `{prefix}` | Plugin prefix |
\n| `{player}` | Player name |
\n| `{progress}` | Player progress |
\n| `{timeLeft}` | Remaining event time |
\n| `{leader}` | Current leader |
\n| `{clan}` | Player clan name |
\n| `{clanProgress}` | Clan progress |
\n| `{clanExp}` | Configured clan experience reward |
\n| `{place}` | Final player place |<\/p>\n
\nactions:
\n leaderChange:
\n – “[Broadcast] &e{player} is now leading the capture event!”
\n stop:
\n – “[Broadcast] &6The event has ended. Winner: &e{leader}”
\n“`<\/p>\n
\n|—|—|
\n| Java 17 or newer | Required |
\n| WorldGuard | Required |
\n| WorldEdit | Required |<\/p>\n
\n|—|—|
\n| PlaceholderAPI | Enables external placeholders |
\n| hClans | Enables clan capture mode |
\n| EssentialsX | Used for vanish and god mode checks |
\n| Vault | Used for Vault economy actions |<\/p>\n
\n2. Place `hCaptureEvent.jar` into your server’s `plugins` folder.
\n3. Restart the server.
\n4. Create or edit WorldGuard regions for your capture zones.
\n5. Open the plugin folder:<\/p>\n
\nplugins\/hCaptureEvent\/
\n“`<\/p>\n
\nplugins\/hCaptureEvent\/captures\/
\n“`<\/p>\n
\nhcaptureevent.capture
\n“`<\/p>\n
\n\/hcaptureevent start
\n“`<\/p>\n
\ndefault.yml
\nclan.yml
\n“`<\/p>\n
\n\/rg define capture_zone
\n“`<\/p>\n
\nplugins\/hCaptureEvent\/captures\/default.yml
\n“`<\/p>\n
\n\/hcaptureevent start default
\n“`<\/p>\n
\n– PvP hot zones
\n– Clan capture events
\n– Daily reward events
\n– Scheduled server activities
\n– Seasonal competitions
\n– Survival world activity zones
\n– Arena-based PvP events
\n– Faction-style territory battles
\n– Reward-based player engagement events<\/p>\n
\n– Multiple independent zones
\n– Player-based capture mode
\n– Clan-based capture mode
\n– Automatic scheduling
\n– Boss bar support
\n– Particle zone display
\n– Flexible action system
\n– Progress rewards
\n– Final place rewards
\n– PlaceholderAPI support
\n– Optional hClans support
\n– Optional Vault support
\n– Fair participation checks<\/p>\n
\nhcaptureevent.capture
\n“`<\/p>\n