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.