Airdrop Mod

English | 中文

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: [Alert] Airdrop landed! Coordinates: [X, Y, Z]
• 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 [filename]	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)

# Whether to log the dirt block
logDirtBlock = true

# Magic number
magicNumber = 42

# Magic number introduction
magicNumberIntroduction = "The magic number is... "

# Item list
items = ["minecraft:iron_ingot"]

---

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.

Creating Loot Pools

1. Use command /airdrop edit <name> to open edit interface
2. Place items in the opened chest interface
3. Close interface to auto-save

Loot Pool Files

Loot pool configurations are saved in world data and can be backed up or shared via export functionality.

---

Mod Compatibility

Mod	Compatibility
border_weaver	Optional dependency, provides world border integration

---

Installation

1. Ensure Forge 47+ is installed (Minecraft 1.20.1)
2. Place mod JAR file in mods folder
3. Launch the game

---

Development Info

• Mod ID: airdrop
• License: All Rights Reserved
• Source Code: Java 17+

---

FAQ

Q: Airdrops don't generate items?

A: Make sure at least one loot pool is created. Use /airdrop edit <name> to create one.

Q: How to modify airdrop descent speed?

A: Current descent speed is fixed at approximately 2 minutes. To modify, you need to edit AirdropEntity.java in the source code.

Q: Can airdrops be set in specific biomes?

A: Not currently supported, but similar effect can be achieved using the Range Limiter.

---

Changelog

1.0

• Initial release
• Basic airdrop system
• Flare gun items
• Scheduled airdrop feature
• Loot pool management
• Config import/export