RacesOfValheim/JotunnModStub/EyePositionConfig.cs
kanym f7a4494b39 feat(eyes): male per-eye defaults from playtest
Male Aswid, Alfar and Dvergar eye values dialled in on screen become the
defaults of their Eyes Position sections, so male faces no longer start from
the untuned code placement.
2026-10-27 17:44:49 +01:00

141 lines
7.8 KiB
C#

using System.Collections.Generic;
using BepInEx.Configuration;
namespace RacesOfValheim
{
/// <summary>
/// Hand placement for every race that hangs eyes on the face: one "Eyes Position - race"
/// section each, with a set of sliders per body and per eye. Per body because the two bodies
/// put their painted eyes in different places (PlayerFace); per eye because the face is not
/// symmetric enough for one set to fit both. Left and right are the character's own.
///
/// Every value is a delta on the placement the race's own code computes: all zeros (and size
/// 1) is the code's own placement, and the female defaults below are the corrections found in
/// game on top of it.
///
/// Local, never synced (ConfigSync): it only changes how this client draws faces.
/// </summary>
public static class EyePositionConfig
{
public const string SectionPrefix = "Eyes Position - ";
/// <summary>One eye's sliders, for one body of one race.</summary>
public sealed class Tuning
{
public ConfigEntry<float> Forward;
public ConfigEntry<float> Height;
public ConfigEntry<float> Separation;
public ConfigEntry<float> Size;
// Only bound for races whose eyes are not spheres; null elsewhere.
public ConfigEntry<float> RotationX;
public ConfigEntry<float> RotationY;
public ConfigEntry<float> RotationZ;
public float RotX => RotationX != null ? RotationX.Value : 0f;
public float RotY => RotationY != null ? RotationY.Value : 0f;
public float RotZ => RotationZ != null ? RotationZ.Value : 0f;
}
// [race] -> { male left, male right, female left, female right }
private static readonly Dictionary<string, Tuning[]> tunings = new Dictionary<string, Tuning[]>();
public static void Bind(ConfigFile config)
{
// Defaults dialled in on screen (playtest, 2026-10-27), per eye: female left, female
// right, male left, male right. The Sverm's helmet hides its eyes, so it keeps the
// code's own placement.
BindRace(config, AlfarConfig.RaceId, true,
new Defaults { Separation = 0.006f, RotX = -17.524f },
new Defaults { Separation = 0.015f, RotX = -17.524f },
new Defaults(),
new Defaults { Separation = 0.009f });
BindRace(config, "Aswid", true,
new Defaults { Forward = -0.006f, Height = -0.010f, Separation = 0f, Size = 1.314f,
RotX = -14.279f, RotY = -5.841f, RotZ = -1.298f },
new Defaults { Forward = -0.006f, Height = -0.012f, Separation = 0.011f, Size = 1.324f,
RotX = 1.947f, RotY = 3.245f, RotZ = 4.544f },
new Defaults { Height = -0.005f, Separation = -0.005f, Size = 1.273f,
RotX = 6.49f, RotY = 4.544f, RotZ = 4.544f },
new Defaults { Forward = -0.002f, Height = -0.005f, Separation = 0.004f, Size = 1.444f,
RotZ = 6.49f });
BindRace(config, DvergarConfig.RaceId, false,
new Defaults { Forward = -0.011f, Separation = 0.005f, Size = 1.616f },
new Defaults { Forward = -0.015f, Separation = 0.013f, Size = 1.616f },
new Defaults { Forward = -0.003f, Size = 1.05f },
new Defaults { Forward = -0.004f, Separation = 0.005f });
BindRace(config, SvermConfig.RaceId, false, new Defaults(), new Defaults(), new Defaults(), new Defaults());
}
/// <summary>Starting values for one eye's sliders.</summary>
private sealed class Defaults
{
public float Forward, Height, Separation, RotX, RotY, RotZ;
public float Size = 1f;
}
/// <summary>
/// The sliders for one eye of the body this player is wearing right now. Side is the
/// races' own convention: negative is offset against the head frame's right axis, which is
/// the character's left eye.
/// </summary>
public static Tuning For(string race, Player player, float side)
{
if (!tunings.TryGetValue(race, out Tuning[] set)) return null;
return set[(PlayerFace.IsFemale(player) ? 2 : 0) + (side < 0f ? 0 : 1)];
}
private static void BindRace(ConfigFile config, string race, bool rotation,
Defaults femaleLeft, Defaults femaleRight, Defaults maleLeft, Defaults maleRight)
{
string section = SectionPrefix + race;
// Female first in the list, left before right: Order sorts high to low.
tunings[race] = new[]
{
BindEye(config, section, "Male", "Left", rotation, 200, maleLeft),
BindEye(config, section, "Male", "Right", rotation, 100, maleRight),
BindEye(config, section, "Female", "Left", rotation, 400, femaleLeft),
BindEye(config, section, "Female", "Right", rotation, 300, femaleRight),
};
}
private static Tuning BindEye(ConfigFile config, string section, string body, string eye, bool rotation, int order, Defaults d)
{
string prefix = $"{body} {eye} Eye ";
string who = $"{body} characters, {eye.ToLowerInvariant()} eye (the character's own {eye.ToLowerInvariant()})";
Tuning t = new Tuning();
t.Forward = config.Bind(section, prefix + "Forward", d.Forward,
new ConfigDescription($"{who}: moves the eye out of (+) or into (-) the face, in metres.",
new AcceptableValueRange<float>(-0.05f, 0.05f), new ConfigurationManagerAttributes { Order = order + 9 }));
t.Height = config.Bind(section, prefix + "Height", d.Height,
new ConfigDescription($"{who}: moves the eye up (+) or down (-), in metres.",
new AcceptableValueRange<float>(-0.05f, 0.05f), new ConfigurationManagerAttributes { Order = order + 8 }));
t.Separation = config.Bind(section, prefix + "Separation", d.Separation,
new ConfigDescription($"{who}: moves the eye away from (+) or toward (-) the nose, in metres.",
new AcceptableValueRange<float>(-0.03f, 0.03f), new ConfigurationManagerAttributes { Order = order + 7 }));
t.Size = config.Bind(section, prefix + "Size", d.Size,
new ConfigDescription($"{who}: scales the eye. 1 is the default size.",
new AcceptableValueRange<float>(0.2f, 3f), new ConfigurationManagerAttributes { Order = order + 6 }));
if (rotation)
{
t.RotationX = config.Bind(section, prefix + "Rotation X", d.RotX,
new ConfigDescription($"{who}: tips the eye down (+) or up (-), in degrees.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 5 }));
t.RotationY = config.Bind(section, prefix + "Rotation Y", d.RotY,
new ConfigDescription($"{who}: turns the eye toward the temple (+) or the nose (-), in degrees.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 4 }));
t.RotationZ = config.Bind(section, prefix + "Rotation Z", d.RotZ,
new ConfigDescription($"{who}: raises (+) or lowers (-) the outer corner, in degrees.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 3 }));
}
return t;
}
}
}