GregOrigin - OmniWalk: Arbitrary Gravity & Surface Adhesion Framework

I finally had a chance to pursue this issue. You’re right to rebuild from source: the launcher only delivers Windows binaries, and they won’t load in a source-built Linux editor.

  1. Find the plugin inside your Lutris prefix. The launcher runs under Wine, so the files are in its prefix rather than your normal file system:
    find ~/Games -iname ‘OmniWalk.uplugin’ 2>/dev/null
    (If you put the Lutris prefix somewhere else, search ~ instead.) The folder containing that file should have Source/, Config/, Resources/ and Docs/.

  2. Copy it into your project as YourProject/Plugins/OmniWalk/, then delete its Binaries/ and Intermediate/ folders (they were built for Windows).

  3. Build it with your engine. For a C++ project:
    /Engine/Build/BatchFiles/Linux/Build.sh YourProjectEditor Linux Development -project=“/path/to/YourProject.uproject”
    For a Blueprint-only project, or to install it for the whole engine:
    /Engine/Build/BatchFiles/RunUAT.sh BuildPlugin -Plugin=“/path/to/OmniWalk/OmniWalk.uplugin” -Package=“/tmp/OmniWalk_Linux” -TargetPlatforms=Linux
    Then copy /tmp/OmniWalk_Linux into /Engine/Plugins/Marketplace/OmniWalk, and enable it under Edit → Plugins.

If there really is no Source/ folder, send me the output of ls -R on that folder and your Fab order number, and I’ll send you the source package directly. If the build shows any errors, please send the log. Linux editor builds are the configuration we’ve tested least, and I’d like to fix anything you hit.

0.6.7 update, 2026-09-21

A housekeeping & fixes update to streamline the code before an eventual 0.7 version.

:penguin: Linux Editor Fix, Include Hygiene & Example-Level Placement

  • :globe_with_meridians: Engines validated: include fix on UE 5.5, 5.6, 5.7, 5.8; example-level fix on 5.7 and 5.8 (Win64) and on Linux — zero source changes between engines. :white_check_mark:
  • :penguin: Linux: both modules compiled in editor configuration for Linux x64 — 52/52 translation units, 0 warnings under -Wall -Werror, with and without precompiled headers. :white_check_mark:

:globe_showing_europe_africa: Example Level

  • :red_circle: The current example level started the player on a planet that belonged at the far end of the course.
    AOmniWalkShowcaseLevel spawned its zone labels, the orbit planetoid and its four moons as bare
    AActors. The planetoid — a 7 m sphere
    with BlockAll collision — enclosed the start platform’s PlayerStart: the player
    spawned inside it, was pushed out onto its surface, and OmniWalk adhered to it, so play began on
    a sphere with gravity tilted 58°. All 65 zone labels were stacked at the origin facing the wrong
    way, and the orbit zone had point gravity and ramps but no planet. Each root is now placed at the
    intended transform before it registers.
    → AOmniWalkShowcaseLevel (SpawnLabel, Zone_OrbitPlanetoid)

:penguin: Build Hygiene

  • :blue_circle: Two editor headers depended on the precompiled header for declarations they use.
    OmniWalkSetupWizardUtility.h declares UENUM(BlueprintType) EOmniWalkPreset but included only
    CoreMinimal.h — which does not define UENUM — and never included its own .generated.h.
    SOmniWalkSetupWizard.h holds a TSharedPtr<class SComboBox<...>> without including SComboBox;
    clang rejects an elaborated reference to an undeclared template (MSVC tolerates it). Every
    default build force-includes UnrealEd’s shared PCH, which happens to supply both declarations,
    so neither header ever failed on Windows or in a normal Linux build. Any build without that PCH —
    -NoPCH, bUsePCHFiles=false, or a future engine trimming the PCH — failed 3 of the editor
    module’s 10 translation units. The first header now includes OmniWalkSetupWizardUtility.generated.h
    (the UHT convention), the second Widgets/Input/SComboBox.h. Includes only; no code changed.
    → OmniWalkEditor

:white_check_mark: Validation

  • :white_check_mark: Linux editor configuration verified. Launcher engines refuse Linux editor targets,
    so the compile was reproduced from UBT’s own Linux and editor flags with UE 5.6’s
    pinned toolchain (clang 18.1.0): runtime 42/42 and editor 10/10 translation units, 0 warnings,
    with and without the shared PCH. Objects verified as ELF x86-64; a probe confirmed
    PLATFORM_LINUX=1 and WITH_EDITOR=1. Linking and running inside a Linux editor are not yet
    verified — that needs a Linux engine build.
  • :white_check_mark: All 504 quoted #include directives match on-disk case against UE 5.6 — required on
    case-sensitive file systems, and never checked by a Windows build.
  • :white_check_mark: Regression test added — OmniWalk.Editor.SetupWizard.ShowcaseHelperActorPlacement builds the
    showcase in an isolated game world away from the origin and asserts that the planetoid sits on
    its point-gravity centre, the moons orbit it, and every label keeps its spawn location and
    facing. Verified against the unfixed code first — it failed on all four assertions (planetoid off
    centre, 4/4 moons inside the planet, 65/65 labels at the origin and misfacing) — and a mutation
    run that restored only the moon defect was caught by the moon assertion alone.
  • :white_check_mark: Verified live in the 5.8 editor. With the fix, Play-In-Editor spawns the player at the
    PlayerStart on the start platform, walking, with gravity (0, 0, -1); before it, the player
    rested on the misplaced planet 4 m above the floor. The existing showcase tests passed throughout,
    because none of them checked where the helper actors ended up.

OmniWalk 0.7.0 coming soon with a new interactive demo:

0.7.0 update, 2026-09-28 :hushed_face: :man_climbing:

:bookmark: Legend

Symbol Meaning
:red_circle: Critical — breaks gameplay or multiplayer
:orange_circle: Conflict — two systems fighting over the same state
:yellow_circle: Logic — incorrect or dead behavior
:blue_circle: Gap / Quality — missing, degraded, or untidy
:sparkles: New — added API or capability
:recycling_symbol: Changed — refactor / rename
:white_check_mark: Validated — confirmed by build / test

