Imagine this:
a point of interest appears somewhere in the world.
First — an announcement and visual effect.
Then — a fight against a powerful boss that cannot simply be ignored or spammed down mindlessly.
After that — a breaking stage, where access to the loot must be earned through personal hits or shared progress.
And only then — the loot opening stage, where the rewards may even be hidden behind fake mask items.

This is not just “a chest with loot”, but a complete event system for your server.

Main Features

• Flexible multi-phase airdrop system
• Support for different event сценарios
• Separate schedule for each airdrop
• Boss system with custom settings
• Breaking stage with hit-based progression
• Hidden loot system with mask items
• Per-phase BossBar and Hologram support
• Separate visual effects for each airdrop
• Summoner item support
• Schematic paste on spawn
• WorldGuard regions and per-phase flags
• Spawn restrictions by biomes, weather, and blocks
• PlaceholderAPI support
• Vault support
• Flexible actions for all important events
• Support for multiple barrels in one airdrop
• Optional independent spawn points

Phase System
Each airdrop can go through the following stages:

PRE_SPAWN → BOSS_FIGHT → BREAKING → OPENING → OPENED

You can:

• disable unnecessary phases
• change the order of phases
• build different kinds of airdrops:
  • quick loot chests
  • boss-based airdrops
  • PvP/PvE events
  • breaking-based events
  • hidden-loot airdrops

Separate Schedule for Every Airdrop
Every airdrop can have its own schedule.

You can configure:

• whether auto-spawn is enabled
• timezone
• time format
• a list of daily spawn times

Example:

• 18:00
• 21:30

This allows you to run different event types at different times without external schedulers or workaround plugins.

Flexible Spawn System
You can configure:

• fixed coordinates
• random coordinates within a range
• random world surface spawning
• multiple spawn points with separate barrels around the center

Supported features:

• central airdrop point
• multiple child spawn points
• independent mode where each point behaves as a separate airdrop
• spawn block appearance animation
• delayed material display depending on phase

Schematics + WorldGuard + Phase-Based Protection
When an airdrop spawns, the plugin can:

• paste .schem / .schematic
• ignore air blocks
• automatically create or update a WorldGuard region
• add a custom region buffer
• restrict spawning to allowed regions
• change WorldGuard flags depending on the current phase

For example:

• allow PvP during the boss fight
• allow chest access during the opening phase
• block commands inside the event zone
• protect the structure from griefing

Advanced Boss System
For the BOSS_FIGHT phase, you can configure:

• mob type
• custom display name
• health
• glowing effect
• baby/adult mode
• boss spawn offset from the airdrop center
• spawn radius around the airdrop
• max allowed distance from the airdrop
• custom AI
• permanent potion effects
• boss loot handling

Boss loot modes:

• VANILLA — default Minecraft mob drops
• PLUGIN — only plugin-configured / editor loot
• DISABLE — no loot at all

Additional boss features:

• improved targeting
• improved movement
• damage participation tracking
• top damage dealers
• separate actions after boss death

⛏ Unique Breaking Mechanic
You can enable a special stage where players must break open the airdrop with hits.

Settings include:

• required number of hits
• trigger mode:
  • BREAK — attempt to break the airdrop block
  • CLICK — left-click the block
• hit progress mode:
  • SELF — every player must complete the required amount individually
  • GLOBAL — all hits are shared globally

This makes loot access feel earned instead of instant.

HideDrop — Hidden Loot
You can enable a mode where the real loot is hidden behind fake mask items.

The player does not see the actual reward immediately.
Instead, they click a mask item and receive the real item from that slot.

Supported features:

• per-player cooldown between item claims
• configurable mask item pool
• anti-instant-loot protection
• anti-auto-loot protection
• anti-double-click abuse protection

✨ Visuals and Display
BossBar
Configurable separately for each phase:

• title
• color
• style
• radius
• flags

Supported placeholders:

• {id}
• {timeLeft}
• {secondsLeft}
• {world}
• {x}
• {y}
• {z}
• {nextSpawn}
• {bossHealth}
• {bossMaxHealth}
• {breakingMode}
• {breakingCount}
• {breakingHits}
• {breakingCurrent}
• {breakingRemainingCurrent}
• {breakingCompletedPlayers}

Hologram
You can enable holograms above the airdrop.

Modes:

• VANILLA — ArmorStand lines, no external plugin required
• FANCY — FancyHolograms
• DECENT — DecentHolograms

Each phase can have its own:

• lineSpacing
• updateIntervalMillis
• updateRange
• viewRange
• lines

Effects
Each airdrop can have a separate effects config in:

plugins/hAirdrops/effects/<id>.yml

Supported:

• phase-based effects
• particles
• shapes:
  • point
  • circle
  • sphere
  • helix
  • line
  • box
• REDSTONE color
• BlockData
• ItemStack
• view distance
• forced rendering mode

Airdrop Summoner Item
You can configure a special summon item for:

/hairdrops givesummoner <id>

Supported:

• material
• display name
• lore
• enchants
• item flags
• per-airdrop permission:
  hairdrops.summoner.<id>

The player can use it with right-click in air or on a block, and the spawn point will be taken from the player’s target location.

Actions
The plugin supports actions for almost every important event:

• spawn
• bossAlive
• bossKilled
• bossKilled_1
• bossKilled_2
• bossKilled_3
• breakingProgress
• breakingReady
• breakingLocked
• unlock
• notReady
• protectedBlock
• summonerUseSuccess
• summonerUseFailed
• summonerNoPermission
• remove

Useful placeholders include:

