Configuration

config.yml holds the global defaults for UltimateAirdrops. Most of these values are the fallback used by every airdrop that doesn’t override the matching setting in its own editor — so you can set sensible server-wide defaults here and only fine-tune individual airdrops when needed (see Airdrop Options).

After editing the file, apply your changes with /airdrops reload.

Anything written in brackets [] in a comment is a plugin dependency required for that setting to work.

---

Customization

Config:
    block-type: "CHEST"                 # Block used for the airdrop (any Bukkit Material that is a block).
    inventory-rows: 3                   # Rows (1-5) of the airdrop loot inventory.
    public-location-offset-x: 15        # Players are told a fuzzy location within this X range.
    public-location-offset-z: 15        # Players are told a fuzzy location within this Z range.
    broadcast-spawn-remove: true        # Broadcast a message when an airdrop fails to find a safe spawn.
    spectator-can-open-airdrop: false   # Allow spectator-mode players to open airdrops.

    create-holograms: true              # Info holograms above airdrops. [HolographicDisplays/DecentHolograms/FancyHolograms]
    hologram-height: 2.0                # Vertical offset of the hologram above the block.

The public location offset is what makes airdrops a hunt: instead of exact coordinates, players receive a randomized center within the configured offset, so they have to search the area.

---

Compass

An optional tracker compass that, while held, points to the nearest spawned airdrop in the player’s world. Hand it out with /airdrops compass [player].

    compass:
        enabled: true                   # Enables the tracker compass and the /airdrops compass command.
        item-name: "&b&lAirdrop Tracker"
        item-lore:
          - "&7Points to the nearest airdrop"
          - "&7in your current world."
        custom-model-data: 0            # For resource packs (0 = none).

---

Schematic

Paste a WorldEdit schematic as decoration around the airdrop block. Leave file empty to disable. [WorldEdit / FastAsyncWorldEdit]

    schematic:
        file: ""                        # Schematic file (in the /schematics folder), empty = disabled.
        offset-x: 0                     # Paste offset on X relative to the airdrop block.
        offset-y: 0                     # Vertical fine-tune (the schematic's lowest layer sits on the surface).
        offset-z: 0                     # Paste offset on Z relative to the airdrop block.
        ignore-air-blocks: true         # Skip the schematic's air blocks when pasting.
        despawn-mode: "RESTORE"         # On despawn: RESTORE terrain, REMOVE it (leaves a hole), or KEEP it.

Tip: when copying the schematic in WorldEdit, stand exactly where the chest should appear. The schematic’s base rests on the surface and the chest lands at your copy position.

---

Cooldowns

    airdrop-spawn-delay: 72000          # Base delay between spawns, in seconds (0 = disable auto-spawning).
    delay-treshold: 3000               # Random +/- jitter added to the delay, in seconds (0 = disable).
    airdrop-despawning-time: 6000       # How long an airdrop stays before despawning, in seconds (0 = never).
    time-to-unlock-airdrop: 30          # Lock time before players can open it, in seconds (0 = no lock).
    start-unlocking-on-interaction: true # true = countdown starts on interaction; false = starts on spawn.

The actual interval between drops is airdrop-spawn-delay ± a random value up to delay-treshold, so spawns feel unpredictable.

---

Conditions

    min-players-to-spawn-airdrop: 0     # Minimum players online for an airdrop to spawn (0 = disable).

---

Spawn location

The world and the bounding box airdrops can spawn inside. Keep maxY / minY within your world’s build limits.

    world: "world"
    maxX: 100000
    maxZ: 100000
    maxY: 319
    minX: -100000
    minZ: -100000
    minY: -63

---

Spawn checks

How the plugin validates a candidate location before placing a drop.

    max-random-location-checks: 25      # How many times the server tries to find a valid location.
    avoid-block-types:                  # Blocks an airdrop cannot spawn on top of.
        - WATER
        - FLOWING_WATER
        - LAVA
        - FLOWING_LAVA
    avoid-biomes:                       # Biomes where airdrops cannot spawn.
        #- OCEAN
        #- DEEP_OCEAN
    clearance-margin: 1                 # Extra air blocks required around the airdrop's footprint. 0 = just enough to fit.

The clearance margin measures around the whole footprint — the entire schematic if one is set, otherwise the single airdrop block — so decorated drops won’t spawn jammed into terrain.

---

Messages

All player-facing text lives in messages.yml and supports & color codes and full hex colors (&#RRGGBB). Behaviors can reference a message by its key with the lang action parameter (see Behaviors).