Airdrop Options

Every airdrop type is configured through an in-game editor. Open it with:

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

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

Left-click — change the value (you’ll be asked to type it in chat).
Right-click — on list and map options (e.g. Avoid Block Types, Avoid Biomes), removes an entry; you’ll be asked which row/key to remove.
Wheel-click — restore the value to its default.

Every option falls back to the matching global default in config.yml unless you override it here, so an airdrop only stores the values you actually change. Options tagged with a dependency (e.g. [WorldEdit]) only do anything when that plugin is installed.

Each option is saved in airdrops.yml under the id shown in the tables (handy for the API and manual edits).

Identity & loot

Option	id	Description
Name (required)	`name`	The airdrop’s display name, used in messages and holograms.
Chance (required)	`chance`	Weight in the weighted-random spawn pool. Higher = more likely. The chance is relative to the sum of all airdrops’ chances, not a percentage.
Items	`items`	Opens the loot editor: a drag-and-drop grid where you place items and set a drop chance per item.
Inventory Rows	`inventory_rows`	Number of rows (1–5) of the loot inventory.

The loot editor lets you fill the chest with items and assign each one an independent drop chance, so a single airdrop can mix guaranteed and rare rewards.

Appearance

Option	id	Description
Block Type	`block_type`	The block that spawns as the airdrop and opens the loot inventory (any Bukkit block material).
Create Holograms	`create_holograms`	Show an info hologram above the block. [HolographicDisplays / DecentHolograms / FancyHolograms]
Hologram Height	`hologram_height`	Vertical offset of the hologram above the block. [hologram plugin]
Behaviors	`behaviors`	Assign reusable behaviors (events + conditions + actions) to this airdrop.
Effects	`effects`	Assign reusable effects (lasers and particle shapes) to this airdrop.

Lasers, particles, broadcasts, sounds, commands and explosions are not individual options anymore — they’re configured once as reusable behaviors/effects and toggled per airdrop with the Behaviors and Effects buttons.

Spawn location

Option	id	Description
Spawn World	`spawn_world`	World where 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 (keep within your 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`	Players are told a fuzzy location within this X range instead of exact coordinates.
Public Location Offset Z	`public_location_offset_z`	Same as above for the Z axis.

The plugin picks a random point inside the X/Y/Z box, then validates it against the spawn checks below. The public location offset generates a fake center so players have to search the area rather than walk to exact coordinates.

Spawn checks

Option	id	Description
Avoid Block Types	`avoid_block_types`	Blocks the airdrop cannot spawn on top of (e.g. water, lava).
Avoid Biomes	`avoid_biomes`	Biomes where the airdrop cannot spawn.
Clearance Margin	`clearance_margin`	Extra air blocks required around the airdrop’s footprint before it can spawn. `0` = just enough room to fit.
Min Players to Spawn	`min_players_to_spawn`	Minimum players online for this airdrop to spawn (`0` = no requirement).
Spectator Can Open Airdrop	`spectator_can_open_airdrop`	Whether spectator-mode players can open the airdrop.

The clearance margin is measured around the whole footprint — the entire schematic if one is set, otherwise the single block.

Timing & unlocking

Option	id	Description
Time to Unlock	`time_to_unlock`	Seconds the airdrop stays locked before it can be opened (`0` = no lock).
Start Unlocking on Interaction	`start_unlocking_on_interaction`	`true` = the unlock countdown starts when a player interacts with the block; `false` = it starts the moment the airdrop spawns.
Despawning Time	`despawning_time`	Seconds the airdrop stays in the world before despawning (`0` = never despawns).

All times are in seconds. Set 0 to disable a timer entirely.

Schematic decoration

Pastes a WorldEdit schematic as decoration around the airdrop. Leave Schematic empty to disable. [WorldEdit / FastAsyncWorldEdit]

Option	id	Description
Schematic	`schematic`	Schematic file name (from the `/schematics` folder). Empty 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 fine-tune; positive raises the structure, negative sinks 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`	If `true`, the schematic’s air blocks are skipped when pasting.
Schematic Despawn Mode	`schematic_despawn_mode`	What happens to the structure on despawn: `RESTORE` (bring back the original terrain), `REMOVE` (clear it, leaving a hole), or `KEEP` (leave it in the world).

Tip: when copying the schematic, stand exactly where the chest should land. The structure’s base rests on the surface and the chest appears at your copy position.

Extending the options

The option list isn’t fixed — it’s a registry. Add-ons and your own plugins can register custom properties (and the region add-ons do exactly this to add their check_* options). See the API page.