RacesOfValheim/JotunnModStub/Package/README.md
kanym c76341af0d feat(aswid): running water covers rivers and lakes; sway on boats
Open water now means any water: swimming in it, or flying over a metre
or more of it, sea, river or lake. Standing on anything solid stays safe,
so docks, bridges and wading do not count. On a boat there is still no
burn or drain, but the camera keeps swaying. 'Ocean Only' restores the
sea-only behaviour, and the settings say Open Water instead of Open Sea.

Also rewrites the README's per-boss Aswid section from the code: it
listed stats, unlocks and an aura that no longer exist.
2026-10-26 15:49:05 +01:00

114 lines
8.4 KiB
Markdown

# RacesOfValheim
A comprehensive Valheim mod that allows you to play as different unique races, each offering distinct mechanics, visual transformations, and a deep progression system tailored to your journey in Valheim.
## Features
This mod currently introduces 4 custom races:
### 1. Skeleton
- **Stamina-less Combat**: Skeletons do not consume stamina and do not use the stamina bar.
- **Undead Diet**: You cannot eat standard food. Instead, you gain maximum health automatically as you defeat Valheim's bosses to compensate for the lack of food buffs.
### 2. Skadi
- **Ice Affinity**: Gain unique resistance and affinity to the cold.
### 3. Fenrir
- **Beast Form**: Transform into a powerful wolf-like beast.
- **Cultist Form**: Transform into a Cultist to wield fire abilities.
- **Progression**: The beast and cultist forms evolve as you defeat Valheim's bosses, granting new abilities, cooldown reductions, and power scaling. Immune to fall damage in both forms.
### 4. Aswid
- **The Vampire**: A creature of the night with powerful life-draining abilities.
- **Bat Transformation**: Press `G` to transform into a bat. It flies where you look, like the Skadi's drake: W beats forward, Shift sprints, S beats backwards, and both cost stamina. Out of stamina you can only glide.
- **Vampiric Aura**: Always on (toggle with [I]): drains the life of nearby enemies, with a doubled radius at night. Silent in Bat form until The Queen falls (configurable).
- **Blood Magic Mastery**: You can cast Blood Magic items with infinite Eitr, relying purely on their health costs.
- **Night Prowler**: Your passive speed and jump bonuses double during the night.
- **Undead Vigor**: The Aswid has a large stamina pool that grows with every boss, on top of its food. You consume the lifeforce of fallen foes directly instead of eating standard food.
- **The Curse's Price**: By day under open sky the sun slows you, weakens your regeneration and burns you down to 30% health; a roof, a dungeon, the Swamp, the Mistlands, the night or your Eclipse shield you. You also take 25% more fire damage (until Fader) and 20% more pierce damage. Running water rejects you: swimming costs double stamina, and open water (sea, river or lake) burns you while you swim in it or fly over it, unless a boat carries you. Every weakness can be switched off in the config.
## Installation (manual)
1. Install BepInExPack Valheim.
2. Install Jotunn.
3. Extract the contents of this mod into your `BepInEx/plugins` folder.
## Changelog
**v1.0.0**
- Initial release with 4 distinct races.
- Added Aswid life-draining and night transformations.
- Complete progression system tied to Valheim's bosses.
**v1.1.0**
- **Aswid**: Passive abilities (Speed and Jump) are now properly doubled during the night.
- **Aswid**: New Enslavement Power (Yagluth tier)! Press E on non-tameable, non-boss enemies to enslave them for 60 seconds (15-min cooldown). Enslaved thralls fight alongside you and drop standard loot.
- **Aswid**: Edible thralls are automatically consumed upon death, granting you their lifeforce (Fader tier).
- **Aswid**: Complete overhaul of the Food system. Added Mistlands and Ashlands creatures to the consumption map. Accurately scaled food stats based on creature health.
- **Aswid**: Excluded undead and inorganic creatures (Skeletons, Draugrs, Golems, etc.) from being edible.
- **Aswid**: Added a dynamic green light effect to all forms (Bonemass tier).
**v1.2.0**
- **Multiplayer Sync**: Fully implemented visual syncing for Aswid forms (Bat, Mist) and Skadi forms (Bear, Wolf, Hatchling, Fader) so other players can see your transformations in multiplayer!
- **Aswid**: Scrapped the Fader (Surtling) visual override; reaching the final progression state now makes the player 10% taller and adds a flat +30 physical damage bonus.
- **Aswid**: Defeating enemies with physical attacks in the final state now automatically consumes them if you have food slots available.
- **General**: Eradicated remaining localizations of the old "Strigoi" name.
**v1.3.0**
- **Progression Fix**: Fixed a massive bug where boss progression states were misaligned. Players no longer receive Eikthyr or higher-tier powers immediately upon starting a new game (State 1). All unlocks now perfectly match the corresponding boss defeat global keys.
- **Furling**: Fine-tuned the custom 3D Goblin Head trophy alignment and scaling. It now fits perfectly inside the player's skull, revealing only the goblin ears!
- **Documentation**: Added complete level-by-level progression lists to the README for all races.
**v1.3.2**
- **Aswid**: Refined the Aswid's diet. Excluded undead/inorganic Ashlands creatures (Charred, Morgen).
- **Aswid**: Added a 4th stomach slot exclusively for Aswid prey!
- **Aswid**: Added a keybind (I) to toggle the automatic devour on/off.
**v1.3.3**
- **Aswid**: Fixed a bug where devouring a mob would fail if the player was still in an attack or movement animation.
- **Aswid**: Added a passive lifesteal scaling mechanic! You now heal for 2% of the physical damage dealt per boss defeated (up to 14% at endgame). This amount is doubled during the night!
## Race Progressions (Level-by-Level)
### Aswid Progression
- **Base (No Bosses)**: Physical kills devour edible enemies, feeding you their blood (Vae Victis). Per boss defeated: +1 Armor, +2 physical damage, +1% Speed and Jump, +2% Lifesteal on physical hits, all doubled at night. +25 Maximum Stamina, plus 10 per boss. Blood Magic items cast with infinite Eitr. Vampiric Aura (toggle with I). Claws of the Beast. Weaknesses: sunlight, fire, pierce and running water (see above).
- **Eikthyr**: Bat Form (G Key, night only), flown on stamina. Tame boars (U Key).
- **The Elder**: Bat Form by day as well as night.
- **Bonemass**: No new power; the per-boss stats keep growing.
- **Moder**: Freezing Blood (immune to Freezing and Poison). Superhuman Senses (marks untamed creatures within 100m). Tame wolves.
- **Yagluth**: Eclipse (J Key, forces night around you for 60s, 15-minute cooldown). Dominate (Interact key, a non-boss enemy fights for you for 60s). Tame lox.
- **The Queen**: Mist Form (H Key: immune to physical and poison damage, double aura damage, breaks at sunrise). The Vampiric Aura works in Bat Form.
- **Fader**: Asmund: 10% taller, +30 damage on every attack. The fire weakness ends. Tame asksvin.
### Skadi Progression
- **Base (No Bosses)**: Immune to Cold, Bonus Frost Damage, 50% Frost Resistance.
- **Eikthyr**: +20% Eitr Regen, Freezing to Cold (mountains act as normal cold), Cold Spell.
- **The Elder**: Drake Form (Cannot attack).
- **Bonemass**: Drake Form (Can attack).
- **Moder**: Moder Form (1 min duration, 10 min cooldown).
- **Yagluth**: Improved Cold Spell. Moder Form (1 min duration, 5 min cooldown).
- **The Queen**: Moder Form (Unlimited duration, no cooldown).
- **Fader**: Skeleton Dragon Form.
### Skeleton Progression
- **Base (No Bosses)**: +50 Max Health. Undead Diet (Cannot eat mortal food, no stamina bar).
- **Eikthyr**: Poison Skeleton Model, Poison Immunity, 5% Lifesteal, +80 Max Health.
- **The Elder**: 10% Lifesteal, Auto-Stun on First Hit, +110 Max Health.
- **Bonemass**: 15% Lifesteal, Poison Attacks, +140 Max Health.
- **Moder**: Fire Skeleton Model, 20% Lifesteal, Fire Aura, Enhanced Regen, +170 Max Health.
- **Yagluth**: 25% Lifesteal, Auto Resurrect, +200 Max Health.
- **The Queen**: 30% Lifesteal, Summon on Kill (Max 3 Skeletons), +230 Max Health.
- **Fader**: 35% Lifesteal, Max 5 Summons, +275 Max Health.
### Fenrir Progression
- **Base (No Bosses)**: Progressive stats (+3 Armor, +5 Damage, -10% Fall Damage, +3% Speed, +3% Jump per boss killed).
- **The Elder**: Wolf Form (Night).
- **Bonemass**: Wolf Form (Day/Night). Ulv Form (Night).
- **Moder**: Ulv Form (Day/Night). Fenring Form (Night).
- **Yagluth**: Cultist Form (Night - 1 min duration, 10 min cooldown).
- **The Queen**: Fenring Form (Day/Night). Cultist Form (Night - 1 min duration, 5 min cooldown).
- **Fader**: Cultist Form (Day/Night).
### Furling Progression
- **Eikthyr**: Master of Shadows (Bonus attack damage when in the dark or at night).
- **The Elder**: The Wickerman (-50% Fire and Poison damage, increased to -90% if it's from an arrow).
- **Bonemass**: Dance of the Dead (Ignore certain crafting costs).
- **Moder**: The Man/Woman on the Silver Mountain (Doubles normal enemy trophy drops, yields gold coins based on stars within 25 meters, and doubles mined raw ore yield).
- **Yagluth**: The King is Dead, Hail to the King/Queen (In the Plains biome, the 2x XP multiplier is extended to all non-combat skills).