Displayed name is "AOT UNITY TEST" (title screen, window/tab title, Railway project). The GitHub repo is still
Aot-Fable-5.1 - renaming it would break every existing remote, so it was left alone.
Live: https://aot-unity-test-production.up.railway.app
A ten-minute playable Attack on Titan homage in Unity 6, built through the CLI
on the Mac Studio by a gauntlet loop of builder and critic sub-agents. Started
2026-09-01. Read this whole file before doing anything.
Scope is v2: one district, one 15 m Titan, Mikasa, three-minute loop. No agent loops; the director builds by hand
and the user is the critic (he plays the mac build on his laptop; never screenshot or drive his machine).
-
Mikasa: Meshy mesh + auto-rig, 23 library clips (docs/CLIPS.md), random attack per click (ground set / air set),
real ODM blade prop in gloved fists (Resources/Props/Blade, Fist), fist roll tunable live with [ ]
(CharacterModel.FistRollDeg, user still has to give the number to bake in).
-
Titan (boss): Meshy mesh + rig, Proxies/TitanBrain.cs chase / swipe / stomp (~9 m reach), 100 HP bar, zone damage
(nape 40, or kill when kneeling after both hamstrings), death stays on the ground and shows the ending screen (R restarts).
-
Player: ODM/OdmController.cs. Space toggles hooks (virtual anchor 45 m out if nothing is aimed at, auto pull, press again
to release), Shift gas, WASD air steer, LMB attack, Esc frees the mouse, click captures it. 100 HP, knockback, respawn.
-
Camera: CameraRig/CameraRig.cs, centered on her, free look at any speed, heading re-based (not eased) when steering on foot.
In the air (flying, not hooked) the mouse yaw folds into the heading every frame and OdmController.airTurnRate slerps the
velocity toward the look direction: full 180s mid-flight, Spider-Man style. Hooked flight uses hookedTurnRate.
Landing is a dead stop (horizontal velocity zeroed, superhero landing), no sliding. Soft camera lock is OFF (TitanBrain.SoftLock,
-softLock to try it; user said it panned the camera on its own).
-
Cannons: Proxies/Cannon.cs, placed by ProxyBootstrap.CannonPlacer on the 3 tallest flight-test towers (now permanent,
stone-dressed) + the wall walkway. E to fire within 5 m, 40 dmg, HUD markers with distance. Tower placement verified in a capture (tools/unity.sh ... -odmGrid 1): three on tower tops, one on the wall.
-
World: ground trimmed to the town bounds with invisible boundary walls; fall below -25 m respawns.
-
Props pipeline: concept (Higgsfield) → tools/meshy.py → tools/prop_finish.py → Resources/Props/<Name>.fbx →
Shared/PropAlign.Align orients from geometry at runtime (exporter axes are not trusted).
-
World look (beauty pass 1, 2026-09-05): wasteland_clouds_puresky HDRI (sun az/el measured by tools/sunpos.py, brightness by
tools/skymean.py), sky-lit ambient, soft 4k shadows, SSAO renderer feature (added by UrpSetup.Ssao), post volume in
TownRuntime.Grade (ACES, bloom, white balance, split tone, vignette, grain), fog matched to the sky, and Town/TownLife.cs
(chimney smoke, dust motes on the camera, two bird flocks). A quarter of the houses have lamp-lit windows (HouseSpec.LitWindows).
Editor setup must run after pulling on the Studio: tools/unity.sh townsetup -quit -executeMethod Town.Editor.TownSetup.Run then
tools/setup.sh (they rewrite Sky.mat, Particles.mat, UrpPipeline/UrpRenderer assets, which are then committed).
-
Flight feel (2026-09-05): catenary cables with a whip on bite and a 4-frame shoot-out, grapple heads, anchor dust/sparks, camera kick
on latch, twin hip gas jets, procedural wind + gas-hiss beds (Shared/NoiseLoop.cs), blade trails during a slash, FOV widens with
speed (CameraRig.speedFovAdd).
-
HUD: ODM/Hud.cs (Bebas Neue / Oswald in Resources/Fonts): crosshair + hook-target ring with range, HP + segmented gas, speed,
Titan bar with hamstring chips and NAPE OPEN, floating damage numbers (Shared/HudEvents), cannon markers, hit vignette, FPS
counter top right, title and ending screens. R on the ending screen rebuilds the world through Shared/Reboot (boots register
with a priority) instead of reloading an empty scene. Reboot is untested in a real build.
-
Titan presentation: Proxies/TitanFx.cs (steam + red spray at cuts, nape plume when opened, stomp dust ring + rubble, step and
impact camera trauma, death steam, steam noise), hit-stop (Shared/HitStop) on heavy hits, kill cam on the nape kill, music ducks on hits.
-
Titan balance: 1.05 s telegraph with a SWIPE/STOMP warning at the strike point, hits only land in his front arc, damage 24/32,
softer knockback, 2.6 s cooldown, player has 1.6 s of grace after a hit (user said he was getting cooked on approach).
-
World layer 2: Town/TownDressing.cs (forest + hills on a dark meadow beyond the boundary, gutters, puddles, dirt, hay, moss at
the wall foot, hanging shop signs, weathervanes, pigeons, lamp glow + point lights, gate torches with flame and flicker, raised
portcullis), wall blocks in three shades, ground mist bank (TownLife.Mist), Shared/AmbientBed.cs (wind gusts, synthesized bell).
Ground103 is now imported under Town/Imported/Resources/Town/Textures (it was missing; ground materials fell back to bricks).
Outskirt ground uses TownMaterials.TexturedSimple (Simple Lit) and a dark tint; from the rooftops it still lifts toward the fog.
-
Capture poses outskirts and wall_top added to tools/poses.json.
-
Performance: the 26 fps was vsync. Bootstrap forces vSyncCount = 0; the Studio then runs 150-360 fps at 1080p with everything on.
Runtime static batching is REMOVED (StaticBatchingUtility.Combine produced giant grey planes across the map in the build);
dressing/outskirts cast no shadows, the Titan has a kinematic Rigidbody.
-
Player self-checks (Shared/Harness.cs, all command-line): -quitAfter N, -autoRestart N (proved Reboot in a real build:
RESTART_OK), -fpslog, -autoStart N (lifts the title), -autoKill N (nape hit through reflection), -autoStabs N (N LMB presses 0.6 s apart from -autoSlash, re-pressed
when hit-stop swallows one), -autoPerch N (hook the nearest tall wall face), -screenshotAt a,b,c
(real frames with the HUD to shots/play/). tools/play.sh 42 -fpslog -autoStart 2 -autoKill 26 -screenshotAt 15,27 -quitAfter 30
then rsync shots/play/ back. Shared/PerfToggles.cs: -noSsao -noPost -msaa1 -shadow2k -noShadows -noMist -noSmoke -noDust -noTrees -noLamps -noHud -noTown -noChars for bisecting frame cost.
-
Title: live orbit over the district from boot (CameraRig.TitleOrbit), click = intro dive to Mikasa (BeginIntroDive), input held
and the Titan waits at the gate (Ctx titleHold / introUntil) then roars (Shared/Synth.cs: roar, whoosh). Boss starts at z=98.
-
Titan approach: spawns at z=98, waits gateHold 6 s then walks in, first attack no sooner than firstAttackGrace 8 s, sprints only
beyond 70 m, closes to attackRange*0.55, steering has hysteresis (no left-right flicker on the transform).
-
Titan run clip = Meshy "Head-Down Charge" (runfast take in Titan.fbx; every new take must be added to the .meta
clipAnimations list or Unity never sees it). tools/merge_clips.py strips the baked hips travel from INPLACE clips per frame
(projection on the drift axis) because Meshy bakes root travel into the hips and Unity's Humanoid retarget turned it into 1 m
sideways snaps. Blender 5: slotted actions need arm.animation_data.action_slot = act.slots[0]. -titanLog prints transform +
hips per frame to prove it. Titan wrist roll CharacterModel.TitanHandRollDeg is 0 (180 pinched the forearms), tune live ; '.
-
Verified from screenshots: title orbit, dive, HUD, approach with lock, swipe wind-up, kill cam + steam + damage number, ending card,
and flight (-autoFly N: FlightScript.HarnessHop, HUD stays on while scripted in a windowed run).
-
Runtime transparent materials must clone Resources/Materials/Particles (see OdmController.Transparent): flipping keywords on
Unlit.mat at runtime is stripped from builds and rendered the gas/smear opaque white. Tower roof slabs are tiled square now
(DressTowers: thin = top); the "motion blur" streaks on tower roofs were that stretched texture.
-
Music: Shared/Music.cs crossfades Resources/Audio/Music/{title,battle} = the user's Suno track "Iron Walled Rise"; no ending
track by his call (music fades out on the ending card). Music.Duck on hits.
-
Audio: Shared/Sfx.cs pooled one-shots over Resources/Audio (Kenney): hooks, landing, slash, hits, titan steps and attacks, cannon.
-
Title screen: the user's StreamingAssets/title.mp4 loops full-screen (VideoPlayer -> RenderTexture in Hud.Title) under
PRESS ANY KEY; Time.timeScale = 0 and the Titan held until any key (Input.anyKeyDown or -autoStart), then StopTitleVideo
and the intro dive. Ending screen in Hud. Esc pauses with an overlay.
-
Particles: the puff texture is a shipped asset Resources/Particles/soft.png (was generated at runtime and came out as grey
squares in the build); soft particles are off on Particles.mat. ProjectSetup writes both.
-
Nape phase (TitanBrain.NapePhase, HP <= 25%): ordinary hits stop at the 25% floor; below it only an airborne slash on his upper
half lands, and it puts Mikasa ON HIS NECK (OdmController.EnterRide): kinematic, parented each physics step to TitanBrain.NapeWorld(),
he runs blind and swerves (Ridden), each LMB = RideStab (TitanBrain.Stab, a fifth of the last quarter, HUD dots), the fifth
plays the final plunge then NapeKill -> Hud.Cutscene (StreamingAssets/nape.mp4, the user's titan-fight clip, 7 s, Space skips)
-> FinishNapeKill -> kill cam -> YOU WON. Space jumps off. -autoRide N + -autoSlash N + -autoStabs N drive the whole kill from
the harness (verified end to end 2026-09-05 evening: five stabs, napefinal, nape.mp4, kill cam, YOU WON).
Each stab: red spray, camera shake + a CameraRig.Punch lunge, hit-stop, HUD dot, a stagger and a head shake on the Titan
(CharacterModel.ShakeHead, +/-12 deg at 6 Hz decaying over 0.6 s), a roar on odd stabs.
Ride camera: CameraTargetState.Riding opens the chase to rideDistance 5 m / rideHeight 2.2 m with his facing as the heading
(free look kept, his colliders excluded from camera collision), and TitanFx emits small short steam while Ridden.
-
Wall perch (play-tested 2026-09-05 evening with -autoPerch N, which sweeps for the nearest tall wall face and hooks it): a real hook
into a wall face (|normal.y| < 0.35) with no ledge to mantle ends the reel in EnterPerch. A wall anchor holds the hook latch down to
reelDetach (it used to unlatch at 3.5 m, so the perch never ran on a real hook). She faces the wall (the authored wallperch crouch
plants the feet forward) 0.55 m out and 1.9 m below the anchor, cables up to the two heads, no clipping; the chase camera swings out in
front of her at a three-quarter angle (perchDistance 4.5, perchYawDeg 30). LMB leaps: wallkick plays for kickAttackDelay 0.3 s,
then the air attack. Shift launches along the look (the component along the face is kept, never into the wall), Space drops and the
press is consumed so the hook toggle does not fire a fresh anchor.
-
Hand-keyed Mikasa clips wallperch, naperide, napestab, napefinal come from tools/author_clips.py (Blender, pose-bone eulers
with side-aware helpers; the arm/elbow/leg axes of this rig were measured with the pL/pR/pF probes in that file), exported as GLBs into
assets/characters/mikasa/rig and merged by tools/merge_clips.py (28 clips, height 1.70). Poses: Perch/Ride/Stab/Final in IPoser,
mapped in CharacterModel.Map, with procedural twins in ProceduralPoser for the proxy rig. wallkick is authored, merged and in the
.meta clipAnimations (lastFrame 18) as of 2026-09-05 evening.
-
Camera: airborne heading (hooked or free) is the mouse's alone; the dutch reads the velocity yaw rate.
-
Night of 09-06 (autonomous, Studio): blood is a cone of soft dark-red puffs plus thin drops (TitanFx sparks/drops); after the
kill she flips off the neck sideways (spinjump), steps clear of his collider and ignores it for 1.5 s (she was pinned at nape
height with zero velocity), and a dead Titan counts as ground; death steam halved; HUD nape marker with range during the nape
phase (Hud ring + "NAPE n M"); stabs play Synth.Squelch; blade trails on stabs; Music.Intensity lifts pitch/volume 6%/18% in the
nape phase; gas tops up on a perch; title hint names the neck rule. Titan steering: commits to the widest gap when boxed in, and a
progress watchdog (no closing for 4 s -> 3 s bulldoze straight at her with dust); he reaches and swipes her in the 40 s run now.
Harness: -autoPhase N (drop him to 25%), -perchExit 1|2|3 (LMB/Shift/Space off the perch: all three verified), -titanLog
also logs the player body. The perch faces OUT again (back to the wall, the reference frame; the Studio session had her facing the
wall): the wallperch/wallkick legs were re-keyed to reach back, the perch camera hangs in the street looking at her, a hook in the
Titan never perches, the bulldoze is clamped to town.bounds.
-
Day of 09-06: houses come down. Town/TownDestruction.cs records, per house, the contiguous vertex span it owns inside each
batched (cell, material) mesh, then writes those spans into a broken pile over 1.05 s: the ridge and the upper storeys fall furthest
and are thrown along the hit, the ground floor stays as a stub, the roof MeshCollider goes and the body box drops to pile height so
the rubble is walkable. Original normals are kept through the fall on purpose (the pile shuffles vertices past each other, so
recalculating flips half the quads to black). Dust up the whole height plus mesh debris, camera shake by distance, a pitch-dropped
crash. Shared/ICrush.cs is how Proxies reaches it without referencing Town (Ctx "town.destruction"); TitanBrain crushes on the
bulldoze (he used to clip through the block with a dust puff) and under a stomp. -autoCrush N flattens the block she faces and
logs CRUSH_OK. Two EditMode tests prove a crush moves that house's vertices and nothing else's, anywhere in the district.
-
Day of 09-06: grade contrast restored. A dim shadowless directional fill (TownRuntime.Fill, sky-blue, opposite azimuth, 0.5)
carries the shadow side of the towers, so contrast goes 6 -> 9, saturation 10 -> 6 and the flat shadow lift drops 0.13 -> 0.05.
Lifting the whole frame to rescue one plane is what ate the contrast in the first place.
-
Day of 09-06: the outskirts stop lifting into the fog. The meadow was dead flat for the first third of the ring with only 2200
trees over 250 m, so from a rooftop it was a horizontal sheet running to the horizon; once exp-squared fog at 0.0023 saturated it to
the bright horizon grey, the grade rendered it as a white page with trees stuck on. It rolls from the fence now (near swells, ridges
further out), 5200 trees and 3000 bushes carry out to the far ridges, hills/trees/undergrowth render in five distance bands each
pre-darkened against the fog, and fog density is 0.0017. Verified from wall_top and town_rooftop.
-
Day of 09-06: attic hatches - a plank lid with hinge straps over a dark opening, proud of the tiles on the front slope, on about
half the houses (HouseSpec.Hatch/HatchT/HatchOff, deterministic per house like LitWindows).
-
Day of 09-06: draw and sheathe. Authored in tools/author_clips.py (DRAW_STOW/GRIP/PULL/GUARD/REST), merged into Mikasa.fbx
(30 clips) and registered in the .meta clipAnimations. OdmController.Ceremony plays draw once as the intro dive hands over
the controls and sheathe once when gameOver lands; both verified in a real build ([Ceremony] draw / [Ceremony] sheathe).
They are clips, not poses - nothing else in the fight asks for them. The blade props still stay in her fists: the clips read as
taking them off the boxes, but nothing is actually stowed, which is the user's call to make.
-
Day of 09-06 (user play-test): the ride was seated at NapeWorld(), which is the CENTRE of the nape zone and therefore inside his
neck, so she glided a nape-radius above the surface instead of kneeling on it. TitanBrain.RideSeat projects the zone's bounds onto
his facing and sits her on the rear face (seatOut 0.18, seatUp 0.35). And he no longer slides through houses: TitanBrain.Plow
scans his footprint and one stride ahead every 0.08 s (a quarter-second scan let a sprint put him a body deep into a house first) and
brings down up to two houses a scan, in every movement path - chase, bulldoze, and the blind run while she rides the nape.
-
Day of 09-06 (user play-test 2): the 7 m Titan proxy is gone from the game. He belongs to the piece-15 captures and never got a
Meshy mesh, so a normal run had him standing in the market street at (-6, 0, 50) as bare capsules with a painted grin;
ProxyBootstrap.Spawn now builds him only for -piece proxies / -lineup, and registers titan/titanProxy/titanPoser only
then. (TownRuntime's old attempt at hiding him only covered Bootstrap's single stub capsule - the articulated proxy has no Renderer
on its root, so it always missed.) Tests updated to the new contract.
-
Day of 09-06 (user play-test 2): no stagger clip on him while she rides. Meshy's hit take has its travel baked into the hips and
merge_clips only strips that for the INPLACE locomotion clips, so every stab slid his whole body sideways and left her hanging
over where he used to be. The stab still reads (spray, head shake, camera punch, hit-stop, HUD dot, roar). On top of that
TitanBrain.PinRide pins the seat to his animated Neck bone at mount, so she now tracks whatever his animation does - the Zone_
colliders hang off the proxy skeleton, which stops being posed the moment the Meshy model dresses him, so a zone-only seat was
really root-relative.
-
Day of 09-07: trees no longer fly. SampleHills snapped to the nearest ring and segment, which was harmless while the meadow
was flat but floated trees metres into the air once the ridges rose (one ring step out there is tens of metres of height). It is
bilinear over the four surrounding grid vertices now, and the treeline is clamped inside r1 so nothing is placed off the mesh.
-
Day of 09-07: the boss is on the Titan layer. Only the 7 m proxy was ever put there, and he is gone, so HookMask
(HookTarget | Titan) did not include the boss - he could not be hooked at all - while GroundMask (Default | HookTarget) did, so
she could stand on a living Titan. Both are what the layer exists for. TitanBrain.Steer now names the HookTarget layer outright
instead of ~(1 << own layer), which had quietly meant "everything except Default" while he sat on Default. Play-tested: he still
closes and lands five attacks over a 40 s run, hooks still anchor.
-
Day of 09-07: crushed houses stop smoking (TownLife.Douse, called from the crush).
-
Day of 09-08: the WebGL build works and ships. It had not been rebuilt since 09-01. Now verified in a browser at
85 FPS with the district, the Titan, the fight and house destruction all intact.
Hud.Video guarded on System.IO.File.Exists, but on WebGL Application.streamingAssetsPath is an http URL, so the check was
always false: the title video never played (you got the live orbit) and the nape cutscene was skipped. It probes the disk only
when StreamingAssets is on disk now, and lets the VideoPlayer 404 over http.- 99 MB -> 40 MB, under the brief's 60 MB.
Editor/Build/WebGLTextures.cs writes a per-platform WebGL budget into every
texture importer (256-1024 by folder, DXT); qwantani.hdr was unused but sat in Resources and shipped anyway (4.4 MB); the two
mp4s were 12 and 20 Mbps and are re-encoded to 1600 px CRF 26 with no audio (25 MB -> 4 MB). The mac build is untouched.
- URL query flags. WebGL has no command line, so no
-no* toggle or harness flag worked in a browser. Bootstrap.Args now
folds the page's query string in: index.html?-fpslog&-autoStart=2&-noShadows behaves like the same switches on the desktop
build. This is how the browser build gets bisected.
Assets/WebGLTemplates/AOT: the stock template pins the canvas at 960x600 on a white page. This one is full-bleed, follows
resizes, caps devicePixelRatio at 2, keeps a fullscreen button, focuses the canvas so the keyboard works without a click first,
and ignores chrome-extension:// errors (a wallet extension was painting a red banner across the game).link.xml preserves SphereCollider: CreatePrimitive(Sphere) attaches one from native code, the stripper could not see it,
and the browser console filled with "class doesn't exist". Harness no longer reads triangles on non-readable meshes.TownDestruction marks a mesh dynamic only when a house in it actually falls, instead of every town mesh up front.- Measuring lesson: a Chrome tab that is not visible is throttled to exactly 1 Hz. A browser FPS reading is only real with
document.hidden === false; several builds were bisected against a phantom "1 FPS" before that was checked.
-
Day of 09-09: renamed to AOT UNITY TEST (title screen, productName, Railway project). The GitHub repo keeps its old name.
This broke tools/play.sh, which hardcoded AOT.app/Contents/MacOS/AOT - the executable inside the bundle is named after
productName. It finds the binary now instead of assuming it.
-
Day of 09-09: look sensitivity is a setting. CameraRig.LookSensitivity (0.1-3.0, persisted in PlayerPrefs): - / + on the
pause screen, , and . any time, -sensitivity 60 on the command line or ?-sensitivity=60 in the browser. The same physical
sweep does not turn the same amount everywhere - a browser reports pointer-lock deltas through the canvas, so a high-DPI display
reads far faster than the standalone build.
-
Day of 09-09: the nape cutscene. Space skipped it - and Space is the hook / jump-off key, so a player still on it when the last
stab landed never saw the clip. Nothing skips for the first 1.2 s now. It also could not fail into a black screen any more: if the
clip has not decoded within 1.5 s the THE NAPE card takes over, the clip gets its full seven seconds from the frame it actually
starts rendering (not from the kill), and VideoPlayer.errorReceived is logged.
-
Day of 09-09: the kill is staged. The cutscene is a hard cut, so TitanBrain.StageTheFall uses it to move him - and Mikasa -
into the market square, clear of the fountain, before he drops: he used to die wherever he happened to be, sinking through a roof.
The kill cam is passed a radius, pitch and hold through Ctx (killCamRadius / killCamPitch / killCamHold) because a 15 m body
needs a wide, high orbit that clears the rooftops, and it now holds until the ending card instead of cutting away after 3 s. Death
steam thinned again so the body reads through it.
-
Day of 09-09 (play-test): the static was the Titan's steam. TitanFx drives a white-noise AudioSource off the death plume,
which held at full forever - and once the music faded on the ending card it was the only thing playing. It fades out over a few
seconds after he drops, at less than half the volume.
-
Day of 09-09 (play-test): camera trauma falls off much faster. A stomp used linear falloff over 40 m and a house coming down
over 70 m, so events a block away still shoved the camera. All three (stomp, step, crush) are squared falloff over a shorter range.
-
Day of 09-09 (play-test): free look holds. The recentre pulled the view back behind her from 8 m/s at 3.0/s, which reads as the
camera snapping rather than free look; it starts at 14 m/s at 0.9/s now, and the ground re-base needs 7 m/s instead of 2 so a walk
no longer re-bases the view. Sensitivity defaults to 0.5 on WebGL, since a browser reports pointer-lock deltas through the canvas
and reads about twice as fast as the standalone build.
-
Day of 09-09 (play-test): the pause-screen sensitivity control is now real buttons (text-only GUI.Buttons looked like labels and
had a glyph-wide hit area), and - / + / keypad work as keys anywhere, not just , and ..
-
Day of 09-09 (play-test): R now really restarts. Leaving the title is a SendMessage from the Hud to the camera rig, and after
a Reboot that message could land on a rig that no longer existed (or before the new one had registered), so the game restarted
underneath a camera still stuck in its title orbit - the "helicopter shot you can't get out of". CameraMode.Title now treats the
titleHold flag as the authority and dives out of the orbit whether or not the message arrived; the Hud only latches the orbit once
a live rig has taken it; and Hud.RestartHud resets every Hud static (video, orbit latch, cutscene timer, help fade) so a rebuilt
world does not inherit a half-finished title. -autoRestart lifts the rebuilt title too, so the harness exercises the whole loop.
