Feature: Startup Wiring and Timer Resolution

This feature page covers what ServerSystemStratum wires at startup.

Startup Configuration Phase

In OnBeginConfiguration(), Stratum loads config, applies system toggles, and optional diagnostics.

BlockEntity Init Stagger Wiring

StratumBlockEntityInitConfig beInit = StratumRuntime.Config.Performance.BlockEntityInit;
BlockEntity.StratumDefaultInitialDelaySpreadMs = (beInit != null && beInit.Enabled) ? beInit.MaxStaggerMs : 0;

Windows Timer Resolution

On Windows, Stratum can call timeBeginPeriod based on config:

[DllImport("winmm.dll", EntryPoint = "timeBeginPeriod")]
private static extern uint StratumTimeBeginPeriod(uint period);

StratumTimerResolutionConfig timerCfg = StratumRuntime.Config.Performance.TimerResolution;
if (timerCfg != null && timerCfg.Enabled && stratumActiveTimerPeriodMs == 0
        && RuntimeInformation.IsOSPlatform(OSPlatform.Windows))
{
    uint period = (uint)Math.Max(1, timerCfg.PeriodMs);
    uint result = StratumTimeBeginPeriod(period);
    ...
}

This is meant to improve sleep granularity for server tick pacing on Windows.

Optional Timings and Preflight

if (StratumRuntime.Config.Performance.Timings.EnabledOnStartup)
{
    StratumRuntime.Timings.Start();
}

if (StratumRuntime.Config.Diagnostics.RunStartupPreflight)
{
    StratumPreflightReport report = StratumRuntime.RunPreflight();
    ...
}

Begin RunGame Phase

In OnBeginRunGame(), Stratum initializes runtime services and stamps world identity keys.

if (server?.World?.Config != null)
{
    server.World.Config.SetBool(StratumInfo.Id, true);
    server.World.Config.SetString(StratumInfo.Id + "Version", StratumInfo.Version);
    server.World.Config.SetString(StratumInfo.Id + "BaseGameVersion", StratumInfo.BaseGameVersion);
}

Those keys are synced to clients and can be used by mods to detect Stratum.

Source of Truth

• sources/VintagestoryLib/Vintagestory.Server/ServerSystemStratum.cs
• sources/VintagestoryLib/Vintagestory.Server/StratumConfig.cs
• wiki/Detection-and-Compatibility.md