Lodur: a physics character middleware. Characters feel stimuli, react by reflex, and are driven by pain, shock and resolve. Engine-agnostic C# core.
  • C# 99.6%
  • Shell 0.4%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Meta Vens 72fc3425ac Tests: an entry effect fires once per entry; the mend is inclusive in Step and Enter
A rage with EntryResolve 1 and Effort drains the will it was given (resolve
below 0.3 after the onset), and a calm/rage pair entered twice sets resolve to
the entry value twice and not again inside the goal. Mutants: Enter applied
every tick instead of on the takeover (2 tests fail); mend made strict in
Enter and in Step (1 test fails each). A goal with EntryResolve equal to
WillMendsAt mends; recovery landing exactly on WillMendsAt mends on that tick.
Addresses findings entry-once-unpinned and mend-boundary-unpinned.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-20 05:04:48 +01:00
docs Docs: the will breaks and mends, goals carry entry effects, the will mix 2026-11-20 04:19:12 +01:00
src Will: a test seam lowers the Attention and Consciousness slots; tests pin every reader of Will 2026-11-20 05:02:18 +01:00
tests Tests: an entry effect fires once per entry; the mend is inclusive in Step and Enter 2026-11-20 05:04:48 +01:00
tools/pain-box-golden Pin the shake's upper bound, the golden table's line endings, and a clean BDS tree for regeneration 2026-11-19 22:06:34 +01:00
.gitattributes Pin the shake's upper bound, the golden table's line endings, and a clean BDS tree for regeneration 2026-11-19 22:06:34 +01:00
.gitignore First slice: PD-muscle humanoid ragdoll on Ymir's SoA world 2026-11-07 04:07:37 +00:00
Directory.Build.props Point the Ymir dependency at main now that the SoA joints merged 2026-11-10 17:16:55 +00:00
Lodur.slnx Lodur.Core.Tests: behaviour tests for the nervous layers, core-engine-free 2026-11-19 20:42:37 +01:00
README.md Docs: the will breaks and mends, goals carry entry effects, the will mix 2026-11-20 04:19:12 +01:00

Lodur

A physics character middleware for characters that feel and react: they pull back from something hot, jump when poked, and, if they want their objective badly enough, crawl toward it after losing a leg.

Status: layers 1-3 and a layer-4 stand-in run on a PD-muscle ragdoll on Ymir. The design is docs/lodur-target.md; read it first. Lodur.Core holds perception, the withdrawal reflex, the drive state and a hold-against-reflex stand-in, run per character by Actor; Lodur.Body.Ymir is the PD-muscle active ragdoll on Ymir's Box3D SoA world (docs/first-slice.md, measured and unmeasured). Behaviour selection beyond the stand-in, impairment and the learned tracker are not coded.

Entry points: src/Lodur.Core/Actor.cs (one character's nervous state, one tick per physics step), src/Lodur.Core/PdMuscle.cs (engine-free PD law, strength per muscle), src/Lodur.Body.Ymir/HumanoidRagdoll.cs (the ragdoll, Drive and ReadRegions), tests/Lodur.Core.Tests (the layers and parity with the pain box; builds without Ymir), tests/Lodur.Tests (stand, fall, rest, same-seed-same-hash, and the connected pain box: ConnectedPainBoxTests). The map this was cut from is docs/connect-rungs-map.md. Needs a sibling Ymir checkout at main (the SoA joints merge, 2026-11-10, or later); dotnet test tests/Lodur.Tests builds its native library with cmake.

The problem

Active-ragdoll middleware (NaturalMotion's Euphoria, RootMotion's PuppetMaster) and learned physics controllers (DReCon, ProtoMotions) solve the body: physics, pose tracking and, in the learned case, balance. None of them models the nervous system. They have no senses that are not forces, no reflexes layered under deliberate behaviour, and no character whose pain competes with its will over time. Lodur is that layer.

Shape (planned)

  • Core (C#, no engine references): perception, reflexes, a drive state of pain, shock, adrenaline and resolve that evolves every tick (the will breaks at zero resolve and mends as it recovers, and can break again), and behaviour selection that turns the drive into targets plus muscle strength, weighted by the will available to each voluntary pose.
  • Body (per engine): follows those targets on the engine's own articulated physics. v1 is a PD-tracking active ragdoll on Ymir; v2 adds a small learned tracker for upright balance behind the same interface.

First consumer

Bad Day Simulator, a 3D physics sandbox.

Where it lives

Canonical: https://eureka.gamecult.org/forge/GameCult/Lodur. GitHub GameCult/Lodur is a push mirror.

Prior-art research: gamecult-ops/docs/research/euphoria-at-home-prior-art.md.