ValidatedWriteEntry

Records the post-OnBeforeVariable-validator resolved value for one variable write, scoped to the commit (path index) during which the write occurred. Stored in ValidatedWrites and re-applied during restore so that host-side validator side-effects (e.g. meter clamping, value coercion) reproduce the original result even if the validator implementation has since changed.

public class ValidatedWriteEntry

Inheritance System.Object → ValidatedWriteEntry

Properties

Key

Variable key (expression-namespace id, e.g. var_health) of the write that was intercepted by the OnBeforeVariable callback.

public string Key { get; }
Property Value

System.String

PathIndex

Zero-based index of the commit (outer list entry in Path) during which this write occurred. Used during restore to apply the override at the correct point in the replay.

public int PathIndex { get; }
Property Value

System.Int32

Result

The validated result value — the post-callback resolved value that was actually written to the variable store. Null when the validator cleared the value.

public object? Result { get; }
Property Value

System.Object

Docs last synced: 2026-07-08
Screenshot viewer