Skip to content

Regeneration Simulation LOD policy

Mass Forge regeneration interoperates with Unreal Engine's standard Simulation LOD variable-tick path. Mass Forge does not define a second distance model or hard-code update rates. The project's Simulation LOD trait owns classification, distances, population limits, and the High, Medium, Low, and Off tick rates.

Opt-in setup

  1. Configure attributes and a Mass Forge Regeneration Profile normally.
  2. Add Mass Forge Attributes Trait and Mass Forge Regeneration Trait to the Entity Config.
  3. Add Unreal's Simulation LOD trait to that Entity Config.
  4. Enable variable ticking on the Simulation LOD trait.
  5. Set deliberate High, Medium, Low, and Off tick rates for the project's accuracy and frame-budget needs.

No Mass Forge setting is required. An entity without the Simulation LOD variable-tick fragments continues to regenerate on every Mass Forge processor run using the ordinary world simulation delta.

Behavior and accuracy by LOD

Simulation LODScheduling sourceMass Forge behaviorAccuracy guarantee
HighProject High tick rate; Unreal's default is every frameRuns only when the standard Simulation LOD chunk is dueConstant-rate rules integrate the complete elapsed Simulation LOD delta, within floating-point precision
MediumProject Medium tick rateSkips non-due chunks and catches up on the next due updateNo elapsed time is intentionally discarded; visible changes arrive at Medium cadence
LowProject Low tick rateSkips non-due chunks and catches up on the next due updateNo elapsed time is intentionally discarded; larger value steps are expected at Low cadence
OffProject Off tick rateFollows the configured Off cadence exactlyA finite Off cadence continues batched regeneration; a project that prevents Off updates intentionally pauses regeneration until the entity becomes due again
No variable tickingMass Forge PrePhysics processor cadenceUses the current world simulation delta every processor runExisting frame-by-frame behavior is unchanged

The processor is explicitly ordered after Unreal's Simulation LOD processor. On a due chunk it reads the accumulated DeltaTime stored for each entity by Unreal, rather than substituting the current frame delta.

Interaction with rule Tick Interval

Simulation LOD cadence and a regeneration rule's Tick Interval are independent layers:

  • Simulation LOD decides whether the chunk is visited.
  • The accumulated entity delta advances the rule.
  • A zero rule interval applies the entire accumulated delta immediately.
  • A positive rule interval applies all complete authored intervals in one linear update and retains the remainder.

For example, an entity due after 1.25 seconds with a rule interval of 0.5 seconds applies 1.0 second of work and retains 0.25 seconds. This preserves the existing deterministic catch-up contract.

Deliberate sampling boundary

Constant-rate rules reproduce the same linear result regardless of LOD cadence, subject to normal floating-point precision and target clamping. Attribute-driven rates sample the rate attribute when the due update runs. Mass Forge does not reconstruct historical rate values between updates, so a frequently changing sampled rate may produce a different approximation at Medium, Low, or Off cadence.

For gameplay-critical rapidly changing rates, use High LOD, shorten the configured tick rate, or use a constant rate. Clamping occurs when the update is applied, not during skipped frames, so presentation and threshold listeners observe batched changes at the selected cadence.

Safety and verification

Invalid, zero, or negative accumulated deltas are ignored for that entity. Paused worlds therefore do not advance regeneration. The standard Simulation LOD chunk filter prevents entity iteration for non-due chunks; due chunks retain the allocation-free, compiled-slot hot loop.

MassForge.Abilities.WorldActivation constructs real Mass archetypes with and without Simulation LOD data. It proves that a non-due variable-tick chunk is skipped, a due entity consumes its full accumulated delta, and an entity without variable ticking still uses the world simulation delta. The release verifier also locks the optional fragment requirements, processor ordering, standard chunk filter, and both delta paths.

Mass Forge documentation — generated from the shipping Markdown source.