feat(alfar): v1.6.0 - the Alfar, an eleventh race

Grey, tall and thin, with black eyes. Eitr is armour and fuel (shield,
diet, soft fall, levitation), Heimkall sends a lethal blow home at one
health every 20 minutes. Caster powers from Skrid to the archon
Sameining, with on-screen cooldowns. Automated base around the
Ljoskjarne: drones, three constructs, crystals, Ljosgard, Prismavard.
Compendium page in EN/IT/RU.

README: New in block, race section, progression, station line, changelog.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Ferdinando 2026-10-25 17:38:28 +01:00
commit 3f8cf1ee27
48 changed files with 7779 additions and 16 deletions

View file

@ -0,0 +1,170 @@
using BepInEx.Configuration;
using UnityEngine;
namespace RacesOfValheim
{
/// <summary>
/// The numbers and the keys of the Alfar's powers (Alfar_Progettazione.txt sec. 13 and 19.6).
/// Every value is a STARTING value to be corrected in play. Nothing numeric lives in the logic.
///
/// Keys follow the mod's habit: letters the other races also use (G, H, I, J, K, O, U), because a
/// character has exactly one race, so the same letter never means two things at once.
/// </summary>
public static class AlfarPowerConfig
{
// Progression states a power unlocks at (BossProgressionManager: 2 Eikthyr ... 8 Fader).
public const int SkridState = 2;
public const int GrafvaettirState = 2;
public const int UtsogState = 3;
public const int KallState = 4;
public const int LjosstormState = 5;
public const int GeisliState = 6;
public const int KyrrState = 7;
public const int SameiningState = 8;
// ─── Keys ────────────────────────────────────────────────────────────
public static ConfigEntry<KeyboardShortcut> SkridKey;
public static ConfigEntry<KeyboardShortcut> GrafvaettirKey;
public static ConfigEntry<KeyboardShortcut> KallKey;
public static ConfigEntry<KeyboardShortcut> LjosstormKey;
public static ConfigEntry<KeyboardShortcut> GeisliKey;
public static ConfigEntry<KeyboardShortcut> KyrrKey;
public static ConfigEntry<KeyboardShortcut> SameiningKey;
// ─── Skrid: the blink ────────────────────────────────────────────────
public static ConfigEntry<float> SkridDistance;
public static ConfigEntry<float> SkridCost;
public static ConfigEntry<float> SkridCooldown;
// ─── Utsog: damage dealt comes back as eitr ──────────────────────────
public static ConfigEntry<float> UtsogPercent;
// ─── Kall: telekinesis ───────────────────────────────────────────────
public static ConfigEntry<float> KallRadius;
public static ConfigEntry<float> KallSpeed;
public static ConfigEntry<float> KallCost;
public static ConfigEntry<float> KallCooldown;
// ─── Ljosstorm: the psionic storm ────────────────────────────────────
public static ConfigEntry<float> StormRange;
public static ConfigEntry<float> StormRadius;
public static ConfigEntry<float> StormSeconds;
public static ConfigEntry<float> StormDps;
public static ConfigEntry<float> StormCost;
public static ConfigEntry<float> StormCooldown;
// ─── Geisli: the beam ────────────────────────────────────────────────
public static ConfigEntry<float> BeamRange;
public static ConfigEntry<float> BeamDps;
public static ConfigEntry<float> BeamCostPerSecond;
public static ConfigEntry<float> BeamMaxSeconds;
public static ConfigEntry<float> BeamCooldown;
// ─── Kyrr: stasis ────────────────────────────────────────────────────
public static ConfigEntry<float> StasisRange;
public static ConfigEntry<float> StasisSeconds;
public static ConfigEntry<float> StasisBossSeconds;
public static ConfigEntry<float> StasisCost;
public static ConfigEntry<float> StasisCooldown;
// ─── Sameining: the archon ───────────────────────────────────────────
public static ConfigEntry<float> ArchonThreshold;
public static ConfigEntry<float> ArchonSeconds;
public static ConfigEntry<float> ArchonScale;
public static ConfigEntry<float> ArchonSpeedBonus;
public static ConfigEntry<float> ArchonPoolPerEitr;
public static ConfigEntry<float> ArchonPulseRadius;
public static ConfigEntry<float> ArchonPulseDamage;
public static ConfigEntry<float> ArchonPulseInterval;
public static ConfigEntry<float> ArchonFreePowerCooldown;
public static ConfigEntry<Color> ArchonColor;
// ─── Grafvaettir: the mining grenade ─────────────────────────────────
public static ConfigEntry<float> GrafRange;
public static ConfigEntry<float> GrafRadius;
public static ConfigEntry<float> GrafSeconds;
public static ConfigEntry<int> GrafCount;
public static ConfigEntry<float> GrafEitr;
public static ConfigEntry<int> GrafStone;
public static ConfigEntry<int> GrafFlint;
public static ConfigEntry<float> GrafCooldown;
// ─── Levitation ──────────────────────────────────────────────────────
public static ConfigEntry<float> LevitationRise;
public static ConfigEntry<float> LevitationCostPerSecond;
public static void Bind(ConfigFile config)
{
const string keys = "Alfar - Keybinds";
SkridKey = config.Bind(keys, "Skrid (Blink)", new KeyboardShortcut(KeyCode.G));
GrafvaettirKey = config.Bind(keys, "Grafvaettir (Mining Drones)", new KeyboardShortcut(KeyCode.H));
KallKey = config.Bind(keys, "Kall (Telekinesis)", new KeyboardShortcut(KeyCode.J));
LjosstormKey = config.Bind(keys, "Ljosstorm (Psionic Storm)", new KeyboardShortcut(KeyCode.K));
GeisliKey = config.Bind(keys, "Geisli (Beam, hold)", new KeyboardShortcut(KeyCode.O));
KyrrKey = config.Bind(keys, "Kyrr (Stasis)", new KeyboardShortcut(KeyCode.U));
SameiningKey = config.Bind(keys, "Sameining (Archon)", new KeyboardShortcut(KeyCode.I));
const string skrid = "Alfar - Skrid";
SkridDistance = config.Bind(skrid, "Distance", 8f, new ConfigDescription("Blink length in metres.", new AcceptableValueRange<float>(1f, 30f)));
SkridCost = config.Bind(skrid, "Eitr Cost", 10f, new ConfigDescription("Eitr spent per blink.", new AcceptableValueRange<float>(0f, 200f)));
SkridCooldown = config.Bind(skrid, "Cooldown", 3f, new ConfigDescription("Seconds between blinks.", new AcceptableValueRange<float>(0f, 120f)));
const string utsog = "Alfar - Utsog";
UtsogPercent = config.Bind(utsog, "Return Percent", 15f, new ConfigDescription("Percent of the damage you deal that comes back as eitr.", new AcceptableValueRange<float>(0f, 100f)));
const string kall = "Alfar - Kall";
KallRadius = config.Bind(kall, "Radius", 15f, new ConfigDescription("Metres around you whose dropped items are pulled in.", new AcceptableValueRange<float>(1f, 60f)));
KallSpeed = config.Bind(kall, "Pull Speed", 12f, new ConfigDescription("Speed items fly toward you, in metres per second.", new AcceptableValueRange<float>(1f, 40f)));
KallCost = config.Bind(kall, "Eitr Cost", 5f, new ConfigDescription("Eitr spent per pull.", new AcceptableValueRange<float>(0f, 200f)));
KallCooldown = config.Bind(kall, "Cooldown", 2f, new ConfigDescription("Seconds between pulls.", new AcceptableValueRange<float>(0f, 120f)));
const string storm = "Alfar - Ljosstorm";
StormRange = config.Bind(storm, "Range", 30f, new ConfigDescription("How far you can place the storm.", new AcceptableValueRange<float>(5f, 80f)));
StormRadius = config.Bind(storm, "Radius", 6f, new ConfigDescription("Radius of the storm in metres.", new AcceptableValueRange<float>(1f, 30f)));
StormSeconds = config.Bind(storm, "Duration", 6f, new ConfigDescription("Seconds the storm lasts.", new AcceptableValueRange<float>(1f, 60f)));
StormDps = config.Bind(storm, "Damage Per Second", 20f, new ConfigDescription("Lightning damage per second to each enemy inside.", new AcceptableValueRange<float>(1f, 500f)));
StormCost = config.Bind(storm, "Eitr Cost", 40f, new ConfigDescription("Eitr spent per cast.", new AcceptableValueRange<float>(0f, 400f)));
StormCooldown = config.Bind(storm, "Cooldown", 20f, new ConfigDescription("Seconds between casts.", new AcceptableValueRange<float>(0f, 300f)));
const string beam = "Alfar - Geisli";
BeamRange = config.Bind(beam, "Range", 30f, new ConfigDescription("Beam length in metres.", new AcceptableValueRange<float>(5f, 80f)));
BeamDps = config.Bind(beam, "Damage Per Second", 35f, new ConfigDescription("Lightning damage per second to the target.", new AcceptableValueRange<float>(1f, 500f)));
BeamCostPerSecond = config.Bind(beam, "Eitr Per Second", 8f, new ConfigDescription("Eitr burned each second the beam is held.", new AcceptableValueRange<float>(0f, 100f)));
BeamMaxSeconds = config.Bind(beam, "Max Continuous Seconds", 8f, new ConfigDescription("The beam cuts off after this long.", new AcceptableValueRange<float>(1f, 60f)));
BeamCooldown = config.Bind(beam, "Cooldown After Release", 2f, new ConfigDescription("Seconds before the beam can start again.", new AcceptableValueRange<float>(0f, 60f)));
const string stasis = "Alfar - Kyrr";
StasisRange = config.Bind(stasis, "Range", 25f, new ConfigDescription("How far the stasis reaches.", new AcceptableValueRange<float>(5f, 80f)));
StasisSeconds = config.Bind(stasis, "Seconds", 4f, new ConfigDescription("How long an ordinary enemy is held.", new AcceptableValueRange<float>(0.5f, 30f)));
StasisBossSeconds = config.Bind(stasis, "Boss Seconds", 1.5f, new ConfigDescription("How long a boss is held.", new AcceptableValueRange<float>(0.5f, 30f)));
StasisCost = config.Bind(stasis, "Eitr Cost", 50f, new ConfigDescription("Eitr spent per cast.", new AcceptableValueRange<float>(0f, 400f)));
StasisCooldown = config.Bind(stasis, "Cooldown", 45f, new ConfigDescription("Seconds between casts.", new AcceptableValueRange<float>(0f, 600f)));
const string archon = "Alfar - Sameining";
ArchonThreshold = config.Bind(archon, "Activation Threshold", 0.75f, new ConfigDescription("Fraction of the maximum eitr needed to begin. All of it is spent.", new AcceptableValueRange<float>(0f, 1f)));
ArchonSeconds = config.Bind(archon, "Duration", 180f, new ConfigDescription("Seconds the form lasts at most.", new AcceptableValueRange<float>(5f, 900f)));
ArchonScale = config.Bind(archon, "Scale", 1.5f, new ConfigDescription("Body size multiplier in the form.", new AcceptableValueRange<float>(1f, 3f)));
ArchonSpeedBonus = config.Bind(archon, "Speed Bonus", 0.2f, new ConfigDescription("Movement speed bonus in the form (0.2 = +20%).", new AcceptableValueRange<float>(0f, 1f)));
ArchonPoolPerEitr = config.Bind(archon, "Pool Per Eitr", 3f, new ConfigDescription("Points of protection per point of eitr spent to enter.", new AcceptableValueRange<float>(0.1f, 20f)));
ArchonPulseRadius = config.Bind(archon, "Pulse Radius", 4f, new ConfigDescription("Radius of the psionic pulse around you.", new AcceptableValueRange<float>(1f, 20f)));
ArchonPulseDamage = config.Bind(archon, "Pulse Damage", 60f, new ConfigDescription("Lightning damage of each pulse.", new AcceptableValueRange<float>(1f, 1000f)));
ArchonPulseInterval = config.Bind(archon, "Pulse Interval", 1f, new ConfigDescription("Seconds between pulses.", new AcceptableValueRange<float>(0.2f, 10f)));
ArchonFreePowerCooldown = config.Bind(archon, "Free Power Cooldown", 5f, new ConfigDescription("In the form, Ljosstorm and Geisli cost no eitr but wait this long.", new AcceptableValueRange<float>(0f, 60f)));
ArchonColor = config.Bind(archon, "Glow Color", new Color(0.55f, 0.85f, 1f, 1f), new ConfigDescription("Skin and light colour while in the form."));
const string graf = "Alfar - Grafvaettir";
GrafRange = config.Bind(graf, "Throw Range", 25f, new ConfigDescription("How far the drones can be thrown.", new AcceptableValueRange<float>(5f, 80f)));
GrafRadius = config.Bind(graf, "Dig Radius", 12f, new ConfigDescription("Radius around the landing point where they dig.", new AcceptableValueRange<float>(2f, 60f)));
GrafSeconds = config.Bind(graf, "Duration", 120f, new ConfigDescription("Seconds the drones dig before vanishing.", new AcceptableValueRange<float>(5f, 900f)));
GrafCount = config.Bind(graf, "Drones Per Throw", 5, new ConfigDescription("How many mining drones one throw makes.", new AcceptableValueRange<int>(1, 30)));
GrafEitr = config.Bind(graf, "Eitr Cost", 25f, new ConfigDescription("Eitr spent per throw.", new AcceptableValueRange<float>(0f, 400f)));
GrafStone = config.Bind(graf, "Stone Cost", 10, new ConfigDescription("Stone spent per throw.", new AcceptableValueRange<int>(0, 200)));
GrafFlint = config.Bind(graf, "Flint Cost", 5, new ConfigDescription("Flint spent per throw.", new AcceptableValueRange<int>(0, 200)));
GrafCooldown = config.Bind(graf, "Cooldown", 300f, new ConfigDescription("Seconds between throws; keep it well above the duration or they are permanent.", new AcceptableValueRange<float>(0f, 3600f)));
const string lev = "Alfar - Levitation";
LevitationRise = config.Bind(lev, "Rise Speed", 2f, new ConfigDescription("Climb speed (m/s) while the jump key is held in the air.", new AcceptableValueRange<float>(0.2f, 10f)));
LevitationCostPerSecond = config.Bind(lev, "Eitr Per Second", 2f, new ConfigDescription("Eitr burned each second of levitation.", new AcceptableValueRange<float>(0f, 50f)));
}
}
}