feat(skeleton): make ability numbers BepInEx-configurable, add fire VFX toggle

Adds SkeletonConfig.cs, following the established per-race pattern: one
Configuration Manager section per topic (Passive Combat, Fire Aura,
Resurrection). No keybinds section - every Skeleton ability is passive,
triggered by tier and combat events rather than a key press. Defaults
match the previous hardcoded constants exactly.

The per-tier progression table itself (max health bonus, lifesteal
percent, max summons) stays untouched, same boundary drawn for every
other race's progression table.

Also adds a client-side "Head Fire VFX Enabled" toggle under a new
Skeleton - Visuals section, gating both places the burning-skull effect
is triggered (SkeletonRace for the local player, ZdoVisualSync for every
other skeleton-race player this client renders) - disabling it stops the
flame rendering for this client only, without changing what other
players see.

Config sections stay bound alphabetically by race (Aswid, Draugh,
Dvergar, Fenrir, Furling, Skadi, Skeleton) in RacesOfValheim.Awake().
This commit is contained in:
kanym 2026-08-06 15:11:39 +02:00
commit 0a3f82e955
6 changed files with 90 additions and 14 deletions

View file

@ -0,0 +1,76 @@
using BepInEx.Configuration;
namespace RacesOfValheim
{
/// <summary>
/// Every tunable number behind the Skeleton's abilities, bound as BepInEx ConfigEntry so they
/// show up in Configuration Manager without touching code - see
/// CONFIGURATION-MANAGER-HOWTO.md. Bound once, from RacesOfValheim.Awake(). One section per
/// topic (matches the other races' layout).
///
/// No keybinds section: every Skeleton ability is passive, triggered by tier and combat events
/// rather than a key press.
///
/// The per-tier progression table itself (SkeletonProgression.GetRules: max health bonus,
/// lifesteal percent per tier, max summons) is left as-is, same boundary drawn for every other
/// race's progression table - not exposed here. Only the flat ability numbers a tier's boolean
/// flag switches on are configurable.
///
/// One caveat: Enhanced Regen Health Multiplier is read into SE_SkeletonStats.RebuildForState,
/// which only re-reads it when the player's progression state changes (it short-circuits if
/// the state matches what it last built for). Retuning that one value mid-session at an
/// already-reached tier needs a relog (or reaching a new tier) to take effect. Everything else
/// here reads live on every use.
/// </summary>
public static class SkeletonConfig
{
// ─── Passive combat ──────────────────────────────────────────────────
public static ConfigEntry<float> AutoStunCooldown;
public static ConfigEntry<float> AutoStunStaggerMultiplier;
public static ConfigEntry<float> PoisonAttackBonus;
public static ConfigEntry<float> EnhancedRegenHealthMultiplier;
public static ConfigEntry<float> EnhancedRegenTickSpeedBonus;
// ─── Fire Aura (tier 5+) ───────────────────────────────────────────────
public static ConfigEntry<float> FireAuraRadius;
public static ConfigEntry<float> FireAuraDamagePerTick;
public static ConfigEntry<float> FireAuraTickInterval;
// ─── Resurrection (tier 6+) ────────────────────────────────────────────
public static ConfigEntry<float> ResurrectionCooldown;
// ─── Visuals ───────────────────────────────────────────────────────────
public static ConfigEntry<bool> HeadFireVFXEnabled;
public static void Bind(ConfigFile config)
{
const string combat = "Skeleton - Passive Combat";
AutoStunCooldown = config.Bind(combat, "Auto Stun Cooldown", 5f,
new ConfigDescription("Seconds between forced staggers on the enemy hit, tier 3+.", new AcceptableValueRange<float>(0f, 60f)));
AutoStunStaggerMultiplier = config.Bind(combat, "Auto Stun Stagger Multiplier", 100f,
new ConfigDescription("Stagger multiplier applied to force the stagger through.", new AcceptableValueRange<float>(1f, 500f)));
PoisonAttackBonus = config.Bind(combat, "Poison Attack Bonus", 20f,
new ConfigDescription("Flat poison damage added to every hit the player lands, tier 4+.", new AcceptableValueRange<float>(0f, 100f)));
EnhancedRegenHealthMultiplier = config.Bind(combat, "Enhanced Regen Health Multiplier", 1.5f,
new ConfigDescription("Health regeneration multiplier, tier 5+.", new AcceptableValueRange<float>(1f, 5f)));
EnhancedRegenTickSpeedBonus = config.Bind(combat, "Enhanced Regen Tick Speed Bonus", 0.25f,
new ConfigDescription("Extra speed at which the regen timer accumulates, tier 5+ (0.25 = 25% faster ticks).", new AcceptableValueRange<float>(0f, 2f)));
const string aura = "Skeleton - Fire Aura";
FireAuraRadius = config.Bind(aura, "Radius", 5f,
new ConfigDescription("Meters from the player that the tier 5+ aura damages.", new AcceptableValueRange<float>(1f, 20f)));
FireAuraDamagePerTick = config.Bind(aura, "Damage Per Tick", 30f,
new ConfigDescription("Fire damage dealt to every enemy in range, once per tick.", new AcceptableValueRange<float>(0f, 100f)));
FireAuraTickInterval = config.Bind(aura, "Tick Interval", 1f,
new ConfigDescription("Seconds between aura damage ticks.", new AcceptableValueRange<float>(0.1f, 5f)));
const string resurrection = "Skeleton - Resurrection";
ResurrectionCooldown = config.Bind(resurrection, "Cooldown", 300f,
new ConfigDescription("Seconds between auto-resurrections, tier 6+.", new AcceptableValueRange<float>(0f, 3600f)));
const string visuals = "Skeleton - Visuals";
HeadFireVFXEnabled = config.Bind(visuals, "Head Fire VFX Enabled", true,
new ConfigDescription("Whether the burning-skull effect (worn from tier 5+) renders at all. A client-side preference: disabling it stops you from seeing it on yourself and on every other skeleton you look at, but does not change what other players see."));
}
}
}

