RacesOfValheim/JotunnModStub/Dvergur/DvergurConfig.cs
kanym 244f2f5afc fix(dvergur): isolate the hood by bone collapse, and commit to a skin tone
The dump settled both.

Skin: UpdateColors writes m_bodyModel.materials[0] _SkinColor, which is what
the postfix already targeted, so the patch was never wrong - the colour was.
_SkinColor multiplies the human skin texture rather than replacing it, and
(0.72, 0.74, 0.82) is close enough to white to change nothing anyone can see.
Every race that reads clearly commits to a channel, so the Dvergur now does too.

Hood: the dvergr mesh reports zero triangles because it ships with Read/Write
disabled, so its vertices and indices are unreachable at runtime and no submesh
carving could ever have produced geometry. The rig does carry a hat1/hat2/hat3
chain that nothing but the hood is skinned to, so the hood is isolated without
touching the mesh at all: instantiate the whole body, detach the hat chain from
the skull, and collapse the armature root to zero scale, which pulls every
vertex weighted to it into a single point and leaves only the hood standing.

Alignment is computed rather than measured - the object is shifted by the gap
between the hat bone and the player head bone - so there are no hand-tuned
offsets, only optional nudges. Animator and LODGroup are stripped alongside the
MonoBehaviours since neither is one and both would keep driving or hiding the
rig, and the renderers are set to update when offscreen because the collapsed
bones leave the skinned bounds meaningless.
2026-08-02 23:24:24 +02:00

272 lines
15 KiB
C#

using UnityEngine;
namespace RacesOfValheim
{
/// <summary>
/// Every tunable number the Dvergur uses, in one place.
///
/// The race was specced with most percentages still open, so nothing here is baked into the
/// logic: DvergurProgression 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 DvergurConfig
{
// ─── Identity ────────────────────────────────────────────────────────
// "Dvergur" 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 = "Dvergur";
public const string StatsSE = "SE_DvergurStats";
public const string OverchargeSE = "SE_DvergurOvercharge";
public const string RunicPingCdSE = "SE_DvergurRunicPingCooldown";
public const string OverchargeCdSE = "SE_DvergurOverchargeCooldown";
// 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_DvergurState";
// ─── 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 Dvergur
// 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);
// ─── 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 Dvergur must never be reduced below this, however the malus and food line up.
public static readonly float MinMaxHealth = 5f;
// ─── 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];
}
}
}