Phoenix's Loot Bags

Phoenix's Loot Bags introduces a comprehensive loot system to Minecraft featuring animated bag-opening mechanics and dimension-themed rewards. The mod integrates seamlessly with vanilla structures and mob drops while adding an engaging slot machine animation when opening loot bags.

Overview

Loot Bag Types

The mod features 20 distinct loot bag variants organized into four thematic categories across five rarity tiers:

Themed Categories: Overworld, Dungeon, Nether, and End
Rarity Tiers: Common, Uncommon, Rare, Epic, and Legendary
Each combination provides unique loot pools tailored to its theme and rarity level

Opening Mechanics

Multiple interaction modes provide flexibility in how players access their loot:

Standard Opening: Right-click to view the full slot machine animation
Instant Opening: Shift + Right-click to bypass animation and receive items immediately
Bulk Opening: Shift + Right-click on a stack to open all bags consecutively
Inventory overflow protection automatically drops excess items near the player

Animation System

The slot machine animation displays 30 randomized items over 2.5 seconds before revealing the final reward at 1.7 seconds. This visual feedback system enhances the excitement of opening higher-tier bags while remaining skippable for convenience.

Nested Reward System

Higher rarity bags have a chance to contain lower rarity bags as part of their loot:

Legendary bags may yield Epic bags (1-2 bags)
Epic bags may yield Rare bags (1-2 bags)
This creates cascading reward opportunities with multiple opening sessions

Acquisition Methods

Structure Integration

Loot bags are integrated into vanilla structure loot tables with dimension-appropriate distributions:

Overworld Locations:

Village buildings (all profession types)
Pillager outposts
Shipwrecks and buried treasure
Underwater ruins (large and small)

Underground Locations:

Monster dungeons and abandoned mineshafts
Stronghold corridors, crossings, and libraries
Ancient city chests and ice boxes
Trial chamber reward chests

Nether Locations:

Nether fortress chests
Bastion remnant chests (treasure, bridge, hoglin stable, and general types)

End Locations:

End city treasure chests
Stronghold chests (spawns both Dungeon and End bags)

Cross-Dimensional:

Ruined portals contain both Overworld and Nether bags regardless of dimension

Mob Drop System

The mod implements a scaled mob drop system where drop rates and quantities correlate with mob difficulty. Over 30 different mob types have been configured with appropriate loot bag rewards:

Standard Hostiles (5-10% drop chance):

Basic overworld mobs drop 1 Overworld bag
Includes zombies, skeletons, spiders, and creepers

Intermediate Threats (10-20% drop chance):

Mid-tier mobs drop 1-3 dimension-appropriate bags
Includes endermen, witches, blazes, and ghasts
Higher rarity distributions than standard mobs

Elite Enemies (15-30% drop chance):

Dangerous mobs drop 2-4 bags with increased rare/epic rates
Includes evokers, ravagers, piglin brutes, and shulkers

Boss Encounters:

Warden: 75% drop chance for 4-6 Dungeon bags with elevated legendary rates
Wither: 100% drop chance for 6-10 Nether bags with balanced rarity distribution
Ender Dragon: 100% drop chance for 8-12 End bags with guaranteed legendary drops

Technical Specifications

Performance Characteristics

Client-side animation rendering with minimal performance impact
Efficient loot pool generation algorithms
Multiplayer-synchronized through custom network packets
No server-side performance degradation from bag opening operations

Requirements and Compatibility

Minecraft Version: 1.21.1
Mod Loader: Fabric
Dependencies: Fabric API (required)
Integration: Full modding API available for third-party mod developers

Developer Integration

The mod provides a comprehensive API enabling other mods to extend functionality:

Custom mob drop registration system
Custom chest loot table integration
Custom item injection into existing loot pools
Complete API documentation available in the project repository

Usage Recommendations

Inventory Management

Ensure adequate inventory space before opening higher-tier loot bags, as they may contain substantial quantities of items. The overflow protection system will drop excess items at the player's location if inventory capacity is exceeded.

Strategic Opening

Legendary bags provide the highest value rewards and are best reserved for critical moments
Bulk opening functionality streamlines processing large quantities of common bags
Boss farming yields consistent high-tier bag acquisition

Dimension-Specific Applications

Nether bags provide fire resistance potions and other nether-survival resources
End bags contain chorus fruit and ender pearls useful for dimension traversal
Dungeon bags offer spawn eggs valuable for mob farm construction

Reward Cascading

The nested bag system enables chain openings where legendary bags yield epic bags, which in turn yield rare bags, creating extended reward sequences from single high-tier bag openings.

Loot Pool Contents

Overworld Bags

Standard survival resources and rare decorative materials:

Base resources: Iron ingots, gold ingots, diamonds
Decorative blocks: Moss blocks, slime blocks, honey blocks, tinted glass, amethyst clusters
Enchanted equipment featuring blast protection enchantments
Consumables including various food items and golden apples

Dungeon Bags

Underground exploration rewards and mob-related items:

Deepslate ore variants of all standard ores
Sculk blocks, sensors, and catalysts
Comprehensive spawn egg collection (41 different types including passive and hostile mobs)
Enchanted armor with projectile protection
Netherite scrap available in legendary tier bags

Nether Bags

Nether-exclusive materials and survival resources:

Ancient debris and processed netherite ingots
Smithing templates (available in epic and legendary tiers)
Fire resistance potions and brewing ingredients
Nether wart and glowstone in substantial quantities
Gold resources ranging from ingots to block form (up to 64 blocks in legendary bags)
Fire protection enchanted armor and specialized boots with soul speed and frost walker

End Bags

End-game equipment and dimension-specific materials:

Elytras (unenchanted in epic tier, enchanted in legendary tier)
Shulker shells and crafted shulker boxes
End crystals and dragon egg (legendary tier exclusive)
Comprehensive protection enchanted armor featuring all four protection types
Popped chorus fruit and end rods
Fireworks in large quantities (up to 256 rockets in legendary bags)

Issue Reporting and Feedback

Users experiencing technical issues or wishing to provide feedback should utilize the project's issue tracking system. Bug reports should include relevant system information, Minecraft version, and reproduction steps when applicable.

Licensing and Distribution

This modification is authorized for inclusion in modpacks without requiring explicit permission. Attribution is appreciated but not mandatory. The mod is provided as-is under standard modding community practices.