Elemental Ascendance

ELEMENTAL ASCENDANCE: THE OFFICIAL ARCHMAGE HANDBOOK A Comprehensive Guide to Elemental Mastery, Ancient Shrines, and Divine Ascension Minecraft Forge 1.20.1

TABLE OF CONTENTS

1. INTRODUCTION AND LORE

2. GETTING STARTED: YOUR FIRST STEPS

3. THE MANA AND MASTERY ENGINE

4. IN-DEPTH ELEMENT ARCHETYPES AND ABILITIES

5. THE DUAL AFFINITY AND HOT-SWAPPING SYSTEM

6. SACRED SHRINES, BIOME EXPANSES, AND AWAKENING ALTARS

7. ELEMENTAL GAUNTLETS AND GEAR

8. KEYBINDINGS AND COMBAT CONTROLS

9. ADMIN COMMANDS AND CONFIGURATION

10. DEPENDENCIES AND INSTALLATION

11. INTRODUCTION AND LORE

Since the dawn of the Overworld, raw cosmic power has flowed through eight primordial leylines: Fire, Water, Thunder, Earth, Wind, Ice, Light, and Shadow. Over centuries, these energies crystallized into sacred shrines erected in the most pristine corners of the earth.

Elemental Ascendance transforms Minecraft survival into a deep action-RPG experience. You no longer merely survive the night; you attune to cosmic elements, weave offensive and defensive spells, unlock divine god forms, and combine two elements simultaneously to forge your own legendary fighting style.

1. GETTING STARTED: YOUR FIRST STEPS

Step 1: Exploration Travel across the land to discover an ancient Elemental Shrine. Each element chooses its resting ground based on the climate of the world:

• Oceans conceal the Water Shrine.
• Deserts and Badlands shelter the Fire Shrine.
• Extreme Mountain Peaks conduct the Thunder Shrine.
• Dense Jungles and Swamps anchor the Earth Shrine.
• High Plains and Windswept Hills harbor the Wind Shrine.
• Frozen Peaks and Snowy Plains preserve the Ice Shrine.
• Sunlit Meadows embrace the Light Shrine.
• Deep Dark caves and volcanic caverns shroud the Shadow Shrine.

Step 2: Commune With the Altar At the heart of every shrine rests an Awakening Altar. Right-click the Altar with an empty hand to attune your soul to that shrine's element. Your mana bar will manifest on your HUD, and your primary elemental path begins.

Step 3: Earn Mastery and Unlock Abilities Combat, spellcasting, and defeating hostile monsters generate Elemental Mastery. Open your Skill Tree (default key: K) to spend mastery points on active spells, passive buffs, and mana capacity upgrades.

Step 4: Awaken Your Secondary Element Once you reach high mastery in your primary element, seek out a second shrine of a different element. Communing with its altar will automatically place that element into your Secondary Slot without wiping your hard-earned progress.

1. THE MANA AND MASTERY ENGINE

Mana Pool Dynamics Every ability consumes mana. Your current mana pool is displayed cleanly above your health and hunger bars:

• Base Mana: Begins at 100 and scales up to 1000 or more as you advance through the skill tree.
• Passive Regeneration: Mana naturally regenerates over time. Standing inside your attuned element's native environment (such as standing in water for Water mages, or exposed to sun for Light mages) accelerates your regeneration speed.
• Exhaustion State: Completely emptying your mana pool inflicts a brief exhaustion debuff, making spell timing and mana conservation crucial during high-intensity boss encounters.

Mastery Points and the Skill Tree (Default Key: K) Pressing K opens an interactive celestial skill tree. Nodes grant:

• Active Ability Slots: Ability 1, Ability 2, Ability 3, and Ultimate.
• Cooldown Reduction: Shortens the recast timer of your spells.
• Mana Efficiency: Reduces the mana cost per spellcast.
• Potency: Amplifies damage, explosion radius, knockback, and effect duration.
• Passive Auras: Grants passive resistances matching your attuned element.

1. IN-DEPTH ELEMENT ARCHETYPES AND ABILITIES

Each of the eight elements features a complete set of active abilities, custom particle effects, and animations:

ELEMENT 1: FIRE (THE INFERNAL WRATH)

• Core Theme: High burst damage, lingering burn damage, explosive mobility.
• Ability 1 (Offense): Fireball. Launches an explosive pyrotechnic projectile that detonates on impact and sets nearby targets ablaze.
• Ability 2 (Defense / Utility): Flame Shield. Surrounds the caster in an orbit of spinning fire, deflecting incoming arrows and scorching attackers.
• Ability 3 (Mobility): Flame Dash. Thrusts the player forward in a jet of pure flame, leaving an incinerating trail behind.
• Ultimate (God Form): Hellfire Eruption. Unleashes a massive volcanic explosion centered on the player, summoning pillar cascades that obliterate mob waves.