:ringed_planet: Modernization & the “Chroma Orbit” Demo Minigame — v0.7.0

:bookmark: v0.6.7 (67) → v0.7.0 (70) — new runtime classes and Blueprint API; nothing removed. Three behaviour changes (see :recycling_symbol: Upgrade Notes).
:brick: Builds: Win64 editor (Development) — both plugin modules compile and link with 0 warnings, 0 errors on UE 5.8 and 5.7. :white_check_mark:
:test_tube: Tests: 31/31 pass on 5.8 and 5.7 (18 → 31). :white_check_mark:
:globe_with_meridians: Engines validated: UE 5.8 (new working-tree baseline) and 5.7 (throwaway host whose plugin source is byte-identical to the tree; only EngineVersion changed).
:desktop_computer: Platforms: Win64, Linux (unchanged).

The interactive demo is rebuilt from a feature tour into a third-person minigame whose one rule —
light up every surface you walk on — turns OmniWalk’s major point into the whole game. Around
it, the plugin moves to UE 5.8 conventions, the third-person starter gets gravity-aware animation
and a modern camera, and the final review fixed two input bugs that appear when a player switches pawns.


:compass: At a Glance

Area What changed Markers
:ringed_planet: Demo New Chroma Orbit minigame: 3 worlds, 1,308 paintable panels, slings, combo scoring, medals, autopilot, Slate HUD, golden-hour look :sparkles:
:person_standing: Third-person starter Gravity-aware locomotion (fixes idle-on-walls), procedural “courier” stand-in, lagged camera, camera auto-follow :yellow_circle: :blue_circle: :sparkles:
:video_game: Pawn switching Example character keeps its input after a Possess round trip; hover vehicle drives when entered from a character :red_circle: :orange_circle:
:toolbox: Modernization UE 5.8 baseline, TObjectPtr everywhere, Enhanced Input on the hover vehicle, IWYU, Unreal Insights scopes :recycling_symbol: :sparkles:
:hammer_and_wrench: Editor Example level and Setup Wizard now build Chroma Orbit; utility scriptable from Python :recycling_symbol: :sparkles:
:broom: Review follow-ups Gamepad Jump, device-aware prompts, readable clock, clearer errors, quieter logs :yellow_circle: :blue_circle:
:test_tube: Tests 13 new tests, 1 renamed — 31/31 on two engines :white_check_mark:

:ringed_planet: Chroma Orbit — the New Demo Minigame

  • :sparkles: A complete third-person game loop on three small worlds above a sea of clouds. Every
    surface — floors, walls, ceilings and the undersides of worlds — is tiled with dark panels that
    light up in the world’s colour as the courier walks over them. Charge a share of each world
    before its clock runs out, step on the sling pad, and fly to the next world, flipping to its
    gravity mid-arc.
    → AOmniWalkChromaOrbit (director), UOmniWalkPaintFieldComponent, FOmniWalkPaintGrid, OmniWalkChromaTypes.h

:repeat_button: The Loop

🏁 Title ─▶ 3·2·1 ─▶ 🚀 ─▶ 🟦 THE CUBE ─▶ 🚀 ─▶ 🌗 TWIN MOONS ─▶ 🚀 ─▶ 💫 THE HALO ─▶ 🚀 home ─▶ 🏆 Score card ─▶ 🔁 next round
⏱️ Clock runs out on any world ─▶ 🏆 Score card ("TIME UP") ─▶ 🔁 next round
Phase What happens Length
:chequered_flag: Attract Title card over a slow orbiting camera. Player mode waits for Start; autopilot starts by itself 5 s (autopilot)
:1234: Countdown 3 · 2 · 1 on the launch deck 3 s
:rocket: Slinging Bézier arc to the next world; gravity blends to the destination’s, the FOV kicks by 14° mid-flight 1.1 – 2.8 s
:artist_palette: Playing Paint panels against a 45 s clock; banner “Light up N% before the clock runs out” ≤ 45 s
:high_voltage: Stage clear “WORLD CHARGED!” + time bonus; the exit sling pad lights up and waits to be stepped on until stepped on
:trophy: Results “ROUND COMPLETE” or “TIME UP”, score, medal, round time, session best 7 s, then :repeat_button:

:globe_showing_europe_africa: The Worlds

World Shape (collision) Panels Gravity Target Colour
:airplane_arrival: Launch Deck 14 × 14 m slab with a dashed sling ring — world default — :white_circle:
:blue_square: The Cube 10 m cube with 1.5 m rounded edges and corners 462 Point volume 50% :blue_circle: cyan
:last_quarter_moon: Twin Moons two spheres, R 4.5 m; hop pads at the facing poles fling you across at any time 504 (2 × 252) Point volume per moon 45% combined :purple_circle: magenta
:dizzy: The Halo ring, inner R 9 m × 6 m wide (64 slabs), walked on the inside like a loop-the-loop 342 Spline volume pulling outward 75% :orange_circle: amber
  • :collision: Falling off a world (leaving its fall-out radius, or airborne for 4 s) respawns you on it
    with a “LOST IN SPACE” banner and −3 s on the clock.
  • :milky_way: 120 floating shards 150–400 m out give the sky depth and parallax; the layout is seeded (DecorSeed).

:sports_medal: Scoring

Rule Value
:green_square: Each panel lit 10 points × combo
:fire: Combo ×1 → ×5; +1 for every 12 panels in an unbroken chain; breaks after 1.5 s without a new panel
:stopwatch: Time bonus when a world is charged 50 points per second left on the clock
:3rd_place_medal: :2nd_place_medal: :1st_place_medal: Medals 18,000 · 28,000 · 36,000
:star: Session best kept across rounds, shown on the score card

:video_game: Controls

Action :keyboard: Keyboard / :computer_mouse: mouse :video_game: Gamepad
Start a round Space or Enter A / Cross, or Menu / Start
Move WASD or arrow keys Left stick
Look Mouse Right stick
Jump Space A / Cross
Sprint Left Shift Left stick click
Crouch Left Ctrl or C Right stick click

