Airdrop Options

Every airdrop type is configured through an in-game editor, opened with:

/airdrops create        # creates a new airdrop and opens its editor
/airdrops edit <id>     # edits an existing airdrop

The editor is generated dynamically from the plugin’s property registry, so every option listed below appears as a clickable button. Most buttons share the same controls:

Left-click — changes the value. The new value is entered through chat.
Right-click — on list and map options (for example Avoid Block Types and Avoid Biomes), removes an entry. The row or key to remove is requested through chat.
Wheel-click — restores the value to its default.

Each option falls back to the matching global default in config.yml unless it is overridden here, so an airdrop only stores the values that were explicitly changed. Options tagged with a dependency (for example [WorldEdit]) have no effect unless that plugin is installed.

Each option is stored in airdrops.yml under the id shown in the tables. These ids are also the identifiers used by the API and by manual edits to the file.

Identity and loot

Option	id	Description
Name (required)	`name`	Display name of the airdrop, used in messages and holograms.
Chance (required)	`chance`	Weight in the weighted-random spawn pool. Higher values are selected more often. The value is relative to the sum of all airdrops’ chances, not a percentage.
Items	`items`	Opens the loot editor, a drag-and-drop grid in which items are placed and configured individually.
Inventory Rows	`inventory_rows`	Number of rows (1–5) of the loot inventory.

The loot editor

Items are placed into the grid, and each slot is configured independently from the Item Options view:

Setting	Control	Description
Chance	Shift-click	Probability (1–100%) that the item is included when the airdrop spawns.
Minimum Amount	Left-click	Lower bound of the randomised stack size (1 to the configured maximum).
Maximum Amount	Right-click	Upper bound of the randomised stack size (the configured minimum to 64).
Position	Q (drop key)	`Fixed` keeps the item in its configured slot. `Random` places it in a randomly chosen free slot on each spawn, after all fixed items have claimed theirs.

Each setting is independent per slot, so a single airdrop can combine guaranteed items with rare rewards of variable size and position.

Appearance

Option	id	Description
Block Type	`block_type`	Block spawned as the airdrop, which opens the loot inventory when interacted with (any Bukkit block material).
Create Holograms	`create_holograms`	Displays an informational hologram above the block. [HolographicDisplays / DecentHolograms / FancyHolograms]
Hologram Height	`hologram_height`	Vertical offset of the hologram above the block. [hologram plugin]
Behaviors	`behaviors`	Assigns reusable behaviors (trigger, conditions and actions) to this airdrop.
Effects	`effects`	Assigns reusable effects (lasers and particle shapes) to this airdrop.

Lasers, particles, broadcasts, sounds, commands and explosions are no longer individual options. They are defined once as reusable behaviors and effects, and enabled per airdrop through the Behaviors and Effects buttons.

Spawn location

Option	id	Description
Spawn World	`spawn_world`	World in which the airdrop spawns.
Max / Min X	`spawn_max_x` / `spawn_min_x`	X bounds of the spawn box.
Max / Min Y	`spawn_max_y` / `spawn_min_y`	Y bounds. These must remain within the world’s build limits.
Max / Min Z	`spawn_max_z` / `spawn_min_z`	Z bounds of the spawn box.
Public Location Offset X	`public_location_offset_x`	Range within which the announced X coordinate is randomised, instead of the exact position.
Public Location Offset Z	`public_location_offset_z`	Equivalent setting for the Z axis.

A random point inside the X/Y/Z box is selected and then validated against the spawn checks below. The public location offset produces an approximate centre, so the announced coordinates indicate a search area rather than the exact position.

Spawn checks

Option	id	Description
Avoid Block Types	`avoid_block_types`	Blocks the airdrop cannot spawn on top of, such as water or lava.
Avoid Biomes	`avoid_biomes`	Biomes in which the airdrop cannot spawn.
Clearance Margin	`clearance_margin`	Additional air blocks required around the airdrop’s footprint before it can spawn. `0` requires only the space needed to fit.
Min Players to Spawn	`min_players_to_spawn`	Minimum number of players online for this airdrop to spawn (`0` disables the requirement).
Spectator Can Open Airdrop	`spectator_can_open_airdrop`	Whether players in spectator mode are allowed to open the airdrop.