ELEMENT 2: WATER (THE TIDAL SERENITY)

• Core Theme: Battlefield control, healing, drowning pressure.
• Ability 1 (Offense): Water Jet. Fires a continuous high-pressure torrent of water that pierces through lines of enemies and pushes them back.
• Ability 2 (Defense / Utility): Aqueous Shield. Envelopes the caster in a dense hydro-bubble that absorbs incoming physical hits and cleanses negative status effects.
• Ability 3 (Mobility): Tidal Wave. Surfs upon a summoned cresting wave, traveling over land or oceans at extreme velocities.
• Ultimate (God Form): Ocean Empress Maelstrom. Summons a devastating whirlpool vortex that pulls in all surrounding hostile entities, crushing them with drowning depths.

ELEMENT 3: THUNDER (THE HEAVENLY STRIKE)

• Core Theme: Unmatched attack speed, chain lightning, instant teleportation.
• Ability 1 (Offense): Lightning Bolt. Calls down an instantaneous bolt of heavenly lightning at the crosshair location, electrocuting the target.
• Ability 2 (Defense / Utility): Static Discharge. Emits a radial shockwave that paralyzes and stuns all nearby enemies for several seconds.
• Ability 3 (Mobility): Flash Step. Instantly dissolves into electricity and reappears at the target location up to 30 blocks away in the blink of an eye.
• Ultimate (God Form): Wrath of the Thunder God. The player ascends into the air and calls down an apocalyptic thunderstorm, raining continuous lightning bolts across the battlefield.

ELEMENT 4: EARTH (THE TECTONIC BULWARK)

• Core Theme: Maximum physical defense, crowd disruption, heavy blunt force.
• Ability 1 (Offense): Earth Spike. Causes razor-sharp stone pillars to erupt sequentially out of the ground toward the enemy.
• Ability 2 (Defense / Utility): Stone Skin. Encases the player in unbreakable granite armor, massively increasing armor toughness and knockback resistance.
• Ability 3 (Mobility): Burrow Dash. Dives into the earth and surges forward beneath the ground, emerging with an earth-shattering shockwave.
• Ultimate (God Form): Tectonic Cataclysm. Slams the ground with colossal force, rupturing the earth and hurling heavy boulders at all nearby targets.

ELEMENT 5: WIND (THE AERIAL SOVEREIGN)

• Core Theme: Unrivaled air control, high evasion, projectile deflection.
• Ability 1 (Offense): Air Slash. Slices forward with compressed crescent blades of wind that shred enemy defenses.
• Ability 2 (Defense / Utility): Wind Wall. Generates a swirling vortex barrier that halts and reflects hostile projectiles.
• Ability 3 (Mobility): Gale Ascent. Launches the caster high into the sky with a sustained burst of wind, granting prolonged gliding and levitation.
• Ultimate (God Form): Skyfall Typhoon. Summons an immense tornado that sweeps mobs into the stratosphere before dropping them for devastating impact damage.

ELEMENT 6: ICE (THE FROZEN BIND)

• Core Theme: Movement speed reduction, solid freezing, shatter damage.
• Ability 1 (Offense): Frost Shard. Hurls a cluster of jagged cryo-icicles that impale targets and apply cumulative frostbite.
• Ability 2 (Defense / Utility): Glacial Wall. Instantly conjures a solid barrier of reinforced ice that obstructs enemy paths and absorbs attacks.
• Ability 3 (Mobility): Ice Slide. Freezes the ground beneath your feet, allowing you to glide frictionless at high speeds across any surface.
• Ultimate (God Form): Absolute Zero. Freezes the surrounding atmosphere solid, encasing all entities in unbreakable permafrost and shattering them for massive true damage.

ELEMENT 7: LIGHT (THE CELESTIAL RADIANCE)

• Core Theme: True damage, divine cleansing, team buffs, supreme illumination.
• Ability 1 (Offense): Solar Lance. Fires a concentrated beam of pure celestial light that ignores standard entity armor.
• Ability 2 (Defense / Utility): Divine Blessing. Restores health, grants regeneration, and burns away lingering curses for the player and nearby allies.
• Ability 3 (Mobility): Luminescent Leap. Converts the caster into a photon stream, vaulting gracefully through the air.
• Ultimate (God Form): Judgement of the Sun. Illuminates the sky with blinding golden splendor, raining celestial rays that incinerate the undead and dark entities.

