Paojiao134's Airdrop

# Airdrop Mod **English** | **(./README.md)** > **Version**: 1.0 > **Minecraft Version**: 1.20.1 > **Mod Loader**: Forge 47+ > **Author**: Alku --- ## Introduction Airdrop is a server-oriented Minecraft mod that adds an exciting airdrop system. Players can summon airdrop crates using flare guns, which slowly descend from the sky bringing valuable supplies. The mod supports custom loot pools, scheduled airdrops, range restrictions, and more. --- ## Items ### Flare Gun - **Rarity**: Epic (EPIC) - **Max Stack**: 1 - **Function**: Right-click to summon an airdrop crate at the player's current position - **Cooldown**: 100 ticks (5 seconds) - **Durability**: Unlimited uses ### Disposable Flare Gun - **Rarity**: Common (COMMON) - **Max Stack**: 16 - **Function**: Right-click to summon an airdrop crate at the player's current position - **Cooldown**: 20 ticks (1 second) - **Feature**: Consumes one item on use, all players receive coordinate notification ### Range Limiter - **Max Stack**: 1 - **Function**: Set the area where airdrops can randomly spawn - **Usage**: 1. Right-click the first block → Set point A 2. Right-click the second block → Set point B, area defined 3. **Sneak + Right-click** → Clear range restriction --- ## Airdrop Entity ### Airdrop Crate Properties | Property | Description | |----------|-------------| | Inventory Size | 27 slots (equivalent to a large chest) | | Drop Height | Y = 300 | | Drop Duration | Approximately 2 minutes | | Drop Speed | 0.0983 blocks/tick | ### Descent Process 1. Airdrop crate starts descending from Y=300 2. Produces **flame** and **smoke** particle trails during descent 3. Triggers server-wide notification upon landing ### Landing Effects - **Chat Message**: ` Airdrop landed! Coordinates: ` - **Screen Title**: Large text displaying "Airdrop Landed!" + coordinate subtitle - **Sound Effect**: Plays challenge complete sound - **Particle Effects**: - Light beam from ground to sky (soul flame + glow particles) - Tall campfire signal smoke - Flame and large smoke at the base ### Interaction - Right-click the airdrop crate to open inventory - Survival mode players' first open marks it as "claimed" --- ## Command System All commands require **OP level 2** or higher permission. ### Basic Commands | Command | Description | |---------|-------------| | `/airdrop summon` | Summon an airdrop crate at a random location | ### Loot Pool Management | Command | Description | |---------|-------------| | `/airdrop edit <name>` | Open GUI to edit specified loot pool | | `/airdrop delete <name>` | Delete specified loot pool | ### Config Import/Export | Command | Description | |---------|-------------| | `/airdrop export <name>` | Export single loot pool to JSON file | | `/airdrop import <filename>` | Import loot pool from JSON file | | `/airdrop exportall ` | Export all loot pools (default filename: airdrop_all) | | `/airdrop importall <filename>` | Import all loot pools from JSON file | ### Scheduled Airdrops | Command | Description | |---------|-------------| | `/airdrop schedule list` | List all scheduled airdrop tasks | | `/airdrop schedule add <name> <time> <chance>` | Add scheduled airdrop task | | `/airdrop schedule remove <name>` | Remove scheduled airdrop task | **Parameter Description**: - `time`: Minecraft in-game time (0-24000) - `chance`: Trigger probability (0.0-1.0, e.g., 0.5 means 50%) ### Other | Command | Description | |---------|-------------| | `/airdrop particles` | Toggle airdrop particle effect display (client-side) | --- ## Scheduled Airdrop System Scheduled airdrops allow the server to automatically generate airdrops at specific times. ### Configuration Example ``` /airdrop schedule add morning 6000 0.3 ``` This will trigger a 30% chance of airdrop at game time 6000 (noon). ### How It Works - The system checks all scheduled airdrop tasks every game day - When game time matches, it decides whether to trigger based on set probability - When triggered, airdrop spawns randomly within configured range --- ## Airdrop Range System ### Range Priority 1. **World Border Integration** (if border_weaver mod is installed) 2. **Manually Set Range** (via Range Limiter) 3. **Random Around Player** (default: player position ±100 blocks) ### World Border Support The mod automatically detects world borders, ensuring airdrops always spawn within bounds. --- ## Configuration Files Configuration files located at: `config/airdrop/` ### Main Config (Forge Config) ```toml # Whether to log the dirt block logDirtBlock = true # Magic number magicNumber = 42 # Magic number introduction magicNumberIntroduction = "The magic number is... " # Item list items = ``` --- ## Loot Pool System ### Loot Pool Concept Loot pools are the random source for items in airdrop crates. Each loot pool contains 27 item slots, and a random pool is selected when an airdrop spawns. ###