RacesOfValheim/JotunnModStub/Skeleton/SkeletonConfig.cs
kanym e972ca5ea4 feat: Skeletons can show their helmet
New "Show Helmet" option under Skeleton - Visuals, off by default. The owner's
choice is written to the ZDO, so other players see the helmet the way its owner
picked.

On a skull the helmet moves up and back and grows to fit, since the skull is
bigger than the viking head the helmet hangs for. Hoods and the other skinned
helmets can't be moved by their transform: their Head bone is swapped for a
fitted child bone, so the head part follows the skull and the shoulder parts
stay put. A viking body gets the vanilla placement and bones back.
2026-10-29 01:08:07 +01:00

93 lines
7.2 KiB
C#

using BepInEx.Configuration;
using UnityEngine;
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;
// ─── Keybinds ──────────────────────────────────────────────────────────
public static ConfigEntry<KeyboardShortcut> SummonToggleKey;
// ─── Visuals ───────────────────────────────────────────────────────────
public static ConfigEntry<bool> HeadFireVFXEnabled;
public static ConfigEntry<bool> BodyModelEnabled;
public static ConfigEntry<bool> RaiseDeadIcon;
public static ConfigEntry<bool> ShowHelmet;
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)));
// G is the first ability key of every race that has one; the Skeleton had none.
const string keybinds = "Skeleton - Keybinds";
SummonToggleKey = config.Bind(keybinds, "Toggle Summon on Kill", new KeyboardShortcut(KeyCode.G),
"Turns raising a skeleton from each kill on and off (The Queen and later). The Raise the Dead icon shows while it is on.");
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."));
BodyModelEnabled = config.Bind(visuals, "Body Model Enabled", true,
new ConfigDescription("Whether Skeleton players wear the skeleton body. Turn it off if you use a player model mod (EnhancedValheimVRM and the like): Skeletons then keep the vanilla viking body, so the replacement model shows without bones clipping through it. Abilities are unchanged. Client-side, like the option above: it applies to every Skeleton you see, yourself included, and changes nothing for other players."));
RaiseDeadIcon = config.Bind(visuals, "Raise the Dead Icon", true,
new ConfigDescription("Shows the Raise the Dead status icon while your Summon on Kill is on."));
ShowHelmet = config.Bind(visuals, "Show Helmet", false,
new ConfigDescription("Off: your helmet stays hidden over the skull. On: the helmet you wear shows. Helmets and hoods are moved and enlarged to fit the skull. Your own choice: other players see you the way you picked. A viking body (Body Model Enabled off) always shows its helmet.")); }
}
}