RacesOfValheim/JotunnModStub/Dvergar/DvergarConfig.cs
kanym 8c004e3d7f style(dvergar): sink the eyes another centimetre
EyeForward 0.115 to 0.105, about a centimetre on a Dvergar. Agreed on the profile - they were still reading as sitting on the face rather than in it.

Also records the usable range, which is narrow: 0.095 buried them completely and 0.140 stood them off the skull, so the whole band is four centimetres and the eye is a two-centimetre ball. Most of it is meant to be inside.
2026-08-05 21:09:02 +02:00

346 lines
20 KiB
C#

using UnityEngine;
namespace RacesOfValheim
{
/// <summary>
/// Every tunable number the Dvergar uses, in one place.
///
/// The race was specced with most percentages still open, so nothing here is baked into the
/// logic: DvergarProgression reads these to build its per-tier rules and the patches read the
/// rules, never a literal. Retuning the race means editing this file only.
///
/// Values still marked TODO are placeholders chosen to be playable, not final.
/// </summary>
public static class DvergarConfig
{
// ─── Identity ────────────────────────────────────────────────────────
// "Dvergar" is provisional. It is the value stored in m_customData["Race"] and in the
// ZDO, so renaming it after players have chosen the race would orphan their characters.
public const string RaceId = "Dvergar";
public const string StatsSE = "SE_DvergarStats";
public const string OverchargeSE = "SE_DvergarOvercharge";
public const string RunicPingCdSE = "SE_DvergarRunicPingCooldown";
public const string OverchargeCdSE = "SE_DvergarOverchargeCooldown";
// Mirrors the ZDO key layout the other races use, so remote clients can read the tier
// without having the local player's progression state.
public const string StateZdoKey = "RacesOfValheim_DvergarState";
// ─── Model ───────────────────────────────────────────────────────────
// Applied to the player's "Visual" child rather than the root transform, the way Furling
// does it: scaling the root would drag the collider and camera pivot along with it.
// Tuning knobs are static readonly rather than const throughout: a const folds at compile
// time, which turns "is this perk switched off?" guards into dead code the moment a knob
// is set to zero, and would bake the old value into any assembly built against this one.
// Nudged up from the 0.70 the spec asked for: -30% read as too small next to a human once
// it was actually on screen.
public static readonly float VisualScale = 0.78f; // -22% versus a human
// ─── Skin ────────────────────────────────────────────────────────────
// Written straight onto the body material's _SkinColor by the UpdateColors postfix, which
// is the only thing that actually tints a player - see the comment on that patch.
//
// This is a multiplier over the human skin texture, not a replacement, so a value near
// (1,1,1) changes nothing anyone can see. The first attempt at (0.72, 0.74, 0.82) was
// exactly that mistake: correct code, invisible result. Every race that reads clearly
// commits to a channel - Trol (0.1, 0.6, 0.7), Furling (0.3, 0.8, 0.3) - so the Dvergar
// does too: a cold, dark slate blue-grey.
public static readonly Color SkinColor = new Color(0.42f, 0.52f, 0.68f, 1f);
// Dvergr are white-haired. The hood hides most of it, but the beard shows.
public static readonly Color HairColor = new Color(0.85f, 0.87f, 0.92f, 1f);
// ─── Star colours ────────────────────────────────────────────────────
// A starred dverger is not a different model: Valheim recolours the same one with a
// LevelEffects component, whose LevelSetup list carries a hue/saturation/value offset per
// star and an optional emissive colour for the eyes. Setup 0 is one star, setup 1 is two.
//
// Nothing here hardcodes a colour. The offsets are read off the creature prefab at
// runtime, so the race ages into exactly the tints the game itself uses - and follows
// them if a patch ever changes them.
public const int OneStarState = 4; // Bonemass
public const int TwoStarState = 8; // Fader
// Those offsets are authored against a dverger's own texture. Ours is a multiplier over
// the human skin, where white means "no tint at all" - so an offset that brightens and
// desaturates far enough lands on white and hands back an ordinary pink human. That is
// exactly what the two-star tier did. These bounds keep every tier recognisably the same
// colour, shifted rather than washed out.
public const float StarMinSaturation = 0.25f;
public const float StarMinValue = 0.20f;
public const float StarMaxValue = 0.85f;
// Two stars is hand-picked rather than derived, because the derivation cannot express
// what it is asking for. A multiplier can darken a texture and it can bias a texture, but
// it cannot desaturate one: the pink is in the human skin map, and multiplying by grey
// keeps every bit of it, only dimmer. So the two-star tier says "stone" the only way this
// channel can - dark, and cold enough to sit on top of the pink rather than under it.
//
// To tune: raise all three together for a lighter dvergr, and widen the gap between R and
// B for a colder one. Keeping R below B is what holds the flesh tone down.
public static readonly Color TwoStarSkinColor = new Color(0.34f, 0.37f, 0.44f, 1f);
// ─── Glowing eyes ────────────────────────────────────────────────────
// A player's eyes are painted into the skin texture, and Custom/Player has no emission
// channel to light them with - so a Dvergar wears two small emissive quads over them
// instead. Nothing else in the mod does this, so there was no working example to copy;
// the Aswid's red eyes were never built at all, only cleaned up.
//
// Metres from the head bone, which sits at the base of the skull, along the player's own
// forward and up. The eyes are parented to that bone, so all of this rides the head
// animation, and every offset scales with the race.
//
// Do not reintroduce Character.m_eye as a starting point. It reads like the right
// reference and is not: it is where the camera goes, half a metre above the head bone,
// and starting from it put the eyes in the treetops. That was measured, not guessed -
// the trace is in the commit history.
// These are pre-scale numbers: a Dvergar renders at 0.78, so 0.105 forward lands about
// 0.082m out from the bone at the base of the skull.
//
// EyeForward has less room than it looks. At 0.095 the eyes were placed correctly and
// vanished outright - the face surface was in front of them and the shader is
// depth-tested - while 0.140 had them standing off the skull in profile. The whole usable
// band is those four centimetres, and the eye is a two-centimetre ball, so most of it
// ends up buried by design and only the front cap shows.
public static readonly float EyeSeparation = 0.032f; // half the distance between them
public static readonly float EyeForward = 0.105f;
public static readonly float EyeHeight = 0.200f;
public static readonly float EyeSize = 0.020f;
// Base glow, before any star. The tiers replace it with the emissive colours the game
// itself gives a starred dverger - RGBA(0, 4, 3.3) at one star and RGBA(12, 0, 8.8) at
// two, both far past 1, which is exactly what makes them bloom rather than just look
// bright.
public static readonly Color BaseEyeColor = new Color(0f, 2.2f, 1.8f, 1f);
// ─── Cosmetic hood ───────────────────────────────────────────────────
// The helmet slot itself stays free — whatever the player equips keeps all of its stats,
// only the mesh is swapped.
//
// The hood is lifted straight off the Dvergr NPC rather than off the Dverger Circlet item:
// the circlet is a metal band, not the hood the race is meant to wear.
//
// Two facts out of dumpdverger decide how this is done.
//
// The prefab holds one renderer, 'dvergr', whose mesh reports zero triangles - it ships
// with Read/Write disabled, so its vertices and indices cannot be touched at runtime and
// no amount of submesh carving will ever produce geometry.
//
// But its rig carries a dedicated hat1/hat2/hat3 bone chain under 'head'. The hood is
// skinned to those bones and nothing else is, so the hood can be isolated by collapsing
// every other bone to zero scale rather than by editing the mesh at all.
public const string DvergerPrefabName = "Dverger";
// The child of the prefab holding the armature and the renderer.
public const string DvergerVisualName = "Visual";
// Root of the hat bone chain, and the bone whose collapse hides everything else.
public const string HoodBoneName = "hat1";
public const string BodyRootBoneName = "Root";
// Bone the hood is hung from on the player's own rig.
public const string PlayerHeadBoneName = "Head";
// Nudges on top of the automatic alignment, which already puts the hat bone on the player's
// head bone. Scale is the one most likely to need a look: the hood is authored for a Dvergr
// skull, not a human one.
public static readonly Vector3 HoodOffsetPosition = Vector3.zero;
public static readonly Vector3 HoodOffsetRotation = Vector3.zero;
public static readonly float HoodExtraScale = 1f;
// ─── Health malus ────────────────────────────────────────────────────
// Indexed by progression state; index 0 is unused so the state number indexes directly.
// Base -10, growing to -20 once The Queen falls.
public static readonly float[] HealthMalusByState =
{
0f, // (unused)
10f, // 1 Base
10f, // 2 Eikthyr
10f, // 3 The Elder
13f, // 4 Bonemass
15f, // 5 Moder
17.5f, // 6 Yagluth TODO: spec says -17/-18, pick one
20f, // 7 The Queen
20f // 8 Fader
};
// A Dvergar must never be reduced below this, however the malus and food line up.
public static readonly float MinMaxHealth = 5f;
// ─── Elemental affinity ──────────────────────────────────────────────
// Runes in the blood: every blow the Dvergar lands carries lightning.
//
// Deliberately the same shape as Skadi's Ice Affinity - live from the base tier and
// growing by a flat step per progression state, so +2 at Base through +16 after Fader -
// with lightning in place of frost. SkadiDamagePatch is the reference; like it, this
// applies to every blow the player lands, not only melee.
public static readonly float ElementalDamagePerState = 2f;
public static readonly HitData.DamageType ElementalDamageType = HitData.DamageType.Lightning;
// ─── Weapon affinity ─────────────────────────────────────────────────
// Bonus damage plus a stamina discount on the attack. Neither scales with the tier - a
// tier only ever adds a new weapon to the list - and skill XP is deliberately untouched.
public struct WeaponAffinity
{
public Skills.SkillType Skill;
public int UnlockState;
public HitData.DamageType FlatDamageType; // channel the flat bonus lands on
public float FlatDamage; // TODO
public float DamagePercent; // TODO, share of physical damage added
public float StaminaPercent; // TODO, share of attack stamina refunded
public float StaminaFlat; // TODO, flat stamina refunded
public string DisplayName;
}
public static readonly WeaponAffinity[] WeaponAffinities =
{
new WeaponAffinity
{
Skill = Skills.SkillType.Clubs, UnlockState = 1,
FlatDamageType = HitData.DamageType.Blunt,
FlatDamage = 0f, DamagePercent = 0.15f,
StaminaPercent = 0.20f, StaminaFlat = 0f,
DisplayName = "Hammer"
},
new WeaponAffinity
{
Skill = Skills.SkillType.Bows, UnlockState = 2,
FlatDamageType = HitData.DamageType.Pierce,
FlatDamage = 0f, DamagePercent = 0.15f,
StaminaPercent = 0.20f, StaminaFlat = 0f,
DisplayName = "Bow"
},
new WeaponAffinity
{
Skill = Skills.SkillType.Axes, UnlockState = 3,
FlatDamageType = HitData.DamageType.Slash,
FlatDamage = 0f, DamagePercent = 0.15f,
StaminaPercent = 0.20f, StaminaFlat = 0f,
DisplayName = "Axe"
},
new WeaponAffinity
{
Skill = Skills.SkillType.Crossbows, UnlockState = 6,
FlatDamageType = HitData.DamageType.Pierce,
FlatDamage = 0f, DamagePercent = 0.15f,
StaminaPercent = 0.20f, StaminaFlat = 0f,
DisplayName = "Crossbow"
}
};
// ─── Mining affinity ─────────────────────────────────────────────────
// Unlocks alongside the antler pickaxe.
public const int MiningAffinityState = 2;
// Faster mining is modelled as extra pickaxe damage per swing rather than a swing-rate
// change: rock HP is what actually gates how long a vein takes.
public static readonly float MiningDamageMultiplier = 1.20f; // TODO: 20% faster?
public static readonly float MiningStaminaPercent = 0.40f; // TODO: or 40% less stamina?
// Chance for a mined vein to yield an extra unit of ore. 0 disables the yield half of
// the affinity and leaves it purely a speed/stamina perk.
public static readonly float MiningExtraDropChance = 0.25f; // TODO
// Matched against the drop prefab name, lowercased, by Contains.
public static readonly string[] OreDropNames =
{
"copperore", "tinore", "ironscrap", "silverore", "blackmetalscrap", "flametalore"
};
// ─── Smithing / jewelry ──────────────────────────────────────────────
// Percentage saved on the metal cost of crafting and upgrading. Starts at Bonemass and
// caps at Moder. Indexed by progression state.
public static readonly float[] SmithingDiscountByState =
{
0f, // (unused)
0f, // 1 Base
0f, // 2 Eikthyr
0f, // 3 The Elder
0.20f, // 4 Bonemass
0.40f, // 5 Moder - cap
0.40f, // 6 Yagluth
0.40f, // 7 The Queen
0.40f // 8 Fader
};
// Only these resources are discounted, which is what keeps the perk to smithing and
// jewelry rather than quietly cheapening every wooden wall the player puts up.
public static readonly string[] DiscountedResourceNames =
{
"copper", "tin", "bronze", "iron", "silver", "blackmetal", "flametal",
"ironnails", "bronzenails", "copperore", "tinore", "silverore", "flametalore",
"ruby", "amber", "amberpearl", "coins", "silvernecklace"
};
// ─── Haldor / Hildir favour ──────────────────────────────────────────
// Both halves of the trade: a discount on what the traders charge, and a bonus on what
// they pay for trophies and hunting rewards. Indexed by progression state.
public static readonly float[] TraderBuyDiscountByState =
{
0f, // (unused)
0f, // 1 Base
0f, // 2 Eikthyr
0f, // 3 The Elder
0.10f, // 4 Bonemass - step 1 TODO
0.15f, // 5 Moder - step 2 TODO
0.20f, // 6 Yagluth - step 3 TODO
0.25f, // 7 The Queen - full TODO
0.25f // 8 Fader
};
public static readonly float[] TraderSellBonusByState =
{
0f, // (unused)
0f, // 1 Base
0f, // 2 Eikthyr
0f, // 3 The Elder
0.10f, // 4 Bonemass - step 1 TODO
0.20f, // 5 Moder - step 2 TODO
0.30f, // 6 Yagluth - step 3 TODO
0.40f, // 7 The Queen - full TODO
0.40f // 8 Fader
};
// ─── Runic Ping (Yagluth) ────────────────────────────────────────────
public const int RunicPingState = 6;
public const KeyCode RunicPingKey = KeyCode.G;
public static readonly float RunicPingEitrCost = 25f; // TODO
public static readonly float RunicPingRadius = 40f; // TODO
public static readonly float RunicPingDuration = 10f; // TODO
public static readonly float RunicPingCooldown = 20f; // TODO
public static readonly Color RunicPingOreColor = new Color(0.4f, 0.8f, 1f);
public static readonly Color RunicPingEnemyColor = new Color(1f, 0.35f, 0.35f);
public static readonly float RunicPingLightRange = 8f;
public static readonly float RunicPingLightIntensity = 2f;
// Vein prefabs are matched on name, lowercased, by Contains - MineRock5_Copper,
// silvervein, rock4_copper and friends all fall out of this list.
public static readonly string[] RunicPingVeinNames =
{
"copper", "tin", "silvervein", "obsidian", "meteorite", "flametal", "mudpile", "leviathan"
};
// ─── Runic Overcharge (Fader) ────────────────────────────────────────
public const int RunicOverchargeState = 8;
public const KeyCode RunicOverchargeKey = KeyCode.H;
public static readonly float RunicOverchargeEitrCost = 60f; // TODO
public static readonly float RunicOverchargeMultiplier = 4f; // TODO, applied to physical damage
public static readonly float RunicOverchargeWindow = 15f; // seconds the charge is held
public static readonly float RunicOverchargeCooldown = 60f; // TODO
// ─── Helpers ─────────────────────────────────────────────────────────
/// <summary>Clamped table lookup, so a state outside 1..8 can never index out of range.</summary>
public static float Lookup(float[] table, int state)
{
if (table == null || table.Length == 0) return 0f;
int index = Mathf.Clamp(state, BossProgressionManager.MinState, table.Length - 1);
return table[index];
}
}
}