:robot: Autopilot

  • :sparkles: UOmniWalkAutopilotComponent drives any ACharacter along a waypoint route with ordinary
    movement input. Steering stays in the plane of the surface being walked, so it climbs walls and
    circles planets without special cases
    . It sprints on straights, jumps where a waypoint asks,
    keeps its heading while crossing onto the next face, and skips a waypoint after 1.25 s without
    headway instead of pushing into a wall forever.
  • :sparkles: The demo turns it on with the ?Autopilot map option or AOmniWalkChromaAutopilotGameMode:
    cube laps, a ring on each moon with a hop between them, and a helix around the halo, with a
    fallback to the nearest unpainted panel. An unattended round clears all three worlds in
    ≈ 62 s for a :1st_place_medal: Gold (38.8k – 40.6k measured).
  • :test_tube: Useful beyond the demo: a quick soak test for traversal changes.

:desktop_computer: HUD

  • :sparkles: AOmniWalkChromaHUD draws a Slate interface: :label: brand, :globe_showing_europe_africa: world chip in the world’s colour,
    :stopwatch: clock (blinks red in the last 10 s), :1234: score that rolls up, :fire: combo chip, :battery: charge bar with a
    target tick, :chequered_flag: title card with controls, :megaphone: banners (GO!, SLING!, WORLD CHARGED!, LOST IN SPACE),
    :trophy: results card, and an :robot: AUTOPILOT tag.
  • :video_game: The title card’s prompts follow the device in use: “PRESS A TO START” and stick controls
    after gamepad input, “PRESS SPACE TO START” and WASD after keyboard or mouse input.
  • :black_square_button: The clock sits on a soft translucent plate, so it stays readable over the Halo’s bright panels.
  • :clapper_board: It is added to the player’s viewport layer rather than a canvas, so Movie Render Queue’s UI
    pass composites it into renders. It attaches lazily, once a viewport exists, which is what MRQ needs.

:sunrise: Look — engine content only

  • :sparkles: FOmniWalkChromaEnvironment::Apply configures, and spawns when missing: :sun_with_face: a movable golden-hour
    sun (−5°, warm) for Lumen, :globe_showing_europe_africa: sky atmosphere, :cloud: a volumetric cloud sea just below the worlds, :light_bulb: a
    real-time sky light, :fog: near-invisible height fog, and :film_frames: a graded post-process volume (bloom,
    exposure −0.3, vignette, saturation and contrast lift, light motion blur and grain).
  • :artist_palette: Panels, hulls and neon accents use only /Engine basic shapes and materials — no new content assets.
    Opt out per level with bConfigureEnvironment.

:puzzle_piece: New Classes

Type Kind Role
:clapper_board: AOmniWalkChromaOrbit Actor Director: builds the arena (hulls, panels, pads, decor), runs the round, slings, respawns, title camera, autopilot routes
:artist_palette: UOmniWalkPaintFieldComponent Component One world’s panels on two instanced meshes (dim → lit) with a pop animation
:world_map: FOmniWalkPaintGrid Struct Spatial hash of panels: paint within a radius (facing-aware), nearest unpainted, coverage
:robot: UOmniWalkAutopilotComponent, FOmniWalkAutopilotWaypoint Component, struct Surface-aware waypoint following
:desktop_computer: AOmniWalkChromaHUD HUD Slate HUD, MRQ-capturable
:joystick: AOmniWalkChromaGameMode, AOmniWalkChromaAutopilotGameMode GameMode Third-person pawn, OmniWalk controller, Chroma HUD; spawns a director if the level has none
:sunrise: FOmniWalkChromaEnvironment Helper Golden-hour environment setup
:person_running: UOmniWalkLocomotionAnimInstance AnimInstance Gravity-aware locomotion (see :person_standing:)
:abacus: OmniWalkChromaTypes.h Header EOmniWalkChromaPhase, EOmniWalkChromaMedal, FOmniWalkChromaHUDState, FOmniWalkChromaFlow (round state machine), FOmniWalkChromaScore, FOmniWalkAutopilotRouteState, OmniWalkChromaBuilder (cube, rounded-cube, sphere and ring layouts)

:electric_plug: Blueprint API

Class Functions
AOmniWalkChromaOrbit StartRound · SetAutopilotEnabled · IsAutopilotEnabled · GetPhase · GetStageIndex · GetStageCoverage · GetHUDState · GetDeckSpawnTransform
UOmniWalkPaintFieldComponent GetCoverage · GetTileCount
UOmniWalkAutopilotComponent SetRoute · ClearRoute · HasRoute · IsRouteComplete · GetWaypointIndex · GetWaypointCount · event OnRouteComplete
UOmniWalkLocomotionAnimInstance GetGroundSpeed · IsAirborne
AOmniWalkThirdPersonCharacter IsUsingCourierStandIn
FOmniWalkChromaHUDState New field bGamepadPrompts (read-only)
C++ only AOmniWalkExampleCharacter::GetExampleMappingContext · AOmniWalkHoverVehicle::GetThrottleInput · GetDriveMappingContext

:gear: Director Tunables (defaults)

Group Properties
:straight_ruler: Rules StageTimeLimit 45 s · PaintRadius 170 cm · RespawnPenaltySeconds 3 · AttractSeconds 5 · StageTargets (0.50, 0.45, 0.75) · BronzeScore / SilverScore / GoldScore 18k / 28k / 36k · CourierGravityScale 2.2
:artist_palette: Look bConfigureEnvironment on · CubeColor / MoonColor / HaloColor · GlowIntensity 2.0 · DecorSeed 2026
:triangular_ruler: Layout DeckHalfExtent 700 · CubeOffset · CubeHalfExtent 500 · CubeBevel 150 · MoonAOffset / MoonBOffset · MoonRadius 450 · HaloOffset · HaloInnerRadius 900 · HaloWidth 600 · HaloThickness 60 · HaloSegments 64 · TileSize 100
  • :rock: CourierGravityScale 2.2 keeps the courier planted over curved crests at run speed (at 1.0 the
    centripetal requirement v²/r exceeds gravity and the courier leaves the surface).

