Mysterium Fateboxes is a highly advanced, thrilling "Lucky Block" style mod for Minecraft (built on NeoForge 26.2). It introduces a high-stakes risk-vs-reward system where opening a Fate Box can either shower you with incredible wealth or unleash devastating punishments.

The core block of the mod. Placing it down sets the stage for a game of chance. You cannot open it with your bare hands—you must use a special key, and the block is completely unbreakable in Survival mode (just like Bedrock)!

• Recipe: 4 Iron Ingots (corners), 4 Gold Ingots (sides), and 1 Diamond (center).

The mystical key required to unlock the Fate Box's secrets. Right-clicking a Fate Box with this key consumes the key and triggers the event.

• Recipe: 1 Gold Ingot (top), 1 Gold Ingot (middle), and 1 Redstone Dust (bottom).

When you unlock a Mysterium Fate Box, you experience a dynamic Roll Chance System. A 3-second opening sequence initiates with custom sounds and effects before your fate is revealed.

The system rolls a number from 1 to 100, modified dynamically by your hidden Fate Level (LOW, MID, or HIGH), directly altering your chances of certain outcomes.

If the odds are in your favor, a joyful sound plays, you receive a green chat message (detailing your Fate Level), and you are rewarded. A 25% chance grants you one of five incredible reward categories. Missing this roll triggers the Woolarama event (45% chance) or gives a fallback item reward!

• On-Screen Titles:
  • If you get a major Gift reward, your screen will light up with a diamond blue "A MYSTICAL GIFT!" text.
  • Triggering the Woolarama event shows a rainbow-animated "WOOLARAMA!" title.
  • Triggering trap events (Explosion, Lava Pool, Arrows) displays a red "TRAP TRIGGERED!" title.
  • Spawning mob hordes displays a red "UNDEAD HORDE!" title.
  • Spawning the Wither Boss ambush displays a red "WITHER CURSE!" title.

1. Valuable Items: Drops 1-3 highly valuable items (Diamonds, Emeralds, Netherite Ingots, Totems of Undying, Enchanted Golden Apples, blocks of precious metals, etc.).
2. Weapons: Drops a random high-tier weapon (Diamond/Netherite Swords, Bows, Crossbows, Tridents).
3. Armor Sets: Drops an entire, full set of armor at once! Ranges from Iron and Gold to Diamond and Netherite.
4. Tools: Drops a random high-tier tool (Diamond/Netherite Pickaxes, Axes, Shovels, or Hoes).
5. Food: Drops a stack of high-tier food in multiples of 2 (up to 16 items). Includes Golden Carrots, Cooked Beef, Pumpkin Pies, and more.
6. Woolarama Event: (45% chance after gift roll fails) Drops 16 to 32 vibrantly colored rainbow sheep from the sky with a Slow Falling effect, complete with an animated "WOOLARAMA!" rainbow title screen!

If your luck runs out, an ominous sound plays, a red chat message appears, and one of several terrifying punishments is unleashed depending on your exact roll:

1. Wither Boss Ambush: If you hit a 5% chance roll on a HIGH Fate Level, 4 Wither Bosses will spawn simultaneously around you!
2. TNT Explosion (50% bracket): A sudden, raw explosion exactly at your location.
3. Raining Flaming Arrows (15% bracket): An army of unseen archers fires 25 to 50 flaming arrows high into the sky, raining down over a 20x20 area with dynamic arcing vectors targeting your position.
4. Lava Pool Trap (10% bracket): Instantly generates a 7x7 circular pool of lava directly beneath your feet, no matter where you ran.
5. Mob Hordes (25% bracket): Spawns 4 to 7 Zombies, Husks, or Drowned surrounding you. Beware: Each mob has a 33% chance to spawn as an "Elite" wearing full Netherite Armor and wielding a Netherite weapon!

• Global Cooldowns: To prevent spamming, the mod features a built-in 26-second cooldown. If you try to open another box while on cooldown, you will receive a bold red warning message indicating how much time is left.
• Custom Advancements: The mod comes with a fully integrated advancement tree ("Mysterium Fate") to guide players through crafting their first Box and Key, complete with a custom background UI.
• Safe Creative Mode: If you are in Creative Mode, keys will not be consumed upon use.

1. Install NeoForge 26.2.
2. Drop the mysteriumfateboxes-1.0.4-release.jar into your .minecraft/mods folder.
3. Load up your world and test your fate!

This mod is open-source and is distributed under the terms found in the LICENSE file provided with this repository.