View file

@ -594,16 +594,16 @@ namespace RacesOfValheim
if (attacker != null && attacker == Player.m_localPlayer && SkeletonRace.IsSkeleton())
{
// Auto Stun
if (rules.AutoStunFirstHit && Time.time - lastStunTime > 5f)
if (rules.AutoStunFirstHit && Time.time - lastStunTime > SkeletonConfig.AutoStunCooldown.Value)
{
hit.m_staggerMultiplier = 100f; // Force stagger
hit.m_staggerMultiplier = SkeletonConfig.AutoStunStaggerMultiplier.Value; // Force stagger
lastStunTime = Time.time;
}
// Poison Attacks
if (rules.PoisonAttacks)
{
hit.m_damage.m_poison += 20f; // Add flat 20 poison damage
hit.m_damage.m_poison += SkeletonConfig.PoisonAttackBonus.Value;
}
// Lifesteal

View file

@ -431,18 +431,17 @@ namespace RacesOfValheim
// rate, which is the player's own field.
if (rules.EnhancedRegen)
{
// Speed up regen ticks by 20% (1.25x faster timer accumulation)
float currentTimer = HarmonyLib.Traverse.Create(Player.m_localPlayer).Field<float>("m_foodRegenTimer").Value;
HarmonyLib.Traverse.Create(Player.m_localPlayer).Field("m_foodRegenTimer").SetValue(currentTimer + Time.deltaTime * 0.25f);
HarmonyLib.Traverse.Create(Player.m_localPlayer).Field("m_foodRegenTimer").SetValue(currentTimer + Time.deltaTime * SkeletonConfig.EnhancedRegenTickSpeedBonus.Value);
}
// Flames on the skull, worn with the fire-tier model and nothing else.
headFlame.Apply(Player.m_localPlayer, rules.ModelPrefab == SkeletonProgression.FireModel);
headFlame.Apply(Player.m_localPlayer, SkeletonConfig.HeadFireVFXEnabled.Value && rules.ModelPrefab == SkeletonProgression.FireModel);
if (rules.FireAura)
{
EnsureFireAuraVFX(true);
if (Time.time - lastAuraTime >= 1f)
if (Time.time - lastAuraTime >= SkeletonConfig.FireAuraTickInterval.Value)
{
ApplyFireAura();
lastAuraTime = Time.time;
@ -551,10 +550,10 @@ namespace RacesOfValheim
if (Player.m_localPlayer == null) return;
Vector3 center = Player.m_localPlayer.transform.position;
float radius = 5f;
float radius = SkeletonConfig.FireAuraRadius.Value;
HitData hitData = new HitData();
hitData.m_damage.m_fire = 30f; // 30 fire damage per second
hitData.m_damage.m_fire = SkeletonConfig.FireAuraDamagePerTick.Value;
hitData.SetAttacker(Player.m_localPlayer);
hitData.m_dir = Vector3.zero;

View file

@ -39,7 +39,7 @@ namespace RacesOfValheim
// template: SEMan.AddStatusEffect clones what it is given and adds the clone, so
// anything written to the template afterwards reaches nobody. That is why the Moder
// regeneration bonus never applied either.
m_healthRegenMultiplier = rules.EnhancedRegen ? 1.5f : 1.0f;
m_healthRegenMultiplier = rules.EnhancedRegen ? SkeletonConfig.EnhancedRegenHealthMultiplier.Value : 1.0f;
m_mods = new List<HitData.DamageModPair>
{
@ -62,9 +62,9 @@ namespace RacesOfValheim
base.Setup(character);
m_name = "Resurrection Cooldown";
m_tooltip = "Your skeletal body is too weak to resurrect again right now.";
m_icon = Jotunn.Managers.PrefabManager.Cache.GetPrefab<GameObject>("TrophySkeletonPoison")?.GetComponent<ItemDrop>()?.m_itemData.GetIcon()
m_icon = Jotunn.Managers.PrefabManager.Cache.GetPrefab<GameObject>("TrophySkeletonPoison")?.GetComponent<ItemDrop>()?.m_itemData.GetIcon()
?? Jotunn.Managers.PrefabManager.Cache.GetPrefab<GameObject>("TrophySkeleton")?.GetComponent<ItemDrop>()?.m_itemData.GetIcon();
m_ttl = 300f; // 5 minutes
m_ttl = SkeletonConfig.ResurrectionCooldown.Value;
}
}
}