:person_standing: Third-Person Starter

  • :yellow_circle: The Mannequin played idle while running up a wall. (An old bug that came back.) The template ABP_Unarmed measures
    ground speed as VSizeXY(Velocity) — world-space horizontal speed — which is near zero for a
    character climbing a wall or walking a ceiling. New UOmniWalkLocomotionAnimInstance is a C++,
    graph-free locomotion instance (idle / walk / jog / jump / fall / land with crossfades, evaluated
    through its own anim-instance proxy) that measures speed in the plane of the current
    gravity
    . AOmniWalkThirdPersonCharacter uses it whenever the Mannequin sequences exist.

    • :gear: WalkAnimSpeed 180 · JogAnimSpeed 420 · BlendTime 0.18 s · AirborneGraceSeconds 0.12 s
    • :film_frames: Sequences are soft references to the Mannequin’s Unarmed set, overridable per instance;
      a sequence for a different skeleton is dropped rather than evaluated.
    • :shuffle_tracks_button: bUseGravityAwareLocomotion (on by default) switches back to ABP_Unarmed.
  • :blue_circle: The third-person starter was invisible in projects without the Mannequin. It now builds a
    “courier” stand-in from engine basic shapes — body, glowing visor, antenna — with a procedural bob.

  • :sparkles: Camera: boom length 380 cm, position lag 12 and rotation lag 10, framing offset
    +45 cm, 80° FOV.

  • :sparkles: Camera auto-follow on AOmniWalkPlayerController: after a pause in look input the view eases
    behind the direction of travel, gravity-relative. Off by default; the demo turns it on.

    Property Default Meaning
    bAutoFollowMovement :cross_mark: off Master switch
    AutoFollowDelay 1.0 s Quiet time after look input
    AutoFollowYawSpeed 120 °/s Max turn rate (reached at 600 cm/s)
    AutoFollowMinSpeed 150 cm/s Below this the camera is left alone
    AutoFollowPitch 15° Resting pitch, looking down onto the pawn
    AutoFollowPitchSpeed 25 °/s How fast pitch settles
  • :sparkles: AOmniWalkExampleCharacter::SetSprintActive / IsSprintActive for code-driven sprinting.


:video_game: Switching Pawns

  • :red_circle: The example character stopped responding after the player left it and came back. Actions
    were bound once per pawn, guarded by a flag. Every possession gives a pawn a new input
    component
    , and the engine creates it under the same object name, so the flag — and any
    identity check — still said “bound” and the new component got no bindings. After driving a
    vehicle, or any other Possess round trip, WASD, jump, sprint and crouch did nothing. Binding is
    now judged by the component’s contents, so each new component is bound exactly once.
    → AOmniWalkExampleCharacter::BindEnhancedActions
  • :orange_circle: The hover vehicle ignored WASD when entered from the example character. Its driving context
    was added at priority 0, below the character’s (1), which stays registered and maps the same keys,
    so the character’s actions consumed them. The vehicle now adds its context at
    DriveMappingPriority (default 2) and removes it when unpossessed, so the keys return to
    the character on the way out.
    → AOmniWalkHoverVehicle
  • :white_check_mark: Pinned by OmniWalk.Editor.HoverVehicle.DrivesAfterLeavingExampleCharacter, which plays in the
    editor and walks :person_walking: → drives :flying_saucer: → walks :person_walking: again with simulated key presses. Before the fixes it
    failed on all three steps.

:broom: Review Follow-ups

Six small items from the final review, all fixed. Four are pinned by a test that failed first, one is checked in a render.

  • :yellow_circle: Gamepad players could not jump. The example character mapped A / Cross to Crouch and
    nothing to Jump. A / Cross now jumps (like Space), and Crouch moves to the right stick click.
    :warning: Behaviour change for gamepad crouching — see :recycling_symbol: Upgrade Notes.
    → AOmniWalkExampleCharacter · :white_check_mark: OmniWalk.Editor.Input.ExampleCharacterGamepadMappings
  • :blue_circle: The title card always said “PRESS SPACE TO START”. The director now tracks whether the player
    last used a gamepad or keyboard and mouse (FOmniWalkChromaInputDevice) and the HUD shows matching
    prompts and controls. Activity on one kind of device switches; activity on both, or on neither,
    keeps the current prompts, so a bumped mouse does not flicker them.
    → AOmniWalkChromaOrbit, AOmniWalkChromaHUD · :white_check_mark: OmniWalk.Chroma.Input.DevicePromptSwitching,
    OmniWalk.Editor.Chroma.PromptsFollowInputDevice
  • :blue_circle: The hover vehicle failed silently in projects without Enhanced Input. If the default input
    component class is the legacy UInputComponent, it now logs an error naming the class and the
    project setting to change, like the example character does.
    → AOmniWalkHoverVehicle · :white_check_mark: OmniWalk.Editor.Input.HoverVehicleReportsNonEnhancedInput
  • :blue_circle: The clock was hard to read over bright panels on the Halo. It now sits on a soft translucent plate.
    → AOmniWalkChromaHUD · :white_check_mark: checked in a new 1080p render
  • :blue_circle: A stray “Results → Attract” log line appeared when the first pawn was configured on the title
    card. Re-running the title setup for a new pawn is not a phase change, and is no longer logged as one.
    → AOmniWalkChromaOrbit · :white_check_mark: OmniWalk.Editor.Chroma.PromptsFollowInputDevice (log capture)
  • :blue_circle: The Mannequin mesh was loaded without checking it exists. The third-person character now checks
    the package first, as 0.6.x did, so packaged games without the Mannequin log nothing. There is no
    failing test for this: a missing package loads silently in the editor.
    → AOmniWalkThirdPersonCharacter::SetupMannequin

