OpenUT99-Plus
Unreal Engine 1, rebuilt from scratch
Loading...
Searching...
No Matches
Debt, risks, open questions

Risks

Risk Impact Note
Game logic lives in UnrealScript (.u) the engine needs either an UnrealScript VM or native reimplementations of BotPack classes VM chosen (ADR 0006)
Native-only behaviour (Engine.dll, Render.dll) physics, collision, BSP rendering details have no script to read observe the original (ADR 0004)
Replication must match the original byte for byte network phase E may be infeasible ADR 0005 has a fallback

Deferred decisions

  • Whether disassembly of native binaries is ever allowed (now forbidden by ADR 0004).
  • README translations.

Known gaps

  • Review minors (2026-11-11): C++ read_properties does not stop tag headers at the export limit (wrong output, no UB); prop_* accessors ignore the property's type and size; a corrupt dependency aborts a whole map load and failed loads are retried; compare_engine.py stops on a Python exception and ignores ut_dump exit codes; Python format readers that index bytes or call struct directly can still raise IndexError / struct.error (the sweep counts them as errors).
  • VM shortcuts (unverified against the original): integer and float division by zero give 0, float → int out of range gives 0, ~= on floats uses 1e-4, Caps is ASCII only, Rand / FRand use a different generator; text formats of conversions to string; out-of-bounds array indices are clamped with a warning; spawned instances are named class + a per-class count from 0 (as the original's first spawns; a spawn may repeat a map actor's name); struct defaults other than Vector / Rotator and struct inheritance are not read; state ignores (ignore mask) not applied; after GotoState from state code the new code starts on the next tick.
  • World placeholders (2026-11-11), each a shortcut: in engine/world.cpp: physics is minimal (walking reaches ground speed at once, walking hovers 4.8 above floors and steps 25 from there (climbs 29, not 30) and the floor limit is normal z 0.7, all measured (script.md); Move does not slide, collision cylinders are swept as boxes (the original does too) against expanded planes checked with the leaf hulls (mover brushes have none: no bevels there), and moves that put the centre into solid are still refused; sliding on a surface follows the measured 1 / (1 + nz²) share of gravity, but a pawn walking into a too-steep slope starts its slide slower than in the original (278 vs 347 along the slope: script.md), so it gets about 100 up where the original gets 171 (the original's start velocity is not along the slope and no rule is found yet); faces steeper than normal z 0.263 are walls (the original's limit moves around 75° between runs); falling moves by the tick's mean velocity and slides once per tick; a pawn falls with air control (AirControl × AccelRate) toward the Acceleration its walk left, latent moves do not steer it in the air (both measured), capped at GroundSpeed (unverified); walking into a slope too steep to walk turns to falling along it (rule inferred from the probe); static actors never move), actors block each other only by sweeping the moving centre against cylinders grown by both sizes (both must block the other's kind: bBlockPlayers toward a bIsPlayer pawn, else bBlockActors; rule inferred from retail defaults, unverified), Bump both ways, no pushing or steering around a blocking pawn, encroachment only with movers; the per-move scan of every actor costs ≈ 20 % of a match's time, traces through actors are lines against cylinders, Visible*Actors ignore visibility, TweenAnim is a pause, LatentFloat follows only Sleep, negative (velocity-scaled) anim rates run at their magnitude, Mesh / SkeletalMesh sequences not read, no sound (PlaySound, GetSoundDuration 0), ConsoleCommand returns "", SaveConfig is dropped (never write into the install), .int lists not read, describeSpec empty, Disable mutes any event name, SetOwner sends no events; bKillZone zones and FellOutOfWorld are not applied (zone 0 is not "outside the world": 221 retail navigation points lie in zone 0). Movers (engine/world_mover.cpp): the collision box keeps its world axes inside a rotated brush, riders are carried by translation only (no turning, no collision on the way), a mover blocking players also blocks every other trace, encroachment only tests blocking actors, HitWall comes from movers and, for a walking pawn, from BSP walls where the step fails (measured: probe OU-Ledge). The play-start order and spawning the game "already begun" are inferred from the scripts, unverified.
  • AI placeholders (2026-11-11, engine/world_ai.cpp): "reachable" has the measured climb and drop limits (29 / 24, with bCanJump 52 / 118 whatever JumpZ; with other sizes not measured) and otherwise is a clear line (walking off at its own height when going down) with floor every 48 units; routes start from navigation points within 1,200 units in sight; FindRandomDest picks at random; CanSee has no view cone (sight events do use PeripheralVision); traces through actors ignore their extent; swimming moves like flying; moves end within the two collision radii + 8 or on a timeout; turning is instant; PickTarget / PickAnyTarget find nothing; PickWallAdjust jumps toward Destination at ledges up to 77 above the floor whatever JumpZ or CollisionHeight (measured), else sideways: left first, Destination 2 × radius + 16 aside and 25 up (measured at radius 17 and 25), fitting if the box clears 2.25 × radius + 1.75 (a line through the two measured ranges). The jump comes first when both fit (measured). Walking hovers 4.8 above the floor (measured), slides up ramps, steps 25 from the hover (also where a ramp slide is blocked, as at a ramp foot); it does not jump by itself (measured: bots jump through HitWall → PickWallAdjust); a pickup is reached only by touching it, a path node loosely. Routes add each navigation point's SpecialCost when it has bSpecialCost (JumpSpot, TranslocStart / TranslocDest, PainPath: a jump spot a bot cannot use costs 100,000,000 in its script). They take the next step's SpecialHandling; an answer of None keeps the step (unverified). Bots still the same 3 s while accelerating, 8 DM maps × 90 s: 39 (85 before the ramp-foot step). What still stops bots: boxes already overlapping a wall, JumpSpots when no other way exists (translocator / jump boots), items on ledges higher than a jump (DM-Deck16][ UT_Eightball0), lifts: over the 26 DM maps with a LiftCenter, 60 s each, 49 of 140 movers moved and bots rode 31 (38 / 28 before SpecialCost); DM-Agony and DM-Peak routes did not pass their lift in 120 s, though their movers start in StandOpenTimed and the lift edges are in the graph (no route needed them, not a fault found). Editor cameras are dropped at load (inferred).
  • Player placeholders (2026-11-15, engine/world_player.cpp): keys are fixed in code (User.ini bindings not read), with the retail default binding speeds; the order input → exec commands → PlayerInput → PlayerTick → the actor's Tick and Possess before PostLogin are unverified; the pawn's Player is a bare Engine.Player (the original's Viewport is C++ only: no console, no canvas); mouse axes are handed over as a rate with a 0.1 scale tuned by feel (0.32° a pixel at sensitivity 3, unverified); config variables (MouseSensitivity etc.) keep their class defaults; MoveSmooth moves as Move (no sliding); UpdateURL is dropped; mouse look is drag-only unless --mouse-free (SDL relative mode, which spun endlessly in the free camera under WSLg but works for the player); no HUD, no first-person weapon (RenderOverlays not drawn).
  • Engine draws mesh actors full bright, environment mapping as a static map from the face normal (not view dependent), the first mesh texture for an empty material slot (unverified), no sprites (effects, projectiles drawn as sprites), no weapon in a pawn's hand; the static view shows frame 0 without PrePivot; DXT / 469 compressed textures show a grey checker. AS-Frigate shows black patches against the sky. They are not meshes, and drawing the sky zone's backdrop surfaces in colour does not change them. Their shadow-like edges suggest unlit surfaces (black lightmap), to compare with a picture of the original. ut_mapview --play ticks the world by the frame time capped at 0.05 s (a slow frame slows the match); mouse look is drag-only (relative mode and pointer warping turn endlessly under WSLg).
  • Light colour model uncalibrated (falloff curve, no N·L, ×2 texture modulation); zero-brightness radius-255 lights leave areas black (DM-Deck16][ spawn). Needs same-spot screenshots of the original.
  • Package and object flag bits not named (package.md).
  • Only patch 469f-rc5 checked (the install's manifest says 469e, see install.md); packages from version 436 installs not yet compared.