SupplyCrates

Overview

SupplyCrates creates a highly engaging, dynamic event for your server by introducing physical airdrops. When an airdrop triggers, an audible alarm alerts players, a particle-plane flies overhead, and a highly visible crate descends attached to a holographic parachute.

This is perfect for survival servers wanting to add points of conflict, or faction servers looking for a high-risk, high-reward PvP objective. Unlike older crate plugins, SupplyCrates relies on modern 1.20+ rendering for incredibly smooth visuals.

Key Features

• Lag-Free Animations: Utilizes 1.20+ BlockDisplay and ItemDisplay entities for buttery-smooth falling animations, completely bypassing the jittery armor-stand methods.
• Custom Loot Tables: Define endless tiers (e.g., Common, Epic, Mythic) and configure precise drop weights and enchanted loot.
• Immersive Plane Flyovers: A plane model constructed from directional particles sweeps across the sky with doppler-effect sound cues before deploying the crate.
• WorldGuard Integration: Automatically respects Safezones. Crates will never drop inside regions where block-breaking or PvP is disabled (unless configured otherwise).
• Flare Guns: Allow players to call in personal drops using custom Flare items.
• Extensive API & Skript Support: Hook into crate events easily to trigger your own custom server logic.

Mechanics & Setup

The Drop Sequence

The entire lifecycle of a supply crate is designed to draw players in and create excitement:

1. Announcement: A global broadcast announces the coordinates and tier of the incoming drop. The plugin intelligently selects a flat, accessible location within your configured world borders, avoiding lava lakes and oceans.
2. Flyover: A jet engine sound effect plays globally (fading based on distance). A localized particle effect draws a plane moving across the sky above the drop coordinates.
3. Descent: The crate drops from Y: 255 (configurable). It uses a custom falling animation with a 3D parachute model. A beacon beam often highlights its descent to guide players.
4. Impact & Looting: Upon hitting a solid block, the parachute despawns with a satisfying thud and explosion particles. The crate becomes a physical chest, barrel, or shulker box.
5. Claiming: Depending on configuration, players either Left-Click (break) or Right-Click (open) the crate. Loot is immediately distributed or explodes onto the ground!

Setting up Automated Events

You can configure SupplyCrates to run completely autonomously. In the config.yml, under random-drops, set an interval. Every X seconds, a drop will occur in a random configured world. This is the best way to keep your server active and give players random objectives to fight over.

Selling Flares

Players can be given Flares. When they right-click a flare, it shoots a firework into the sky and instantly schedules a private drop at their exact X/Z coordinates. Flares are excellent items to put in your server's webstore, vote crates, or boss drop tables.

Commands

All administrative commands required to manage drops and issue flares.

Permissions

Players do not need any permissions to open naturally spawned crates or use flares (unless specifically configured). Admins require the following:

Configuration Line-by-Line Breakdown

The config.yml manages global settings, timings, and drop logic.

# SupplyCrates Configuration

# Time in seconds before the crate spawns after the command is run
global-drop-time: 30

# Mode of the crate: 'chest', 'barrel', or 'model'
mode: model

# Flare Gun Customization
flare-gun:
  material: CARROT_ON_A_STICK
  custom-model-data: 0
  particles:
    trail: FLAME
    marker: CAMPFIRE_COSY_SMOKE

# Plane Delivery System Settings
plane-drop:
  enabled: false
  model-file: "Plane.bdengine"
  scale: 1.0
  fly-speed: 1.5
  height-above-crate: 30.0
  fly-distance: 100.0

Detailed Explanation of Options:

• mode: 'chest' or 'barrel' will spawn a vanilla block. 'model' uses BlockDisplays for smooth visuals.
• flare-gun: Customizes the visual flare item players use to manually call in crates.
• plane-drop: If enabled, spawns a visual plane model before the crate drops.

Integrations & Skript Support

SupplyCrates integrates with Skript to enhance functionality and event handling.

You can listen for supply crate events directly in your Skript files and add custom rewards, logging, or additional animations!

Troubleshooting

Crates spawn on roofs or trees instead of the ground

By default, SupplyCrates finds the highest non-air block. If you want crates to ignore leaves or certain blocks, make sure to add them to the ignored-blocks list in the config.

Crates are dropping inside protected WorldGuard regions

Ensure WorldGuard integration is enabled in config.yml (hooks.worldguard: true). The plugin will automatically recalculate a new drop location if the initially chosen coordinate is inside a region where PvP or block breaking is denied. If it still happens, verify that the region actually has those flags set to DENY.

The falling animation is jerky or lagging

Check your server's TPS (Ticks Per Second). While the plugin uses BlockDisplay entities which are incredibly smooth on the client-side, if your server's TPS drops below 19, the server ticks will delay the visual updates. Ensure you are running Paper or Purpur for optimal performance.