:toolbox: Modernization

  • :recycling_symbol: UE 5.8 is the working-tree baseline — descriptor EngineVersion 5.8.0; dev project targets use
    BuildSettingsVersion.V7 (5.8 refuses V6) and EngineIncludeOrderVersion.Unreal5_8. The source
    still builds unchanged on 5.7 (validated).

  • :recycling_symbol: Every raw object-pointer UPROPERTY in the public headers is now a TObjectPtr<> (40), for
    editor access tracking and lazy loading — the UE5 convention since 5.0.

  • :recycling_symbol: AOmniWalkHoverVehicle uses Enhanced Input. The plugin’s last legacy bindings,
    BindAxis("MoveForward"/"MoveRight"), depended on axis mappings modern projects no longer define.
    They are replaced by runtime-created actions and a mapping context added on possession:

    Action :keyboard: Keys :video_game: Gamepad
    Throttle W / S, ↑ / ↓ Left stick Y
    Steer D / A, → / ← Left stick X
  • :recycling_symbol: IWYUSupport.Full on both modules. The runtime module adds Slate / SlateCore (HUD); the
    editor module adds EnhancedInput (tests).

  • :sparkles: Unreal Insights CPU scopes on the per-frame hot paths:

    Scope Where
    OmniWalkPro_TickComponent · _DetectSurface · _DetectSurfaceAsync · _DetectWallOrConvex Adhesion core
    OmniWalkSubsystem_GetBestGravityAtLocation Gravity-volume queries
    OmniWalkLocomotion_Update · _Evaluate Locomotion anim instance
    OmniWalkPaintField_PaintAt · _Pops Panel painting and pop animation
    OmniWalkAutopilot_Tick Autopilot steering
    OmniWalkChroma_Tick · _BuildArena Demo director
  • :blue_circle: Descriptor: 0.7.0 (70); the description says “UE 5.5+” (was “UE5.4+”) and mentions the demo.

  • :blue_circle: A duplicated copyright line removed from OmniWalkZeroGPad.h / .cpp.


:hammer_and_wrench: Editor & Setup Wizard

  • :recycling_symbol: The generated example level is Chroma Orbit. UOmniWalkExampleLevelUtility builds the
    director, the environment and one PlayerStart on the launch deck, sets AOmniWalkChromaGameMode,
    and removes the previous generation’s showcase, demo generator and placed pawns. Panels are built
    in the editor, not only at play, so the level reads correctly before pressing Play.
  • :recycling_symbol: Setup Wizard → Example Tools: the button reads “Create And Open Chroma Orbit Demo”.
  • :sparkles: The utility’s functions are now also BlueprintCallable, so they can be scripted from Python
    (unreal.OmniWalkExampleLevelUtility).
  • :world_map: The feature tour is still available: drop AOmniWalkShowcaseLevel into any level.

:recycling_symbol: Upgrade Notes

Change Who notices What to do
:warning: Example level is now Chroma Orbit Anyone who regenerates OW_Example Place AOmniWalkShowcaseLevel for the old tour
:warning: Third-person character no longer uses ABP_Unarmed by default Projects with the Mannequin Set bUseGravityAwareLocomotion = false to get it back
:warning: Hover vehicle reads Enhanced Input, not legacy axes Projects that mapped MoveForward / MoveRight for it Nothing — the vehicle now brings its own actions and needs no project input settings
:warning: Gamepad A / Cross jumps; Crouch moves to the right stick click Projects using the example character’s built-in gamepad mapping Nothing, or map Crouch back in a subclass’s mapping context
:information_source: “No PlayerController” at BeginPlay logs at Verbose, not Warning Log watchers It fired for every pawn that nobody controls yet; possession adds the context anyway
:information_source: Descriptor EngineVersion is 5.8.0 Source users on 5.5 – 5.7 Set EngineVersion to your engine to skip the load prompt (5.7 verified)

:card_index_dividers: Dev Project (not shipped in the plugin)

  • :building_construction: OmniWalkDev.uproject → 5.8; enables MovieRenderPipeline plus, editor-only, PythonScriptPlugin,
    ModelContextProtocol, EditorToolset, AutomationTestToolset, SlateInspectorToolset and PluginToolset.
  • :gear: DefaultEngine.ini: startup and default map /Game/OmniWalkExamples/OW_Example; global game mode
    OmniWalkChromaGameMode; deprecated r.Mobile.VirtualTextures removed (5.8 raises a startup ensure).
  • :package: Content: Mannequins copied from the UE 5.8 template; /Game/Cinematics/ holds LS_ChromaWalkthrough
    (empty on purpose — with no camera cut, MRQ films the player camera).

:books: Docs

  • :open_book: Showcase.md — new Chroma Orbit Demo section: loop, worlds, scoring, controls, autopilot, MRQ recipe.
  • :open_book: Docs/Manual.html — the Example Level section describes Chroma Orbit (round-loop diagram, topics table).
  • :open_book: Docs/SetupWizardManual.html — Example Tools Mode text updated.

:warning: Known Limitations

  • :orange_circle: Hard 90° convex edges at run speed. At 600 cm/s the gravity turn over a sharp 90° lip lags
    about 1.5 m behind the character, which leaves the surface and falls. Chroma Orbit’s cube therefore
    has 1.5 m rounded edges, which keeps every surface change under 45°, so OmniWalk tracks it
    continuously. Core convex traversal is unchanged in this release.
  • :white_check_mark: The small open items found in the final review are fixed — see :broom: Review Follow-ups.

:white_check_mark: Validation

Engine :brick: Build :test_tube: Tests :video_game: Live
UE 5.8 :white_check_mark: 0 warnings :white_check_mark: 31/31 :white_check_mark: autopilot rounds, player-mode round, MRQ render
UE 5.7 :white_check_mark: 0 warnings :white_check_mark: 31/31 :minus:

One test (ExampleLevelChromaGeneration) logs two engine warnings about TypedElements reference
tracking on both engines. It passes.