ELEMENT 8: SHADOW (THE ABYSSAL REAPER)

• Core Theme: Life steal, stealth, blinding debuffs, dimension manipulation.
• Ability 1 (Offense): Shadow Claws. Rips through the fabric of space with dark tendrils that inflict wither and siphon enemy health back to the caster.
• Ability 2 (Defense / Utility): Veil of Darkness. Cloaks the player in impenetrable shadows, turning invisible to mobs and avoiding agro.
• Ability 3 (Mobility): Void Step. Melts into the shadows and emerges from the nearest shadow pocket behind an enemy.
• Ultimate (God Form): Domain of the Void. Summons an abyssal black hole dimension that drags targets into oblivion, devouring their life force.

1. THE DUAL AFFINITY AND HOT-SWAPPING SYSTEM

Dual Element Slots Your soul can hold up to two elemental masteries at once:

• Primary Slot: Your foundational element.
• Secondary Slot: Your secondary element obtained by communing with a second shrine or consuming elemental essence.

Instant Hot-Swapping (Default Key: Shift + S)

• Seamless Switching: Pressing Shift + S instantly swaps between your Primary and Secondary element.
• Zero Loss of Progress: Swapping elements preserves all your skill points, current cooldowns, and learned abilities.
• Elemental Synergies: Transition smoothly from a Water freeze into a Thunder shock, or from an Earth barrier into a Fire burst, creating fluid and lethal spell rotations.

1. SACRED SHRINES, BIOME EXPANSES, AND AWAKENING ALTARS

Dynamic Biome Expanse Sizing Shrines no longer spawn randomly or cluster together. An advanced climate expanse sampler analyzes the total geographical size of continuous biome families:

• Small Biome Pockets (Isolated lakes, small oases): 1 to 2 shrines maximum.
• Mid-Sized Biomes (Standard forests, average deserts): 3 to 4 shrines maximum.
• Large Biome Continents (Vast oceans, endless deserts, giant plains): 5 to 6 shrines maximum.

Legendary Spacing

• Same-Element Distance: Shrines of the same element generate at least 3200 blocks apart (approximately 3000 to 5000 blocks away in practice). They are sacred wonders meant to be sought after and celebrated upon discovery.
• Cross-Element Distance: Shrines of different elements maintain at least 1500 blocks of separation, preventing worldgen clutter.

1. ELEMENTAL GAUNTLETS AND GEAR

Gauntlets of Power Craft or discover sacred Elemental Gauntlets. Wearing or absorbing gauntlets empowers your elemental arts:

• Gauntlet Absorption: Absorbing a gauntlet permanently binds its hidden techniques to your soul, instantly unlocking related abilities in your skill tree.
• Stat Amplification: Increases spell projectile speed, extends flame duration, and expands aura radiuses.

1. KEYBINDINGS AND COMBAT CONTROLS

• Z Key: Cast Active Ability 1 (Offensive Spell)
• X Key: Cast Active Ability 2 (Defensive or Utility Spell)
• C Key: Cast Active Ability 3 (Mobility Spell)
• V Key: Cast Ultimate Ability (God Form Spell)
• Shift + S: Hot-swap between Primary and Secondary element
• K Key: Open the Celestial Skill Tree and Progression Menu

Note: All keybindings can be fully rebound in the standard Minecraft Options Controls menu under the Elemental Ascendance category.

1. ADMIN COMMANDS AND CONFIGURATION

For server administrators, map creators, and creative testing:

• /element set [player] [element] Sets the primary element of the specified player.

• /element set_secondary [player] [element] Sets the secondary element of the specified player without affecting the primary slot.

• /element god [player] [element] Instantly awakens God tier for the chosen element, maxing out all mastery nodes and unlocking the full ability set.

• /element mana [player] [amount] Modifies or refills the player's current mana pool.

1. DEPENDENCIES AND INSTALLATION

Required Environment:

• Minecraft Version: 1.20.1
• Mod Loader: Forge 47.2.0 or higher (or compatible NeoForge 1.20.1)

Required Dependencies:

• GeckoLib (v4.4.4 or higher for 1.20.1)
• PlayerAnimator (v1.0.2 or higher for 1.20.1)
• Curios API (v5.4.5 or higher for 1.20.1)

Installation Steps:

1. Ensure Minecraft Forge 1.20.1 is installed on your launcher.
2. Download GeckoLib, PlayerAnimator, and Curios API into your mods folder.
3. Place elementalascendance-1.0.3-1.20.1.jar into your mods folder.
4. Launch the game, discover your first shrine, and begin your ascension!