⭐ hStanZoneItem ⭐ [1.16.X-26.X] | PAPI, Vault, WG, WE and more support! icon

⭐ hStanZoneItem ⭐ [1.16.X-26.X] | PAPI, Vault, WG, WE and more support! -----

Configurable stun-zone items that create temporary cube, dome or sphere zones blocking flight, etc



hStanZoneItem_card_1920x1080.png

hStanZoneItem
Custom Stun-Zone Items for PvP Servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hStanZoneItem is a configurable item-based zone control plugin for Minecraft servers.
Create custom items that spawn temporary stun zones around the activation point. While a zone is active, players inside it can be forced out of flight, Elytra gliding and Elytra-based movement, while firework rocket boosts can also be blocked.
The plugin is designed for PvP servers, clan projects, survival events, arenas, custom abilities and any server that needs temporary anti-flight areas controlled through usable items.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Main Features
Custom Zone Items
Every stun zone is created through a configurable item.
You can create multiple items with different materials, names, lore, permissions, cooldowns, durations, shapes and visual effects.
Each item can be configured separately:
Code (Text):
items:
  default:
    material: NETHER_STAR
    name: "&cStun Zone"
    customModelData: 0
    consumeOnUse: true
    permission: "hstanzoneitem.use"
    cooldownSeconds: 0
This allows you to create simple stun items, premium items, event items, clan war abilities or special PvP consumables.
────────────────────────────────────────
Temporary Anti-Flight Zones
When a player uses a configured item, the plugin creates a temporary zone at the player's location.
Inside the active zone, the plugin can block:
  • Flying
  • Elytra gliding
  • Elytra-based swimming launch
  • Firework rocket boosting
  • Unfair air movement inside PvP areas
This makes the plugin useful for servers where Elytra, fly permissions or rocket movement can ruin PvP fights or arena balance.
────────────────────────────────────────
Automatic Flight State Restore
The plugin saves the player's previous flight state and restores it after the player leaves the active zone.
This means the zone can temporarily disable flight without permanently breaking the player's previous allow-flight state.
The plugin also restores captured flight states when players leave the server or when the plugin is disabled.
────────────────────────────────────────
Downward Velocity Control
Zones can optionally force players downward when flight, gliding or Elytra movement is blocked.
Example:
Code (Text):
zone:
  forceDownwardVelocity: true
  downwardVelocity: -0.45
This helps stop players from staying in the air after the zone affects them.
────────────────────────────────────────
Multiple Zone Shapes
hStanZoneItem supports several zone shapes:
Code (Text):
CUBE
DOME
SPHERE
Each item can use its own shape.
Example:
Code (Text):
zone:
  shape: DOME
  size: "5x5x0x5x5x5"
  durationSeconds: 12
This gives you control over how the zone behaves visually and mechanically.
────────────────────────────────────────
Flexible Size Formats
Zone sizes can be configured in several formats.
Supported formats:
Code (Text):
"10"              -> one size for width, height and depth
"10x6"            -> width x depth, height is calculated automatically
"10x6x10"         -> width x height x depth
"5x5x10x10"       -> -X x +X x height x depth
"5x5x0x10x10"     -> -X x +X x -Y x +Y x depth
"5x5x0x5x5x5"     -> -X x +X x -Y x +Y x -Z x +Z
This makes it possible to create centered zones, asymmetric zones, high domes, flat zones or custom-shaped PvP control areas.
────────────────────────────────────────
Particle Zone Display
Active zones can be displayed with REDSTONE particles.
You can configure:
  • Whether particles are enabled
  • Particle interval
  • Particle color
  • Particle size
Example:
Code (Text):
effects:
  particle:
    enable: true
    intervalTicks: 20
    color: "#b45cff"
    size: 1.4
This helps players understand where the active stun zone is located.
────────────────────────────────────────
Activation Sound
Every item can play a sound when the zone is activated.
Example:
Code (Text):
effects:
  activation:
    sound:
      enable: true
      name: BLOCK_BEACON_ACTIVATE
      volume: 1.0
      pitch: 1.4
This gives instant feedback when a player places a zone.
────────────────────────────────────────
Cooldowns and Item Consumption
Each item can have its own cooldown.
Example:
Code (Text):
cooldownSeconds: 15
Items can also be consumed after use:
Code (Text):
consumeOnUse: true
This allows you to create one-time consumable items or reusable ability items.
────────────────────────────────────────
WorldGuard Region Protection
hStanZoneItem depends on WorldGuard and WorldEdit.
You can configure WorldGuard regions where a specific item cannot be used.
Example:
Code (Text):
regions:
  - world: world
    region: spawn
  - world: world
    region: safezone