Test Pins
:sparkles: OmniWalk.Chroma.PaintGrid.PaintRadiusAndCoverage Paint radius, panels facing away stay dark, upside-down painting, coverage, nearest unpainted panel, cell boundaries
:sparkles: OmniWalk.Chroma.Builder.CubeSphereRingTiles Cube, rounded-cube (panels and hull), sphere and ring layouts
:sparkles: OmniWalk.Chroma.Score.ComboDecayAndMedals Points, combo steps and decay, time bonus, medals
:sparkles: OmniWalk.Chroma.Autopilot.TangentSteeringAndStuckSkip In-plane steering, route progress, stuck skip
:sparkles: OmniWalk.Chroma.Camera.AutoFollowYaw Gravity-relative auto-follow yaw
:sparkles: OmniWalk.Chroma.Anim.GravityRelativeSpeed Speed in the gravity plane: climbing a wall is ground speed, leaving it is vertical
:sparkles: OmniWalk.Chroma.Flow.RoundLoopAndTimeout The whole round state machine, including time-out and the results loop
:sparkles: OmniWalk.Editor.Chroma.RuntimeBuildInIsolatedWorld Director in a rotated, isolated world: panels on every body, gravity volumes, game-mode spawning, Mannequin or courier
:sparkles: OmniWalk.Editor.HoverVehicle.DrivesAfterLeavingExampleCharacter Walk → drive → walk with simulated keys (see :video_game:)
:sparkles: OmniWalk.Chroma.Input.DevicePromptSwitching Prompt device switching rules
:sparkles: OmniWalk.Editor.Chroma.PromptsFollowInputDevice Director in play: gamepad and keyboard input flip the prompts; no stray phase log
:sparkles: OmniWalk.Editor.Input.ExampleCharacterGamepadMappings A / Cross jumps, right stick click crouches, left stick click sprints
:sparkles: OmniWalk.Editor.Input.HoverVehicleReportsNonEnhancedInput A legacy input component is reported as an error
:recycling_symbol: …SetupWizard.ExampleLevelShowcaseGeneration → ExampleLevelChromaGeneration The generated example level is Chroma Orbit, panels built in the editor
  • :white_check_mark: Verified live in the 5.8 editor over Epic’s Model Context Protocol server. Autopilot rounds
    cleared all three worlds in 61 – 63 s for 38.8k – 40.6k (:1st_place_medal: Gold) with no respawns and looped
    into the next round. In player mode the title card waits for Start, and a round that runs out of
    time goes to the score card and then a new round.

:file_folder: Files

Count Files
:sparkles: 20 added OmniWalkChromaOrbit · OmniWalkChromaTypes · OmniWalkChromaEnvironment · OmniWalkChromaHUD · OmniWalkChromaGameMode · OmniWalkPaintFieldComponent · OmniWalkPaintGrid · OmniWalkAutopilotComponent · OmniWalkLocomotionAnimInstance (.h + .cpp each) · OmniWalkChromaTests.cpp · OmniWalkEditor/…/OmniWalkInputTests.cpp
:recycling_symbol: 30 changed Both Build.cs; OmniWalkExampleCharacter, OmniWalkHoverVehicle, OmniWalkPlayerController, OmniWalkThirdPersonCharacter (.h + .cpp); OmniWalkPro.cpp, OmniWalkSubsystem.cpp, OmniWalkZeroGPad.cpp; 13 further public headers (TObjectPtr, copyright fix); editor: OmniWalkExampleLevelUtility, SOmniWalkSetupWizard.cpp, OmniWalkSetupWizardTests.cpp

0.7.1 update, 2026-09-30

:flying_saucer: Model Kit & a Working OmniDrive

:bookmark: v0.7.0 (70) → v0.7.1 (71) — new content (a 14-model kit), new Blueprint API on the hover vehicle, and fixes that make the OmniDrive, the track generator and the planetoid generator work as documented. Two behaviour changes (see :recycling_symbol: Upgrade Notes).
:test_tube: Tests: 43/43 on UE 5.5, 5.6, 5.7 and 5.8 (32 → 43: new content, driving, track, cinematic, wall, surface-response and spider-walk tests), each in a fresh host with the plugin built for that engine. :white_check_mark:
:globe_with_meridians: Per engine: each engine builds the model kit from the same sources (14 models, 37 packages, all saved by that engine) and regenerates the demo map, like 0.7.0’s (see :package:). Not packaged yet. :white_check_mark:

The OmniDrive hover vehicle now ships with a complete model with physics body; it hovers level on flat ground, planetoids and loops, and steers. Around it, the plugin ships a kit of fourteen models built in Blender, so every OmniWalk actor that needs a visual has one.


:compass: At a Glance

Area What changed Markers
:flying_saucer: OmniDrive Ships with a model and collision; stable hover; suspension strong enough for loops; per-point gravity on curved fields; real steering with grip; SetThrottleInput / SetSteerInput :red_circle: :yellow_circle: :sparkles:
:motorway: Track generator Default road mesh; roads follow each spline point’s up vector (loops no longer twist or roll); gravity pulls onto the road surface; closed splines; builds at runtime :red_circle: :yellow_circle: :sparkles:
:ringed_planet: Planetoid generator Default planetoid model and regolith surface; builds at runtime :yellow_circle: :sparkles:
:cyclone: Zero-G pads Visible pad (cyan entry, amber exit), flush with the floor at any scale :blue_circle: :sparkles:
:spider: Spider walk Walkers now go over hard 90° edges (up a wall and over the top, off a ledge and down its face) instead of being flung off :red_circle: :sparkles:
:person_walking: Walking, cinematic, surfaces Idle walkers no longer creep along walls; the cinematic turns the character with gravity; surface response no longer cancels mag-boot presets :yellow_circle: :orange_circle:
:package: Model kit 14 models, a master material with 14 instances, 7 textures, saved by each engine :sparkles:
:test_tube: Tests 8 new tests, including five Play-In-Editor physics tests :white_check_mark:

:flying_saucer: OmniDrive (AOmniWalkHoverVehicle, UOmniWalkHoverComponent)

  • :red_circle: It now defaults to /OmniWalk/Models/SM_OW_OmniDrive
    (479 × 275 × 128 cm): four pods on the component’s trace points, two convex collision hulls.
  • :red_circle: Bounced and flipped at 60 fps. The push-only suspension damper is integrated explicitly; with the
    old default Damping = 50, four points × 50 /s × 1/60 s = 3.3, above the stability limit of 2. An idle
    craft swung between 0.9 and 9 m above a planetoid and ended upside down. The default is now 3
    (settles in about a second; stable down to 30 fps), and the property documents the limit.
  • :yellow_circle: Nose-up tilt on curved fields. Every suspension point was damped against the gravity-up at the
    craft’s centre; on a 40 m planetoid a pod 150 cm ahead sits on a radial rotated by 150/R, so steady
    driving read as vertical motion at the front and back pods and pitched the nose up 12° at 11.5 m/s.
    Each point now samples the field at its own position: measured tilt 2.4° (up · radial 0.9991).
  • :red_circle: Could not steer. TurnTorque was scaled by mass but not by the moment of inertia, so a car-sized
    craft reached about 0.08 rad/s² of yaw: a full-steer run turned 0°. Steering is now a yaw-rate
    controller about the craft’s own up axis (MaxTurnRate 90°/s, TurnResponse), with LateralGrip
    so the craft goes where it points: measured 194° in 3 s at 11 m/s, 18.6° slip.
  • :red_circle: Scraped round loops. At full compression the four suspension points lifted 4 × HoverForce = 2 g
    with the old default of 500; entering the showcase’s 20 m loop at 16 m/s needs 2.3 g, so the pods
    bottomed out, scraped the road and the craft slowed to 2–3 m/s at the top of the loop. The default is
    now 1000 (4 g of lift); round the showcase loop the craft now holds 15–17 m/s. It rides a little
    higher (about 72 cm at rest).
  • :sparkles: SetThrottleInput, SetSteerInput, GetSteerInput (Blueprint-callable), for AI, cutscenes and
    scripted demos. A held drive key overrides them while a player drives. GetThrottleInput is now
    Blueprint-pure as well.
  • :blue_circle: ForwardThrust is applied as an acceleration (same result as before, now stated in the tooltip).

:motorway: Track Generator (AOmniWalkTrackGenerator)

  • :red_circle: No road. TrackMesh defaulted to none, so tracks had no mesh and no collision (the OmniDrive
    showcase’s vehicle fell through). It now defaults to SM_OW_TrackSegment: one metre of 9 m deck with
    its driving surface on the spline, so the spline field pulls a craft straight onto it.
  • :yellow_circle: Loops twisted. Spline meshes ignored the spline’s up vectors; every segment faced world up and
    flipped at vertical tangents. Each segment now uses its spline point’s up vector. The template
    generator’s loop sets its points’ up vectors toward the loop’s centre.
  • :yellow_circle: Closed splines get their closing segment; segments take the spline’s mobility (a Static segment
    cannot attach to the Movable spline).
  • :yellow_circle: Runtime tracks were empty. OnConstruction (which builds the road) was editor-only, so tracks
    spawned at runtime, including the template generator’s in a packaged game, had no road. It now runs
    in every build. The same applies to the planetoid generator.
  • :yellow_circle: Road collision cut across curves. The road was one spline mesh per spline point, several metres
    long on a loop, and a spline mesh’s convex collision spans the chord of its piece, so a craft struck
    the inside of the curve. The road is now laid by distance in pieces of at most MaxSegmentLength
    (new, 250 cm): within 4 cm of a 20 m loop.
  • :yellow_circle: The OmniDrive template’s loop ran into itself. Its entry and exit shared one lane, so the road
    leaving the loop passed through the road entering it. The loop now shifts sideways by 11 m from entry
    to exit, like a real loop-the-loop. The template’s craft now starts 5 m in from the road’s start, with
    all four pods over the deck.
  • :red_circle: Track gravity pulled sideways. A track’s field pulled toward the spline’s centre line, so a craft
    off-centre on the 9 m deck was pulled across the road: 2.3 m off-centre on the loop, gravity was 75°
    from the road’s down and the craft stalled against its own thrust. Tracks now pull along the road’s
    down wherever you are on the deck (new bSplineGravityAlongUpVector on gravity volumes, on for tracks,
    off for tubes).
  • :yellow_circle: Loops rolled near the top. Between the top point of a loop and the next, the spline’s own up
    vector rolled up to 9° sideways (the engine interpolates point rotations stored as shortest-arc
    quaternions, which flip sign where the up vector passes upside down), and a craft’s pod struck the tilted
    road. Road pieces and road gravity now interpolate the points’ own up vectors: the largest sideways
    lean on the showcase loop is 0.4°.

:spider: Spider Walk Over Hard Edges (UOmniWalkPro)

  • :red_circle: Walkers were flung off hard edges. Convex traversal only changed the target gravity; nothing
    carried the character round the edge. A walker holding forward up a wall reached the top edge, left the
    wall with gravity still pointing into it, and was thrown across the top and off the level (airborne for
    10.6 s in the new test). Walking off a ledge onto its face failed the same way.
  • :sparkles: Edge wrap. When the surface ends just ahead and a face continues round the edge, the character is
    now carried round the edge line onto that face in ConvexWrapSeconds (new, 0.15 s; 0 = at once), its
    foot rolling round the edge, keeping its speed, with gravity into the new face. It only wraps onto a face
    it fits on and that goes on far enough to stand on (not the rim of a floor tile), and never at a concave
    corner. IsWrappingConvexEdge() (Blueprint-pure) reports a wrap in progress. Measured over the kit’s hard 4 m
    block at walk (3.6 m/s) and sprint (9.9 m/s): up, over, down and away without leaving the surface.
  • :recycling_symbol: With convex traversal on (the example characters’ default), walking off a ledge now carries the
    walker down its face instead of falling. Turn bEnableConvexTraversals off where a character should
    drop off ledges.

:person_walking: Walking, Cinematic and Surface Response

  • :yellow_circle: Idle walkers crept along walls at about 63 cm/s. The adhesion impulse, meant to hold a walker to
    its surface, was also applied while it stood on that surface; walking movement then rescaled it into
    motion along the wall. Adhesion now applies only while falling or detached, not while walking: an idle
    walker on a wall stays within 0.0 cm over 3 s.
  • :yellow_circle: UOmniWalkCinematic turned gravity but not the character. The walker stood sideways to its new
    gravity until surface detection caught up. The character now turns with the gravity during the
    transition, on an immediate snap, and at the end. Auto-exit suits flips onto a surface the walker is
    already touching; see Modules.html for flips across a room.
  • :orange_circle: Surface response cancelled mag-boot presets. UOmniWalkSurfaceResponse rewrote friction,
    adhesion and walk speed every 0.1 s from values captured at BeginPlay, so Hover and Mag-Lock were undone
    at once and sprint speed flickered, even on an ordinary floor. It now writes only when the surface type
    changes and, on leaving, restores whatever was in effect when it arrived.
  • :blue_circle: Docs: UOmniWalkPhysicsField affects PhysicsBody objects (the PhysicsActor profile); a
    StaticMeshActor spawned at runtime needs the profile set.

