VRTRAKILL
VR mod for ULTRAKILL through SteamVR. Runs on the current Steam build 22957324. A fork of whateverusername0's VRTRAKILL.
CHANGELOG
Changelog
2.0.3
- Streamer view: the gaze ring is thicker and more opaque (85% instead of 50%), so it stays visible in a compressed video.
- Streamer view: the game's full-screen effects (parry flash, hurt screen, fades to black or white, underwater tint) now cover the whole picture. The mod makes them bigger to fill the headset's view; seen from the streamer camera they covered only part of the picture, in big pixel blocks (a parry showed a brown shape over half the screen).
- Streamer view: the pause menu and the VR column show in levels. The level's walls hid them from the streamer camera (Unity's occlusion culling), so only the controller's laser could be seen.
- The log has a line for every eye-aimed parry (it stopped after 5), so a recording can be cut from the log.
2.0.2
- The Thunderstore version has no update check, download or install at all (asked by the Thunderstore moderators): it makes no network request, and your mod manager updates it. The GitHub zips keep the check and the signed installer.
- Optional movement gestures, off by default (GESTURES in the VR column, "Movement gestures" in the config, version 24); the buttons keep working beside them:
- Slam with fists: in the air, both fists driven down below the chest press slide, which the game turns into a ground slam; kept low after landing, the power slam. If the game refuses the slam (too close to the ground), the key is let go at once, so landing does not start a slide.
- Pull the whiplash by yanking: once the hook has caught something, pulling the arm hand back toward the body lets the whiplash key go, which is when the game pulls, even with the button still held.
- Slide by crouching: on the ground, the head 30 cm below its standing height holds slide, standing back up stops it (10 cm of hysteresis); off when playing seated. In VR the eye height comes from the real head only, so the game's slide camera drop does not add to the crouch.
- Headset comparison for videos:
Y(or COMPARE in the VR column) shows the raw headset view, shaking and rolling with the head like a plain mirror recording, next to the streamer view, in a corner or side by side, each labelled. The headset side is one eye with the headset's own field of view, the comfort vignette and the game's floating panels, like a plain mirror recording; the streamer side keeps the gaze ring, the parry marks and the HUD. "Headset comparison" in the "Streamer view" settings (config version 23).
2.0.1
- The README and the mod's DLLs now say that version 2.0 was made with the help of an AI assistant (Anthropic's Claude), as Thunderstore asks of mods made with AI. Nothing else changed.
2.0.0
A new version of motaweh's 1.0.2: the problems players reported most are fixed (from the 171 issues of the original mod), and the VR feel goes further (buttons inside the game, prompts that name your controller's buttons, layouts for more headsets, left-handed play, controller feedback, HUD on the wrist, auto height, settings in the headset):
- VR start (the most reported problem, "the game does not start in VR"):
- The game no longer freezes on the boot screen when SteamVR or the headset is not ready. A background check asks SteamVR whether it runs and sees a headset, and VR starts only then.
- VR starts by itself as soon as the headset is ready, at any time. You no longer need to restart the game, and there is no 3-minute limit.
- If SteamVR is not running when the game starts, the game starts it the way a VR game does, with the game as SteamVR's startup app (as before).
- When SteamVR has only just started, VR waits a few seconds before starting, so SteamVR Home or Room Setup, which SteamVR may still be launching, do not take VR away from the game.
- If SteamVR stops VR for the game later (another VR app started, SteamVR closed), the desktop window says so instead of leaving a frozen headset image.
- The menu laser no longer throws an error every frame while VR is not running.
- When VR starts after the game (headset turned on later), the hand trackers and the SteamVR plugin are set up then too; before, a failed first try left them broken for the session.
- If SteamVR stops answering (for example its "Unexpected SteamVR Error" with the headset unplugged), the desktop window says so; the game keeps running.
- The retries really run now. Before, the game destroyed the object that ran them right after startup, so only the first try happened.
- The desktop window says why VR is not running: SteamVR closed, no headset, or a game build other than 22957324.
- The game keeps running when its window loses focus, so the headset image no longer freezes when a SteamVR window or another program takes focus.
- Movement: "Movement multiplier" now defaults to 1 (the game's speed). The old default 0.575 also lowered jumps to about a third of their height and made some tutorial jumps impossible. Jump power has its own "Jump multiplier" (default 1).
- Punch: a 2 m/s swing is enough (was 3.75 m/s), and a swing a few frames before or after the press still counts. "Enable movement-based punching": false now gives a button-only punch.
- Your config file is updated once: the old defaults (movement multiplier 0.575, punch speed 7.5) move to the new ones and the new settings are added to the file. Values you changed are kept.
- "Auto height" (on by default): at the start of each level your head is put at the game's own eye height, whatever your real height, seated or standing; crouching and leaning stay real. Press H on the keyboard ("Recalibrate height") to measure again. Before, the view sat at your real height above the player's body, which gave "constant crouch", "too tall" and seated-play problems.
- New "Height offset (meters)" moves the view and the hands up or down on top of that. The log prints your eye height at the first level.
- The view stays on your character. At the start of each level, and with "Recenter view" (or H), the spot where you stand in your room becomes the character's position. Before, the view sat wherever your head was relative to the centre of the SteamVR play area, often far from the character (2.4 m in the PS VR2 test), so walking up to a wall put the view inside it and the headset showed black. When you lean or step toward a wall, the view now stops a few centimetres before it.
- Full frame rate in the headset. The game caps its frame rate from the desktop: the monitor's refresh rate at start-up, plus its own frame limit and vsync. On a 60 Hz monitor it ran at 60 fps under a 90 or 120 Hz headset, which then has to reproject. While VR runs the cap and vsync are now off and SteamVR paces the frames (measured with the null headset: 16.7 ms frames before, 7.2 ms after). Your desktop settings are not changed.
- VR settings in the headset. A "VR" column next to the pause menu, made from the game's own buttons, changes the main settings without leaving the game: turn mode (smooth, snap 30/45/90), turn speed, UI size, comfort vignette, screen flashes, HUD on the wrist or floating, rumble strength (with a preview pulse), height offset, recenter view, punch by swing or by button, and left handed. Changes apply at once and are saved to the config file. The HUD can now switch between the wrist and floating while playing.
- Optional comfort vignette ("Comfort vignette", off by default): the edge of the view darkens while you move fast, dash, slam, fall fast, get launched by an explosion or the whiplash, or turn with the stick. Drawn on top of each eye, so the game's own image is untouched.
- Comfort presets. COMFORT at the top of the VR column sets turning, the comfort vignette, screen flashes and weapon shake together: BEGINNER (snap turning, vignette, no flashes, still weapons), STANDARD (the defaults) or ULTRAKILL (fast smooth turning, full flashes, the game's shake). It shows CUSTOM once you change one of them yourself.
- A streamer view on the monitor. The monitor showed one eye of the headset, shaking and rolling with every head movement, or with
Ta camera fixed to the left eye.T(or STREAMER VIEW in the VR column) now switches to a camera made for recording: at the middle of your eyes, head turns smoothed (less during fast turns), the horizon level, game motion such as dashes not delayed, snap turns eased for viewers, a 90 degree 16:9 picture letterboxed to the window, drawn 60 times a second so the headset keeps its frame rate, without the comfort vignette. The choice is saved ("Streamer view" settings, which replace "DesktopView Settings"). - Video overlays on the streamer view, never in the headset: a HUD with health, stamina, the weapon in hand in its variation's colour, and the style rank with its meter, freshness and bonus list (+ PARRY, + HEADSHOT...) on a grey backdrop that stays readable over a bright sky (in VR they sit on your wrist and at the edge of your view; the game's own style panel, which floats beside the view in VR, is left out of the streamer picture while this HUD shows), and with "Overlay" a small ring where your eyes look (PS VR2 eye tracking, smoothed while the eyes rest, jumping with them, fading in blinks), an "EYE-AIMED PARRY" pulse with the path the projectile was sent along, the parry warning, and what the adaptive triggers feel like when it changes (a charge step, READY, LOCKED, another weapon), fading after two seconds, since viewers cannot feel them.
- One Play button for VR and flat. With the new "Start in VR" setting on "Auto" (the default), the game starts in VR when SteamVR is running (started first, or the game launched from inside VR) and flat on the monitor otherwise, with nothing of the mod applied and a short notice saying how to get VR. "Always" keeps the old behavior (the game starts SteamVR and waits for the headset), "Never" always starts flat, and the launch options
--vr/--novrwin over the setting. - One-click install: the release zips have
INSTALL VRTRAKILL.batat their root. Extract the zip anywhere and double-click it: it finds ULTRAKILL through Steam's libraries on any drive (or asks for the folder), waits for the game to be closed, copies the mod into the game folder and keeps your existing VRTRAKILL settings. With the mod-only zip and no BepInEx in the game folder, it says to use the full zip.UNINSTALL VRTRAKILL.batnext to it asks first, then removes the mod and its settings, puts back the game's originalglobalgamemanagersfrom the patcher's backup (only while the file is still the patched one; a game update's new original is left alone), and removes BepInEx only when no other mod's files are in it. - No forced roll after a portal or a gravity change. The game rolls its camera back to level over a quarter to half a second to hide the cut; in VR that rolled the whole view against your head. The view now keeps only your real head roll.
- Stick turning keeps its speed in the game's slow motion and hit stops (a parry, a big hit), where it slowed down or stopped. It still does not turn while the game is paused.
- Fainter screen flashes ("Screen flashes", reduced by default). In VR the white flash of a parry and the red flash of damage cover the whole view, several times a second in a fight; game accessibility guidance flags exactly that, red flashes most of all. "Reduced" caps them at a quarter of their brightness, "Off" hides them, "Full" keeps the game's look. Damage still rumbles both hands. Fades to black are not changed. With "Reduced" or "Off", explosions are softer too: the sphere skips its pure white first frame, is a little more see-through, and its light is half as strong; size, damage and timing are the game's.
- Steadier weapons while they charge ("Weapon charge shake", a tenth by default). Charging the Piercer, the shotgun's pump or grenade, the railcannon, the cannonball or the jackhammer moves the model to a new random spot every frame, up to about 2 cm. On a flat screen that is a tremble; in VR the gun is a small model in your hand, so it rattled. It now keeps a tenth of that shake, so a charge still shows.
1gives the game's shake back,0holds the gun still. - Controller feedback. Each hand vibrates on its own: before, only the strongest rumble played, on one controller, so firing while sliding lost the slide. New: a tick in the hand whose shot or punch lands (heavy hits tick harder), a knock on a kill, a thud in both hands when hurt, and ticks when the menu laser reaches or presses a button. New settings: "Rumble strength", "Hit and kill rumble", "Damage rumble", "Menu rumble". Vibration is now sent with a real frequency (it was sent the strength as frequency).
- A heartbeat when health is low ("Low health warning", on by default). Below 30 health both hands beat, faster and stronger near death (65 to 110 beats a minute), and the edge of the view takes a dark red glow that swells with each beat: slow, at the edge and dim, so it is not a flash. The health bar on the wrist is out of sight in a fight; now you feel it.
- A parry has its own feel: a full-strength crack in the arm hand, then a deep knock through the time stop, and an echo in the gun hand. The parry flash is fainter in VR and the camera shake never reaches the eyes, so the hands now carry the moment. It plays with "Hit and kill rumble".
- Parried projectiles go where you look ("Parry aim"). They went along the arm hand, and a punch points the fist anywhere, so parried shots flew off in every direction and rarely back at an enemy. They now follow your eyes on PS VR2 with the PSVR2 Toolkit (its eye tracking), and your head elsewhere, like the flat game's camera; an enemy within half a metre of that line is hit. You can watch the enemy while your head follows the punch.
"Head"uses the head only,"Hand"brings back the old aim. - A tick in the arm hand when you can parry ("Parry warning", on by default). When an enemy projectile the Feedbacker can parry comes within reach of the punch and is still coming at you, the arm hand ticks once: punch now. It helps with shots from the side or below, which a flat screen would show in the middle of the view. Each projectile ticks once, and a volley is a short patter.
- PS VR2 adaptive triggers, with the PSVR2 Toolkit installed: the gun trigger has a crisp break on the revolver, a heavy one on the shotgun, firm resistance on the jackhammer, a rattle on the nailgun and a late break on the rocket launcher; the punch trigger clicks lightly for the Feedbacker and pushes back for the Knuckleblaster. The gun trigger follows the weapon too: its break grows heavier as a charge builds (Piercer, shotgun pump and core, cannonball, jackhammer swing), it hums once the charge is full or the railcannon is ready, it buzzes hard on a third pump (one more explodes), and it locks stiff while the railcannon recharges or the nailgun has burnt out. On PS VR2, R2 and L2 now act at three quarters of their travel, just past each break, so the shot leaves as the trigger gives way instead of halfway through the resistance. Menus, the shop and pause free both triggers, and they are freed when the game closes. "Adaptive triggers" (TRIGGERS in the VR column) turns it off.
- "Fingers" in the VR column: the arm hand's fingers follow yours from the controller's finger sensors, switched on and off at once. Before, "Finger tracking" was only in the config file and took effect from the next level.
- VR buttons no longer need the ULTRAKILL window in front (#117 and the old wiki's "keep the ULTRAKILL window active"). They press a keyboard and a mouse that exist only inside the game's Input System, so nothing reaches Windows or other programs, and no Windows shortcut can fire. Your game key bindings still apply. Checked in Level 1-1 with another window in front: weapon slot, weapon wheel scroll, shoot, jump, pause, unpause, whiplash and punch all work; with the old Windows key presses none did. "Windows key presses" in the controller settings brings back the old way if a button misbehaves.
- Task Manager no longer opens mid-fight. Slide + dash + pause sent Ctrl+Shift+Esc to Windows.
- VR buttons are not sent to other programs when the game window does not have focus, and held buttons are released when the game loses focus or quits.
- Left handed works (#62 and 3 more reports). The buttons swap hands too: shoot on the left trigger, punch on the right, move with the right stick, Cross/A become Square/X and so on, through mirrored default layouts for PS VR2, Quest, Index, Vive and WMR that the mod picks when VR starts. The arm and the guns are no longer swapped twice, and the revolver is no longer turned around in the left hand. The setting is now called "Left handed"; the old "Left handed (BROKEN)" value is kept. A layout you made yourself in SteamVR's binding screen still wins.
- The game's prompts name your controller's buttons. The prompts, the tutorial and the hints named the keys of the keyboard the mod presses (SPACE, LEFT SHIFT). They now name the button on the controller you hold, the way that controller labels it: Cross, R2 or L3 on PS VR2, A or Right trigger on Quest and Pico, D-pad down on Steam Frame, Left trackpad up on a Vive wand. With "Left handed" on they follow the mirrored layout. Flat play and the weapon slot keys keep the game's own text.
- The punch hints say how to punch in VR. With swing punching on, the button alone does nothing, and the hint only named the button; it now adds "VR: hold it and swing your arm". The 1.x VR texts had stopped being applied in the 22957324 port and are removed.
- "Enable controller-based aiming" and "WHIPLASH: camera-based aiming" are gone from the config. Since the 22957324 port they did nothing: guns always aim with the gun hand and the whiplash with the arm hand. Your file loses them at the next start.
- Steam Frame and Pico layouts. The Steam Frame and Pico controllers get their own default layouts, checked against the input profiles of SteamVR's Steam Frame and Steam Link drivers, each with a left-handed version. Through Virtual Desktop a Pico uses the Quest layout.
- The pause menu shows in levels. It was drawn but never seen: menus and the floating HUD sit 72 m away, and the UI camera used the level's occlusion culling, so a wall between you and that point hid them. That is also why the floating HUD "sometimes disappears" (noted by the FRAUD fork). The UI camera no longer uses occlusion culling. Checked in Level 1-1: the menu shows, and stays in place when you turn.
- Health and stamina are on your arm-hand wrist, like a watch, instead of floating low in your view ("HUD on wrist" in the UI interaction settings; false brings back the floating panel). UI held close to the eyes is no longer clipped.
- The wrist panel stays on the wrist while you move and turn. It is part of the main HUD canvas, which moves with the view every frame and could carry the panel after it was placed, so it trailed behind the hand (PS VR2 test). It is now placed again just before each frame is drawn.
- A controller that loses tracking no longer sends its hand away. When the headset's cameras lose a PS VR2 controller, its position drifts on the motion sensors alone (3.7 m under the floor in a PS VR2 test log). While SteamVR reports the controller out of range, or the hand is farther from the head than an arm reaches, the hand keeps its last place near you and its rotation stays live, so aiming still works; it returns to the real position when tracking comes back, without throwing a punch.
- A smaller interface. Menus and the floating HUD spanned about 80 degrees, which put the style meter and other edge panels where headset lenses blur ("the UI is too close, I can't read it", PS VR2 test). They now span about 56 degrees, and "UI size" in the VR column (75% to 156%) changes it at once. Config files with the old default move to the new one.
- The shop and other in-world screens follow the laser. They picked the button at the centre of your view, so the highlight and the click went where you looked while the laser pointed elsewhere (PS VR2 test, shop).
- The far scenery of the Limbo levels (and the space sky) is the same in both eyes. The game renders it as a picture just before a camera draws; only the left eye rendered it, so the right eye showed the left eye's picture, with other trees and clouds in each eye (PS VR2 test, 1-1).
- The New Blood logo at start-up fits in the view. It is a video the game draws over its camera's whole view, so it filled each eye edge to edge and "NEW BLOOD INTERACTIVE" ran past both sides (PS VR2 test). It now plays on a floating panel at the size of the menus.
- The crosshair sits on the real shot line. Every gun fires from the gun hand, but the crosshair was placed from the gun rig, or from the model for the rocket launcher and jackhammer: measured in game it was 3 degrees off for every gun and 5.6 for the rocket launcher ("rocket launcher off-centred", #165, #195). Now 0.
- The crosshair sits at the depth of what you aim at. It floated 8 m ahead of the gun, so in front of a nearer wall it showed behind the wall, and in front of a shop screen the eyes saw it over another button than the one the hand pointed at (PS VR2 test). It now sits on the wall or enemy the shot line hits, or on the laser's point in menus and shops, keeps the same size to the eye, and glides between near and far.
- The rocket launcher model sits in the gun hand like the other guns. It was drawn about 30 cm toward the middle of the view and up from the hand (#195).
- The sandbox spawner arm aims from your gun hand again, as in 1.x: spawning, moving, altering and building go where the hand points, and a moved object keeps its distance from the hand. The 22957324 port had dropped its patch, so it aimed with your head.
- The sandbox works in VR. The game opens its cheat menu (the spawner arm's tools, noclip and the other cheats) with keyboard keys or a gamepad combo, and turns cheats on with the Konami code, none of which exist on VR controllers. CHEATS in the VR column opens the cheat menu, or with cheats off the game's consent screen; pausing again closes it.
- A small blue marker ahead of the arm hand shows where the whiplash will go while it is ready to throw ("Whiplash aim marker" in the CBS settings).
- Throw the coin. A coin (Marksman revolver) leaves your arm hand, and one tossed while your arm hand makes a throwing move flies along the throw, from 20 to 35 m/s depending on how hard you throw, with some lift so you can shoot it. A still hand tosses it as before. "Coin follows the throw" turns it off.
- White and black screen flashes no longer grow without limit over a session.
- The end-of-level rank screen no longer fails when its canvas is not where the mod expected.
1.0.2
- The weapon wheel stays open while you hold B (Quest) or Circle (PS VR2). Before, it closed after about 1 second.
1.0.1
- Controls follow the common VR shooter layout (Meta's controller guidance and ULTRAKILL's own gamepad layout). The same logic applies to Index, Vive and WMR.
- Jump is on Cross on PS VR2 and A on Quest.
- Dash is on the left stick click.
- Change weapon variation is on Triangle (PS VR2) or Y (Quest).
- Whiplash is on L1 or the left grip.
- Change fist (Feedbacker / Knuckleblaster) is on Square or X.
- The right stick only turns. It no longer switches weapons. Use the weapon wheel. In menus the right stick still scrolls.
- One press of Circle (PS VR2) or B (Quest) goes back in menus. In play only a double press pauses. Options still pauses on PS VR2.
- Menus: Cross on PS VR2 and A on Quest select (the jump button on other controllers). The trigger selects what the laser points at, on either hand.
- Presses no longer leak from menus into the game. The select buttons do not jump, shoot or punch in a menu, or when the menu closes while you hold them.
- A small hand turn while you pull the trigger no longer cancels a click on a button in a scrolling list.
- Rockets, cannonballs and napalm fire from the gun hand.
- The log records what opens and closes the pause menu.
- Controllers no longer keep vibrating after a slide, whiplash or nailgun shot.
- A held punch no longer fires on its own while you walk or use the weapon wheel.
- Punches use stamina and cooldown like in the normal game.
- Held buttons are released when the SteamVR menu opens.
- Jackhammer impact, coin toss, dual wield and parry fixes.
- The SteamVR NoData errors at startup are gone.
- A broken or empty config file no longer disables the mod.
- Turning off "Draw controller models" no longer breaks the hands.
- The weapon wheel uses its own stick and you stop walking while it is open.
- Shop enemy and weapon previews render in the headset.
- 4-S and Clash mode show the platformer camera in the headset.
- HUD and menus that appear after a level loads are converted for VR, so the HUD stays visible.
- The desktop view toggle (T key) works.
- Faster start: VRPatcher no longer makes BepInEx rewrite Assembly-CSharp on every start.
- "Enable Controller Rumble" and "Enable Crosshair" in the config file now work.
- New option "Auto update". "Notify" (default) shows a notice in the main menu when a new release is out. "Download" (opt-in) downloads a signed update and installs it at the next start. "Off" turns the check off.
- New option "Game blood and oil stains (experimental)", off by default.
- Thunderstore package for r2modman and Gale. VRPatcher copies the VR game files into
ULTRAKILL_Dataat start-up, so the mod works from a mod manager profile. The zip install works as before. - After this update, reset SteamVR to the default binding if the buttons still act like before (SteamVR Settings > Controllers > Manage Controller Bindings > ULTRAKILL > Default).
1.0.0
- First release for the current ULTRAKILL on Steam, build 22957324 (Unity 2022.3.29f1). No downgrade needed.
- Portal, whiplash, shotgun saw and punch patches are updated for the new game code.
- Runs through SteamVR (OpenVR) on any SteamVR headset. The mod no longer ships Oculus or OpenXR runtime files.
- OpenVR start-up retries if SteamVR is slow to start.
- Tested on PS VR2. New default bindings for PS VR2 Sense. Fixed bindings for Touch, Index, Vive wands and WMR.
- Menus work with the controller laser and the left stick.
- Rebinds from the game's controls menu reach the mod again.
- VRPatcher works with Unity 2022.3. It turns on VR in globalgamemanagers on the first start and patches it again after a game update.
- Full zip with BepInEx 5.4.23.5, and a mod-only zip.