RacesOfValheim/JotunnModStub/EyePositionConfig.cs
kanym ffba40650e fix(aswid): eye position sliders rotate on the face's axes
The Eyes Position rotation was added to the Aswid's own twist, which works on
the head bone's raw axes: bone X points out of the face and bone Z sideways,
so Rotation X rolled the eyes and the mirrored Rotation Z tipped one eye up
and the other down. The slider rotation is now conjugated by the face frame,
so X tips, Y turns toward the temple and Z raises the outer corner on both
eyes alike. The female rotation defaults go back to 0, since the old numbers
meant other axes.
2026-10-27 15:40:52 +01:00

111 lines
5.9 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 female and a male set, because the two bodies put their painted eyes
/// in different places (PlayerFace). 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 body's sliders for 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, female }
private static readonly Dictionary<string, Tuning[]> tunings = new Dictionary<string, Tuning[]>();
public static void Bind(ConfigFile config)
{
// Female defaults dialled in on screen (playtest, 2026-10-27). The male ones are
// still the code's own placement; the Sverm's helmet hides its eyes, so it keeps it.
BindRace(config, AlfarConfig.RaceId, true,
new Defaults { Separation = 0.006f, RotX = -17.524f });
BindRace(config, "Aswid", true,
new Defaults { Forward = -0.001f, Height = 0.001f, Separation = 0.006f, Size = 1.061f });
BindRace(config, DvergarConfig.RaceId, false,
new Defaults { Forward = -0.011f, Separation = 0.005f, Size = 1.616f });
BindRace(config, SvermConfig.RaceId, false, new Defaults());
}
/// <summary>Starting values for one body's sliders.</summary>
private sealed class Defaults
{
public float Forward, Height, Separation, RotX, RotY, RotZ;
public float Size = 1f;
}
/// <summary>The sliders for the body this player is wearing right now.</summary>
public static Tuning For(string race, Player player)
{
if (!tunings.TryGetValue(race, out Tuning[] pair)) return null;
return pair[PlayerFace.IsFemale(player) ? 1 : 0];
}
private static void BindRace(ConfigFile config, string race, bool rotation, Defaults female)
{
string section = SectionPrefix + race;
tunings[race] = new[]
{
BindBody(config, section, "Male", rotation, 100, new Defaults()),
BindBody(config, section, "Female", rotation, 200, female),
};
}
private static Tuning BindBody(ConfigFile config, string section, string body, bool rotation, int order, Defaults d)
{
// Female first in the list: Order sorts high to low.
Tuning t = new Tuning();
t.Forward = config.Bind(section, body + " Forward", d.Forward,
new ConfigDescription($"{body} characters: moves both eyes 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, body + " Height", d.Height,
new ConfigDescription($"{body} characters: moves both eyes up (+) or down (-), in metres.",
new AcceptableValueRange<float>(-0.05f, 0.05f), new ConfigurationManagerAttributes { Order = order + 8 }));
t.Separation = config.Bind(section, body + " Separation", d.Separation,
new ConfigDescription($"{body} characters: pushes the eyes apart (+) or together (-), in metres. Each eye moves by this much.",
new AcceptableValueRange<float>(-0.03f, 0.03f), new ConfigurationManagerAttributes { Order = order + 7 }));
t.Size = config.Bind(section, body + " Size", d.Size,
new ConfigDescription($"{body} characters: scales both eyes. 1 is the default size.",
new AcceptableValueRange<float>(0.2f, 3f), new ConfigurationManagerAttributes { Order = order + 6 }));
if (rotation)
{
t.RotationX = config.Bind(section, body + " Rotation X", d.RotX,
new ConfigDescription($"{body} characters: tips both eyes down (+) or up (-), in degrees.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 5 }));
t.RotationY = config.Bind(section, body + " Rotation Y", d.RotY,
new ConfigDescription($"{body} characters: turns the eyes toward the temples (+) or the nose (-), in degrees. Mirrored between the two eyes.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 4 }));
t.RotationZ = config.Bind(section, body + " Rotation Z", d.RotZ,
new ConfigDescription($"{body} characters: raises (+) or lowers (-) the outer corners, in degrees. Mirrored between the two eyes.",
new AcceptableValueRange<float>(-90f, 90f), new ConfigurationManagerAttributes { Order = order + 3 }));
}
return t;
}
}
}