If the player tries to activate the item inside a blocked region, the plugin cancels the activation and runs the configured region-blocked actions.
This is useful for spawn, safe zones, protected arenas or areas where stun zones should not be placed.
────────────────────────────────────────
Overlap Protection
The plugin checks active zones and prevents new zones from being created if they intersect with another active zone.
This helps avoid stacked zones, visual spam and unfair overlapping anti-flight areas.
────────────────────────────────────────
Bypass Permission
Administrators or selected groups can bypass zone restrictions.
Bypass permission:
Code (Text):
hstanzoneitem.bypass
Players with this permission are ignored by active stun zones.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Action System
hStanZoneItem includes a flexible action system for messages, sounds, commands, effects and feedback.
Available action sections:
Code (Text):
actions.noPermission
actions.cooldown
actions.activated
actions.zoneIntersects
actions.flightBlocked
actions.fireworkBlocked
actions.regionBlocked
You can use actions to notify players, broadcast events, play sounds, run commands and display visual feedback.
────────────────────────────────────────
Supported Action Types
Supported action types include:
Code (Text):
[MESSAGE]
[BROADCAST]
[CONSOLE]
[PLAYER]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[FIREWORK]
[EFFECT]
[VAULT]
Example:
Code (Text):
actions:
  activated:
    - "[MESSAGE] {prefix}Activated {item} ({shape}, {size}) for {time} seconds"
    - "[SOUND] sound:BLOCK_BEACON_ACTIVATE && volume:1.0 && pitch:1.2"
  flightBlocked:
    - "[MESSAGE] {prefix}Flight is blocked inside {item}"
  cooldown:
    - "[MESSAGE] {prefix}Wait {time} seconds before using {item}"
────────────────────────────────────────
Action Placeholders
These placeholders can be used inside plugin actions and messages:
Code (Text):
{prefix}  - plugin prefix
{player}  - player name
{item}    - item display name
{id}      - item ID
{shape}   - zone shape
{size}    - zone size
{time}    - cooldown or duration time
{amount}  - amount value
{count}   - count value
PlaceholderAPI values can also be used inside action text if PlaceholderAPI is installed on the server.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
Code (Text):
/hstanzone
/hstanzone give <player> <item> [amount]
/hstanzone reload
Command Description:
Code (Text):
/hstanzone                              - shows command usage
/hstanzone give <player> <item> [amount] - gives a configured zone item
/hstanzone reload                       - reloads the configuration and items
The command includes tab completion for available subcommands, online players and configured item IDs.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
Code (Text):
hstanzoneitem.use     - allows using configured stun-zone items
hstanzoneitem.give    - allows using /hstanzone give
hstanzoneitem.reload  - allows reloading the configuration
hstanzoneitem.bypass  - bypasses active stun-zone restrictions
Default permission values:
Code (Text):
hstanzoneitem.use     - true
hstanzoneitem.give    - OP
hstanzoneitem.reload  - OP
hstanzoneitem.bypass  - OP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requirements
Required:
  • Java 17 or newer
  • Spigot, Paper or Purpur 1.16+
  • WorldEdit
  • WorldGuard
Optional:
  • PlaceholderAPI for placeholders in action text
  • Vault for Vault actions
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation
  1. Install WorldEdit and WorldGuard.
  2. Place hStanZoneItem.jar into your server's plugins folder.
  3. Restart the server.
  4. Open the generated configuration file.
  5. Configure your stun-zone items in the items section.
  6. Give players the required permission.
  7. Give an item with /hstanzone give <player> <item> [amount].
Main configuration file:
Code (Text):
plugins/hStanZoneItem/config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Example Item Configuration
Code (Text):
items:
  dome:
    material: END_CRYSTAL
    name: "&dStun Dome"
    lore:
      - "&7Right-click to create a dome."
      - "&7Size: &f5x5x0x5x5x5"
      - "&7Flight and Elytra are disabled inside."
    customModelData: 0
    consumeOnUse: true
    permission: "hstanzoneitem.use"
    cooldownSeconds: 15
    regions:
      - world: world
        region: spawn
    zone:
      shape: DOME
      size: "5x5x0x5x5x5"
      durationSeconds: 12
      forceDownwardVelocity: true
      downwardVelocity: -0.45
    effects:
      particle:
        enable: true
        intervalTicks: 20
        color: "#b45cff"
        size: 1.4
      activation:
        sound:
          enable: true
          name: BLOCK_BEACON_ACTIVATE
          volume: 1.0
          pitch: 1.4
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What You Can Use It For
  • Anti-Elytra PvP items
  • Temporary no-fly zones
  • Clan war abilities
  • Arena control items
  • Survival event consumables
  • Custom PvP traps
  • King of the Hill support items
  • Safe-zone protection mechanics
  • Donor or rank-based ability items
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Why hStanZoneItem?
hStanZoneItem gives server owners a simple way to create powerful temporary anti-flight areas without building a full arena system.
You configure the items, shapes, sizes, permissions, cooldowns, region restrictions, particles and actions directly in YAML.
The result is a flexible PvP utility plugin that can be adapted to many different gameplay styles.
Resource Information
Author:
----------
Total Downloads: 1
First Release: May 16, 2026
Last Update: May 16, 2026
Category: ---------------
All-Time Rating:
0 ratings
Find more info at t.me...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings