Skyfall: Crates

Adds easily customizable loot crates for server and world events.

This mod requires Modular Toasts API to work!

WHAT IS SKYFALL?
━━━━━━━━━━━━━━━━━━━━

Skyfall introduces server-wide loot events where a massive 3x3x3 Skyfall Crate falls from the sky and lands somewhere in the world.

• Global chat announcement
• Custom on-screen notification (via ModularToasts API)
• Particles, smoke, and impact shockwave
• Physically falling crate entity, with a cool rotating animation
• Multi-block crate structure
• Server-configurable loot tables

/skyfall gui

━━━━━━━━━━━━━━━━━━━━
HOW IT WORKS
━━━━━━━━━━━━━━━━━━━━

1. A Skyfall Crate spawns high above the world.

2. All players receive:
   • A custom animated toast notification
   • A styled global chat message
   • Clickable coordinates

3. The crate falls with particles and a spinning animation.

4. Upon landing:
   • It creates a 3x3x3 crate structure
   • Fills the crate with server-defined loot

5. Players open the crate and claim the rewards.

The crate is extremely durable and will attempt to land safely on:
• Solid ground
• Snow
• Leaves
• Trees
• Uneven terrain
• Water surfaces

It will never fail placement unless absolutely necessary.

━━━━━━━━━━━━━━━━━━━━
COMMANDS
━━━━━━━━━━━━━━━━━━━━

All commands start with:

/skyfall

Requires permission level 2 (OP / admin).

Status / Info

/skyfall status
Shows the current Skyfall configuration, including:

• Enabled state
• Spawn interval in seconds
• Roll count range
• Loot entry count
• Spawn radius range
• Drop height range
• Fall speed multiplier
• Anchor dimension and position

Enable / Disable Automatic Events

/skyfall enable <true|false>
Turns automatic Skyfall events on or off.

Timer (Automatic Spawn Interval)

/skyfall timer <seconds>
Sets how often Skyfall crates spawn automatically.

• Minimum: 5
• Maximum: 86400 (24 hours)

Spawn Radius

/skyfall radius <min> <max>
Sets the random spawn radius, in blocks, around the current anchor position.

This controls how close or far a random Skyfall event can appear from the anchor.

Drop Height

/skyfall drophigh <min> <max>
Sets how high above the ground the falling crate starts.

Useful for making drops feel faster, more dramatic, or easier to see from a distance.

Fall Speed

/skyfall fallspeed <mult>
Sets the falling speed multiplier for Skyfall crates.

• Minimum: 0.10
• Maximum: 6.00

Examples:

• 1.00 = normal speed
• 2.00 = twice as fast
• 0.50 = half speed

Chunk Generation Behavior

/skyfall genchunks <true|false>
Controls whether Skyfall is allowed to generate/load new chunks while searching for a valid random drop location.

• false = Skyfall only uses already-loaded chunks
• true = Skyfall may load or generate chunks for spawn locations

Rolls

/skyfall setrolls <min> <max>
Sets the loot roll range for each Skyfall crate.

This controls how many loot rolls are performed when generating crate contents.

Anchor Commands

The anchor is the center point used for random Skyfall spawn radius calculations.

/skyfall anchor show
Displays the current anchor.

/skyfall anchor here
Sets the anchor to your current position.

/skyfall anchor set <x> <y> <z>
Sets the anchor to a specific position.

/skyfall anchor spawn
Sets the anchor to the world spawn point.

Manual Spawn Commands

/skyfall spawn
Spawns a falling crate above the command sender.

/skyfall spawn <x> <y> <z>
Spawns a falling crate at an exact position.

/skyfall spawnrandom
Forces a random Skyfall spawn using the current anchor, radius, drop height, and chunk rules.

GUI

/skyfall gui
Opens the Skyfall loot editor GUI.

This is the main admin interface for editing crate loot, weights, counts, slot layout, and crate generation rules.

Loot Commands

Clear Loot Table

/skyfall gui clear
Clears all Skyfall loot entries.

Add Item From Hand

/skyfall gui addhand <weight> <minCount> <maxCount>
Adds the item in your main hand to the Skyfall loot table.

Examples:

• Set how common the item is with weight
• Set stack size range with minCount and maxCount

Remove Specific Entry

/skyfall gui remove <index>
Removes the loot entry at the given index.

List Loot Entries

/skyfall gui list
Lists loot entries on page 0.

/skyfall gui list <page>
Lists loot entries on a specific page.

Randomize Entire Loot Table

/skyfall loot randomize-all confirm
Generates a full randomized Skyfall loot table using all registered items currently available in the game, including modded items.

This is intended for fast setup and testing.

Use with caution, since it may include items from every installed mod.

━━━━━━━━━━━━━━━━━━━━
LOOT SYSTEM
━━━━━━━━━━━━━━━━━━━━

The Skyfall Crate pulls rewards from a server-side loot table.

Server admins can configure:
• Drop rarity
• Loot pool
• Reward quantities
• Event frequency

━━━━━━━━━━━━━━━━━━━━
MULTIPLAYER
━━━━━━━━━━━━━━━━━━━━

Skyfall was built with multiplayer in mind.

• Server-wide announcements
• Safe block placement logic
• Cross-dimension player notifications
• Mergeable notification system
• High reliability on uneven terrain

Perfect for:
• Survival servers/SMPs
• RPG servers
• Factions
• SMP worlds
• Event-based servers

━━━━━━━━━━━━━━━━━━━━
DEPENDENCIES
━━━━━━━━━━━━━━━━━━━━

Required:
• ModularToasts API

━━━━━━━━━━━━━━━━━━━━
WHY SKYFALL: CRATES?
━━━━━━━━━━━━━━━━━━━━

It basically creates:
• Races across the map
• PVP hotspots
• Community excitement

If your server needs dynamic world events that feel cinematic and important, try Skyfall: Crates!

━━━━━━━━━━━━━━━━━━━━
PERFORMANCE
━━━━━━━━━━━━━━━━━━━━

• Lightweight logic
• Server-authoritative placement
• Efficient structure validation
• No constant tick scanning
• Optimized collision checks

Check out my Patreon!

Even if you can't donate, simply subscribing to the free tier is tremendous support :)

Patreon