• {id}
• {world}
• {x} {y} {z}
• {timeLeft}
• {nextSpawn}
• {bossHealth}
• {bossMaxHealth}
• {breakingCurrent}
• {breakingCount}
• {breakingRemainingCurrent}
• {bossKilled_killer_name}
• {bossKilled_killer_hp}
• {bossKilled_1_name}
• {bossKilled_1_hp}
• {bossKilled_2_name}
• {bossKilled_2_hp}
• {bossKilled_3_name}
• {bossKilled_3_hp}

PlaceholderAPI — Available Placeholders
General (active)

%hairdrops_active_id% - current active airdrop ID
%hairdrops_active_state% - state (Active / Waiting / None)
%hairdrops_active_status% - same as state
%hairdrops_active_active% - whether it is active (true/false)
%hairdrops_active_scheduled% - whether it is scheduled (true/false)
%hairdrops_active_phase% - current phase (PRE_SPAWN, BOSS_FIGHT, etc.)
%hairdrops_active_phase_name% - phase as readable text
%hairdrops_active_world% - world
%hairdrops_active_x% - X coordinate
%hairdrops_active_y% - Y coordinate
%hairdrops_active_z% - Z coordinate
%hairdrops_active_time_left% - remaining time (formatted)
%hairdrops_active_seconds_left% - remaining time in seconds
%hairdrops_active_next_spawn% - next spawn time
%hairdrops_active_boss_health% - boss health
%hairdrops_active_boss_max_health% - boss max health
%hairdrops_active_breaking_mode% - breaking mode
%hairdrops_active_breaking_count% - required amount of actions
%hairdrops_active_breaking_hits% - total hits
%hairdrops_active_breaking_current% - current progress
%hairdrops_active_breaking_remaining_current% - remaining amount for current stage
%hairdrops_active_breaking_completed_players% - players who completed breaking
%hairdrops_active_breaking_player_hits% - current player's hits
%hairdrops_active_breaking_player_remaining% - remaining hits for current player

Next

%hairdrops_next_id% - next airdrop ID
%hairdrops_next_state% - state
%hairdrops_next_status% - same as state
%hairdrops_next_active% - whether it is active
%hairdrops_next_scheduled% - whether it is scheduled
%hairdrops_next_phase% - phase
%hairdrops_next_phase_name% - phase as readable text
%hairdrops_next_world% - world
%hairdrops_next_x% - X coordinate
%hairdrops_next_y% - Y coordinate
%hairdrops_next_z% - Z coordinate
%hairdrops_next_time_left% - time until start
%hairdrops_next_seconds_left% - time in seconds
%hairdrops_next_next_spawn% - next appearance time
%hairdrops_next_boss_health% - boss health
%hairdrops_next_boss_max_health% - boss max health
%hairdrops_next_breaking_mode% - breaking mode
%hairdrops_next_breaking_count% - required amount
%hairdrops_next_breaking_hits% - total hits
%hairdrops_next_breaking_current% - current progress
%hairdrops_next_breaking_remaining_current% - remaining amount for stage
%hairdrops_next_breaking_completed_players% - players who completed it
%hairdrops_next_breaking_player_hits% - player's hits
%hairdrops_next_breaking_player_remaining% - remaining for player

Specific Airdrop
Replace <id> with the airdrop ID, which is the file name without .yml.


%hairdrops_airdrop_<id>_id% - airdrop ID
%hairdrops_airdrop_<id>_state% - state
%hairdrops_airdrop_<id>_status% - same as state
%hairdrops_airdrop_<id>_active% - whether it is active
%hairdrops_airdrop_<id>_scheduled% - whether it is scheduled
%hairdrops_airdrop_<id>_phase% - phase
%hairdrops_airdrop_<id>_phase_name% - phase as readable text
%hairdrops_airdrop_<id>_world% - world
%hairdrops_airdrop_<id>_x% - X coordinate
%hairdrops_airdrop_<id>_y% - Y coordinate
%hairdrops_airdrop_<id>_z% - Z coordinate
%hairdrops_airdrop_<id>_time_left% - remaining time
%hairdrops_airdrop_<id>_seconds_left% - time in seconds
%hairdrops_airdrop_<id>_next_spawn% - next spawn
%hairdrops_airdrop_<id>_boss_health% - boss health
%hairdrops_airdrop_<id>_boss_max_health% - boss max health
%hairdrops_airdrop_<id>_breaking_mode% - breaking mode
%hairdrops_airdrop_<id>_breaking_count% - required amount
%hairdrops_airdrop_<id>_breaking_hits% - total hits
%hairdrops_airdrop_<id>_breaking_current% - current progress
%hairdrops_airdrop_<id>_breaking_remaining_current% - remaining amount for stage
%hairdrops_airdrop_<id>_breaking_completed_players% - completed players
%hairdrops_airdrop_<id>_breaking_player_hits% - player's hits
%hairdrops_airdrop_<id>_breaking_player_remaining% - remaining for player

Counters

%hairdrops_active_count% - number of active airdrops
%hairdrops_scheduled_count% - number of scheduled airdrops

Commands

/hairdrops reload
/hairdrops spawn <id>
/hairdrops remove <id>
/hairdrops tp <id>
/hairdrops additems <id> <inventoryId>
/hairdrops boss <id>
/hairdrops givesummoner <id> <player> <amount>

Permissions

hairdrops.admin - access to admin commands
hairdrops.summoner.<id> - permission to use a specific airdrop summoner item

Dependencies
Optional:

• WorldGuard
• WorldEdit / FAWE
• FancyHolograms / DecentHolograms
• PlaceholderAPI
• Vault