The clearance margin is measured around the entire footprint: the full schematic when one is configured, otherwise the single block.

Timing and unlocking

Option	id	Description
Time to Unlock	`time_to_unlock`	Seconds the airdrop remains locked before it can be opened (`0` disables the lock).
Start Unlocking on Interaction	`start_unlocking_on_interaction`	`true` starts the unlock countdown when a player interacts with the block. `false` starts it when the airdrop spawns.
Unlock Item	`unlock_item`	Item a player must hold in the main hand to start unlocking. The stack amount defines how many are required. An empty value disables the requirement.
Consume Unlock Item	`consume_unlock_item`	`true` removes the required amount from the player’s hand when the airdrop is unlocked.
Price to Unlock	`price_to_unlock`	Amount charged when a player starts the unlock (`0` disables the charge). Applies only to player-initiated unlocks, as described below. [Vault]
Despawning Time	`despawning_time`	Seconds the airdrop remains in the world before despawning (`0` disables despawning).
Empty Despawn Time	`empty_despawn_time`	Seconds an opened airdrop takes to despawn once its inventory is empty (`0` disables the timer).

All times are expressed in seconds. A value of 0 disables the corresponding timer.

Unlock resolution order

The unlock requirements interact as follows:

Configuring an Unlock Item overrides start_unlocking_on_interaction. The airdrop does not count down on its own and remains locked until a player interacts with it while holding the item.
With an Unlock Item and time_to_unlock: 0, presenting the item unlocks and opens the airdrop immediately, with no countdown.
With an Unlock Item and a time_to_unlock greater than 0, presenting the item starts the countdown.
The price is charged before the item is consumed, so a failed payment never consumes the item. Both requirements are validated together, and a player who meets neither is informed of both in a single interaction.
A player who does not meet the requirements receives the denial message and fires the OPEN_DENIED trigger, as when interacting with a locked airdrop.

Price to Unlock is only charged on player-initiated unlocks. The following table lists when it applies:

Configuration	Price charged
An Unlock Item is configured	Yes, when the player presents the item.
No item, `start_unlocking_on_interaction: true`, `time_to_unlock` > 0	Yes, when the player interacts with the airdrop to start the countdown.
No item, `start_unlocking_on_interaction: false`	No. The countdown starts on spawn, so no player initiates it.
No item, `time_to_unlock: 0`	No. The airdrop is already unlocked when it spawns.

The price also requires Vault. Without an economy plugin installed the check is skipped and the airdrop unlocks at no cost.

Empty Despawn Time is independent from Despawning Time. It starts only after the airdrop has been opened and its inventory is empty, and it is reset if items are placed back into the inventory. It is intended to remove looted airdrops promptly while leaving untouched ones their full lifetime.

Schematic decoration

Pastes a WorldEdit schematic as decoration around the airdrop. An empty Schematic value disables the feature. [WorldEdit / FastAsyncWorldEdit]

Option	id	Description
Schematic	`schematic`	Schematic file name, taken from the `/schematics` folder. An empty value disables it.
Schematic Offset X	`schematic_offset_x`	Paste offset on the X axis, relative to the block.
Schematic Offset Y	`schematic_offset_y`	Vertical adjustment. Positive values raise the structure, negative values lower it.
Schematic Offset Z	`schematic_offset_z`	Paste offset on the Z axis, relative to the block.
Schematic Ignore Air Blocks	`schematic_ignore_air_blocks`	When `true`, the schematic’s air blocks are skipped while pasting.
Schematic Despawn Mode	`schematic_despawn_mode`	Behaviour of the structure on despawn: `RESTORE` restores the original terrain, `REMOVE` clears the structure and leaves the resulting hole, and `KEEP` leaves the structure in the world.

When copying the schematic, stand exactly where the airdrop block is intended to appear. The structure’s base rests on the surface and the block is placed at the copy position.

Extending the options

The option list is a registry rather than a fixed set. Add-ons and third-party plugins can register custom properties, which is how the region add-ons provide their check_* options. See the API page for details.