LIFE-XP Challenge

🌟 LIFE-XP Challenge

Survive, scale, and conquer. Turn your experience points into your most vital survival resource.

---

📖 What is LIFE-XP Challenge?

LIFE-XP Challenge is a hardcore progression and survival overhaul mod for Minecraft 1.21.2 or 26.2, developed on a unified Architectury monorepo supporting both Fabric and NeoForge with 100% feature parity.

In vanilla Minecraft, experience levels are trivial—used merely for enchanting or anvil repairs, and mostly forgotten after reaching level 30. LIFE-XP binds your entire physical existence to your XP bar:

• You begin vulnerable and fragile (starting with as little as 0.5 hearts in hardcore mode).
• Every single experience level dynamically enhances 15 player attributes (Health, Speed, Attack Damage, Attack Speed, Toughness, Reach, Mining Speed, and more).
• Your experience functions as an active Energy Shield, absorbing incoming attacks before they damage your health via custom alchemy.
• Combat streaks grant exponential XP multipliers, but deaths impose a Smart Death Tax that heavily penalizes reckless mistakes.

---

✨ Game-Changing Mechanics

Feature	Description
$O(1)$ Dynamic Scaling	15 player attributes smoothly scale using highly optimized $O(1)$ math. No server freezes, even if you receive 50,000 levels at once.
Visual Peril System	Immersive vignette and ambient ash particles at low experience levels. Replaces legacy fog, resolving chunk culling drops.
Persistent Kill Streaks	Up to +100% XP from mob kills. Streaks are now saved to player NBT, persisting across sessions with a 5-minute AFK timeout.
Right-Click & AoE Harvest	Instantly harvest and replant mature crops with Right-Click. Enchant tools with XP Harvester 2+ for AoE crop gathering and a strict 6-block Ore VeinMiner.
Data-Driven Enchants	Extract mod artifacts directly from the water using the Anomaly Angler enchantment.
Brewable XP-Shield	Damage drains XP before health, but only if you brew the custom XP-Shield Potion (up to 75% absorption).
Origins-Style Presets	First-time joiners are greeted with a mandatory, unclosable GUI to select and permanently lock their difficulty preset.
Interactive UI	Clean HUD with 10 XP bubbles, color-shifting level text, paginated /lifexp status, and color-ranked /lifexp top leaderboards.

---

📦 Installation & Requirements

System Requirements

• Minecraft: 26.2 (1.21.1 Supported)
• Java: 25+
• Mod Loaders: Fabric Loader or NeoForge

Fabric Installation

1. Install Fabric Loader 26.2.
2. Place required dependencies into your .minecraft/mods/ folder:

• Architectury API (Fabric)
• Fabric API
• YetAnotherConfigLib (YACL) v3
• (Optional but Recommended) JEI or EMI

1. Drop life_xp_challenge-1.6.2-fabric.jar into mods/.

NeoForge Installation

1. Install NeoForge 26.2.
2. Place required dependencies into your .minecraft/mods/ folder:

• Architectury API (NeoForge)
• YetAnotherConfigLib (YACL) v3

1. Drop life_xp_challenge-1.6.2-neoforge.jar into mods/.

🧬 Core Progression & Mechanics

Mathematical Scaling Model

Attributes are recalculated dynamically across three anchor points: startValue (Lvl 0), midValue (Lvl maxLevel / 2), and endValue (Lvl maxLevel)

Scaled Attributes

• Combat: Max Health (max_health), Attack Damage (attack_damage), Attack Speed (attack_speed), Sweeping Damage Ratio (sweeping_damage_ratio).
• Defense & Agility: Movement Speed (movement_speed), Sneak Speed (sneaking_speed), Armor Toughness (armor_toughness), Knockback Resistance (knockback_resistance), Safe Fall Distance (safe_fall_distance).
• Utility & Survival: Block Reach (block_interaction_range), Entity Reach (entity_interaction_range), Mining Speed (block_break_speed), Submerged Mining (submerged_mining_speed), Underwater Oxygen (oxygen_bonus), Fire Burning Duration (burning_time).

---

⚔️ Combat & Alchemy (XP-Shield)

🛡️ Potion-Based XP-Shield

Forget passive shields. Survival now requires alchemy. The XP-Shield absorbs incoming damage after armor calculations by burning your experience points (1:1 ratio).

• Brewing a Shield Core: A new crafting ingredient required to initiate the brewing process.
• Level I (25% Absorption): Awkward Potion + Shield Core (Base: 3:00 | Extended: 8:00 with Redstone).
• Level II (50% Absorption): Level I + Glowstone Dust (1:30).
• Level III (75% Absorption): Level II + Nether Star (1:00).
• Warning: If you take fatal damage and run out of XP, the shield breaks and the remaining damage instantly hits your health pool.

---

🧪 Utility Items & Recipes

1. Shield Core (shield_core)

• The core catalyst for brewing XP-Shield potions.

2. Life Bottle (life_bottle)

• Saves all 41 inventory slots upon death into an invulnerable ground entity.
• Void Protection: Rescues your inventory even if you fall into the End Void.
• Hold Shift + Right-Click to unpack equipment directly into their original slots.

3. Dynamic XP Bottle (dynamic_xp_bottle)

• Hold Shift + Right-Click to siphon player XP into the bottle (10% storage tax).
• Press Right-Click to instantly reclaim stored XP.

---

🎚️ Difficulty Presets

Upon joining the world for the first time, an unclosable GUI will prompt you to choose your destiny. Once chosen, your preset is locked to your character forever via NBT.

Setting	☠ core	💎 core_no_streaks	⚔️ purist	💚 vanilla_plus
Starting Health	1.0 HP (0.5 heart)	1.0 HP	1.0 HP	6.0 HP (3 hearts)
Max Health	40.0 HP (20 hearts)	40.0 HP	40.0 HP	24.0 HP (12 hearts)
maxLevel Cap	1,000	1,000	1,000	500
Kill Streaks	Enabled	Disabled	Disabled	Enabled
Dynamic Visuals	Vignette	Vignette	Disabled	Disabled
Base Death Tax	100%	100%	100%	50%

(Extreme profiles like baby_mode and real_hardcore are also available in the menu).

---

🏗️ Architecture

LIFE-XP-Challenge-Architectury/
├── common/                  # Unified multi-loader core logic
│   ├── client/              # In-game HUD overlay & GUI screens
│   ├── compat/              # JEI & EMI native integration plugins
│   ├── config/              # JSON engine, presets, and YACL builder
│   ├── effect/              # Custom MobEffects (XP-Shield)
│   ├── mixin/               # Clumps-XP optimization & Damage interception
│   ├── network/             # Architectury S2C/C2S packet networking
│   └── service/             # Attribute O(1) scaling, Kill Streaks, Advancements
├── fabric/                  # Fabric Loader entrypoints & ModMenu integration
└── neoforge/                # NeoForge entrypoints & IConfigScreenFactory

---

📚 Documentation

For exhaustive technical documentation, developer internals, mixin injection pipelines, and math references, visit our official GitHub Wiki!

---

📜 License

MIT — © 2026 Heysh1n

Made with ❤️ by Heysh1n