:ringed_planet: Chroma Orbit Demo

  • :orange_circle: The autopilot could stall on the halo after its stage cleared. The halo’s exit pad sits at the bottom of
    the ring’s inner surface, and the autopilot steers at a waypoint’s projection onto the floor it stands on. When
    the stage cleared with the courier directly opposite the pad, at the top of the ring, that projection was the
    courier’s own spot, so it never set off and the round never reached its results. The exit route from the ring’s
    upper half now goes round by the quarter point on the courier’s side first. Found by the 0.7.1 cooked-game
    validation: 0.7.0’s rounds happened to clear elsewhere on the ring.

:ringed_planet: Planetoid Generator, :cyclone: Zero-G Pads

  • :sparkles: Planetoids default to SM_OW_Planetoid (dense sphere, regolith texture, exact sphere collision) and
    MI_OW_PlanetSurface; the engine sphere remains the fallback. Radius / 50 still scales it.
  • :sparkles: AOmniWalkZeroGPad has a visible PadMesh (no collision): cyan on entry pads, amber
    (ExitGlowMaterial) on exit pads, kept flush with the floor at any actor scale.

:package: Model Kit

  • :sparkles: Fourteen models in /OmniWalk/Models: OmniDrive, Planetoid, Track Segment, Tube Segment,
    Block Hard (true 90° edges), Block Rounded, Ramp, Floor Tile, Zero-G Pad, Gravity Beacon, Crate,
    Canister, Surface Drone (a custom-pawn body) and Sky Sphere. Simple collision where needed: convex
    hulls, a sphere primitive for the planetoid, complex-as-simple for the tube, none for the sky.
  • :sparkles: Materials in /OmniWalk/Materials: M_OW_Master (legacy material pins, so it works with and
    without Substrate: tint × detail albedo, roughness variation, detail normal, emissive) with 14
    instances, including five floor-surface presets (MI_OW_Surface_Ice, _Magnetic, _Rubber,
    _Sticky, _ZeroG) for the surface-response presets, and M_OW_Sky (unlit starfield).
  • :sparkles: Textures in /OmniWalk/Textures: hull panels and regolith (albedo, normal, mask) and a space
    panorama. They were generated with FLUX.2 [klein] 4B (Apache 2.0) and made tileable; prompts, seeds
    and sources are kept outside the package.
  • :sparkles: Built by each engine. The models are generated from code in Blender
    (Tools/Blender/omniwalk_models.py, outside the package) and imported by each engine
    (Tools/UE/build_omniwalk_content.py) before packaging, like the demo map. The package tools check
    that every kit package was saved by the target engine and kept its collision and materials.

:recycling_symbol: Upgrade Notes

  • Hover damping default 50 → 3. A craft that relied on the old value (at a high frame rate) may need
    Damping set back; keep points × Damping × frame time below 2.
  • TurnTorque is removed in favour of MaxTurnRate, TurnResponse and LateralGrip. With no
    steering input the craft now holds its heading, and sideways sliding is damped (set LateralGrip
    to 0 for pure drift).
  • Hover force default 500 → 1000. Crafts ride about 25 cm higher; set HoverForce back for the old
    ride height on flat ground (keep points × HoverForce well above the loads your tracks reach).
  • Track gravity follows the road surface (bSplineGravityAlongUpVector, on by default for
    AOmniWalkTrackGenerator). Set it off for the old pull toward the centre line.
  • Spider walk wraps over ledges. Characters with convex traversal on now walk down a ledge’s face
    instead of dropping off it (see :spider:).
  • GenerateDeadSpaceTemplate is renamed GenerateAirlockTemplate on AOmniWalkTemplateGenerator (the old
    name was a third-party trademark). Same template: an artificial-gravity airlock room. It is an editor button
    only (no Blueprint node), so only Python or C++ that called the old name needs the new one.
  • New /OmniWalk/Models, /Materials and /Textures folders (about 16 MB).

:test_tube: Tests (32 → 43)

Test Checks
OmniWalk.Editor.Content.ModelKit All 14 models load, every slot has an OmniWalk material, collision per model, OmniDrive size
OmniWalk.Editor.Content.DefaultModels Vehicle, planetoid, track and pad defaults; hover damping stable down to 30 fps
OmniWalk.Editor.HoverVehicle.CirclesPlanetoid PIE: settles at 47 cm, level; drives 150° around a 40 m planetoid in 10 s, 47–65 cm, up · radial ≥ 0.999
OmniWalk.Editor.HoverVehicle.Steers PIE: full steer turns 194° in 3 s with 18.6° slip
OmniWalk.Editor.TrackGenerator.LoopFollowsSplineUp The template loop builds its road, the top of the loop faces down, and no road piece leans sideways (largest up.Y 0.007)
OmniWalk.Editor.TrackGenerator.GravityFollowsRoadSurface 2.3 m off-centre on the loop, gravity is the road’s down (0.999); a tube-style field still pulls toward the spline
OmniWalk.Editor.HoverVehicle.DrivesTheShowcaseLoop PIE: the template’s craft, driven like a player, goes over the top and out onto the exit road, never below 15 m/s
OmniWalk.Editor.Locomotion.SpiderWalkOverHardEdges PIE: holding forward at a hard 4 m block on thin floor tiles, a walker goes up, over, down and away, off the surface for at most 0.06 s
OmniWalk.Editor.Cinematic.RotatesCharacterWithGravity PIE: after a 1 s cinematic flip to a wall, the character’s up matches the new gravity (1.000)
OmniWalk.Editor.Locomotion.IdleOnWallStaysPut PIE: a walker idle on a wall for 3 s stays on it and does not creep (0.0 cm)
OmniWalk.Editor.SurfaceResponse.KeepsMagBootPresets PIE: with a response table on a plain floor, the Hover preset’s friction survives (0.10)

A comprehensive tutorial video launched with 0.7.1: