v0.9.0 - Level horizon

Before Your Frames v0.9.0

New

• Level the horizon, on by default. Some scenes are framed with the game camera pitched down or rolled a little, and in VR the whole world inherited that tilt. Now the view is leveled:
  • Pitch up to Level Pitch Degrees (default 20) is fully leveled.
  • Between 20° and 40° the correction fades out, so scenes aimed far up or down keep the game's framing.
  • Turn it off with level horizon in vr settings (main menu or pause menu), or press F in game.
  • In byeframeblink.cfg ([Head Tracking]): Level Horizon = Roll levels only sideways tilt, Off leaves the view as the game frames it. Level Horizon Key changes the key.

Changed

• pc_install.ps1 -Firewall is sturdier.
  • If you once cancelled Windows' "allow this app?" prompt for the game, Windows made rules that block it, and a block rule beats any allow rule. -Firewall now removes those block rules.
  • It checks that the allow rule is really in place afterwards.
  • It warns you if your network is set to Public, because the rule only covers Private networks.
  • Game folders with an apostrophe in the path work now.
  • -Uninstall also removes the firewall rule.

Install

• Frame Standalone: follow https://github.com/davidciglesias/before-your-frames#install-on-the-steam-frame-standalone
• PC (streamed): follow https://github.com/davidciglesias/before-your-frames#install-on-a-pc-streamed

Update

• PC (streamed): run the pc_install.ps1 command again (add -Firewall if eye data doesn't arrive). Or extract BYEFrameBlink.zip into BepInEx\plugins\BYEFrameBlink\, overwriting the old files. Your config is kept either way.
• Steam Frame (standalone): run sh frame_install.sh again in Konsole. It updates the mod and keeps your settings.

Known issues

• Standalone: SteamVR's menu opens once at launch, listing the game as "wine-preloader". Press Resume Game.
• Babble and VRCFaceTracking haven't been tested with real hardware yet, only with simulated data.

SHA-256 (BYEFrameBlink.zip): 8998aa35b8142094bb91a8c0a474dd5d8ae8a7479817f83dd51c523bd4b8e0cd

v0.8.0 - PC installer and blinks-only mode

Before Your Frames v0.8.0

New

• One-line install on PC, no Rai Pal needed. pc_install.ps1 (attached to this release) is the PC twin of the Steam Frame script. It finds the game in your Steam libraries, downloads BepInEx 5, UUVR 0.3.1 and this mod from their GitHub releases, checks them against known checksums, puts them in the game folder and sets UUVR's UI Patch Mode = CanvasRedirect. Run it in PowerShell:

  powershell -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://github.com/davidciglesias/before-your-frames/releases/latest/download/pc_install.ps1))) -Firewall"
  

  -Firewall lets the game receive eye data from the headset (UDP 9000 and 8888, private networks; Windows asks for admin rights once). -GameFolder "<path>" if the game isn't found, -Uninstall to remove everything again. If Rai Pal already manages the game, the script just adds this mod to Rai Pal's BepInEx folder. Run it again to update; your settings are kept.

• Blinks only (head aiming), a comfort option. Keep your real blinks, but aim, and pick menu options, with your head instead of your eyes. In vr settings, the eye tracking row now cycles eyes → blinks only (head aim) → off (head aim). In the config file it's Gaze Aiming = false.

Changed

• The aiming dot is its own choice in head-aim modes. In blinks only and eye tracking off, the dot follows your aiming dot setting (F10, trigger), so you can aim with your head without it. It's only forced on when you aim with your eyes and eye data stops arriving.

Install

• Frame Standalone: follow https://github.com/davidciglesias/before-your-frames#install-on-the-steam-frame-standalone
• PC (streamed): follow https://github.com/davidciglesias/before-your-frames#install-on-a-pc-streamed

Update

• PC (streamed): run the pc_install.ps1 command above again. It works for Rai Pal setups too (it only replaces the mod in Rai Pal's folder). Or, as before, extract BYEFrameBlink.zip into BepInEx\plugins\BYEFrameBlink\, overwriting the old files. Your config is kept either way.
• Steam Frame (standalone): run sh frame_install.sh again in Konsole (download it from this release if needed). It updates the mod and keeps your settings.

Known issues

• Standalone: SteamVR's menu opens once at launch, listing the game as "wine-preloader". Press Resume Game.
• In some scenes the game's own camera is tilted down a little, and the VR view inherits that tilt. Looking into it for 0.9.0.
• Babble and VRCFaceTracking haven't been tested with real hardware yet, only with simulated data.

SHA-256 (BYEFrameBlink.zip): e45f3aefba1c1cdac1197349827e6d6969b016228880e14f940f8be14355ef43

v0.7.0 - Eye tracking beyond frameeyeosc

Before Your Frames v0.7.0

New

• More eye-tracking sources. frameeyeosc still works exactly as before. The mod now also reads:
  • SteamVR / Steam Link's own eye output when streaming from a Steam Frame (SteamVR 2.18.2+, SteamOS 0.4.3+). Turn on OSC output and eye-tracking sharing in Steam Link's VR settings. With this, PC players don't need frameeyeosc at all.
  • Babble (Baballonia / Babble Frame Runtime), on port 8888.
  • VRCFaceTracking, if it's already sending its v2 eye parameters.
• One source at a time. The mod uses the first source in the list that is sending: frameeyeosc, then SteamVR, then Babble, then VRCFaceTracking. If that source stops for a second, the next one takes over. When the higher one comes back, it takes over again. Change the order, or leave a source out, with Source Priority in the [OSC] config section. Extra Ports sets which other ports the mod listens on (default 8888).
• The main menu shows the eye tracker in use, after the mod's version: VR V 0.7.0 · eyes: frameeyeosc. It updates live. The eye tracking option in VR settings shows it too.

Changed

• New name: Before Your Frames, to match the renamed repository (davidciglesias/before-your-frames). Files, folders and config keep the BYEFrameBlink name, so updating works as before.
• VR settings has one option fewer. auto resolution is gone from the menu; it's still in the config file (Auto Resolution).

Install

• Frame Standalone: follow https://github.com/davidciglesias/before-your-frames#install-on-the-steam-frame-standalone
• PC (streamed): follow https://github.com/davidciglesias/before-your-frames#install-on-a-pc-streamed

Update

• PC (streamed): extract BYEFrameBlink.zip into BepInEx\plugins\BYEFrameBlink\, overwriting the old files. Your config is kept, and the new settings are added to it.
• Steam Frame (standalone): run sh frame_install.sh again in Konsole (download it from this release if needed). It updates the mod and keeps your settings. On the headset itself, eye data still comes from frameeyeosc (or Babble). Steam Link's eye output only exists while streaming to a PC.

Known issues

• Standalone: SteamVR's menu opens once at launch, listing the game as "wine-preloader". Press Resume Game.
• Babble and VRCFaceTracking haven't been tested with real hardware yet, only with simulated data.

SHA-256 (BYEFrameBlink.zip): 23729c613eb008d473ed348041af470149bd8d24fed869ede575502a3bb58278

v0.6.1 - Final fixes after a whole run

BYE Frame Blink v0.6.1

Changed

• Pause menu in two columns, with its rows spread further apart, so options are easier to pick by gaze.
• PCVR render quality steps are now 80/100/125% (were 100–175%). Menus still render at 100% or more.

Fixed

• Purple water on the Steam Frame: in some scenes the water's reflections could come out purple for the whole scene. They're now refreshed when water appears and after the resolution changes, so the water looks right.
• VR settings in the pause menu: the right column no longer runs off the edge of the view. The page stays in the middle of the view, and long translations shrink a little to fit.
• Menu label moved to the lower left: the blink-opened "menu" label now sits down to the left of the view, out of the way of what scenes ask you to look at, and no longer trembles.
• Right controller menu button: Steam Input's extra Escape could still close the pause menu right after opening it; the window that ignores it is now longer.
• Webcam picker hidden everywhere in VR: the camera list could still show on the main menu (for example a phone offered as a virtual camera). All webcam-related controls are now hidden in VR wherever they appear.
• Chapter select no longer jumps: it opens straight in its two-column layout.
• Main menu entries overlapping: coming back from a scene or the credits, "subtitles" and "vr settings" could land on the same spot.
• French menu labels are now lowercase like the rest of the game's French menu.
• Regression tests updated for the new menus.

Install

• PC (streamed): extract BYEFrameBlink.zip into BepInEx\plugins\BYEFrameBlink\, overwriting the old files. Your config is kept.
• Steam Frame (standalone): run sh frame_install.sh again in Konsole (download it from this release if needed). It updates the mod and keeps your settings.

Known issues

• Standalone: SteamVR's menu opens once at launch, listing the game as "wine-preloader". Press Resume Game.

SHA-256 (BYEFrameBlink.zip): 509a84dd4f49d9cb6969b155006a60420c10c8aad927996d19cad3f8be0624b9

v0.6.0 - UI improvements and standalone Steam Frame installer

BYE Frame Blink v0.6.0

New

• Easy install on the Steam Frame by itself: frame_install.sh (attached) downloads BepInEx, UUVR and the mod from their official releases, checks them and sets everything up; --eyes-local points frameeyeosc at the headset. See the README's Install on the Steam Frame section.
• Subtitles page: in VR the game's settings page is replaced by a subtitles page with every language as a button. Subtitles are drawn bigger and bold, with an outline, so they read well in the headset.
• Menus in your language: the mod's own entries and the VR settings rows follow the game's language.
• Open the menu without a controller: during play, tilt your head well down, look at the "menu" label and close your eyes for half a second (Gaze Menu Opener).
• Two-column menus: the main menu and chapter select spread their options over two roomy columns, with back on its own row, so they're easier to pick by gaze. The VR settings and subtitles pages measure their text, so long translations don't run into each other.

Better

• Faster on the Steam Frame: performance mode pauses the game's live reflections (Performance Reflections, Off by default there), the heaviest cost in some scenes: about 12 ms → 9 ms per frame, back to full frame rate. Water looks flatter as a result.
• Steadier menu cursor: the dot no longer trembles while it's locked on an option.
• Less clutter: webcam options (calibration, camera feed, eye detection guide) are hidden in VR.
• Version labels in the main menu are bigger and bold.

Fixed

• The right controller's menu button no longer closes the pause menu right after opening it.

Known issues

• Standalone: SteamVR's menu opens once at launch, listing the game as "wine-preloader". Press Resume Game. (Steam treats the game as a flat game; no mod-side fix so far.)

Install

• PC (streamed): extract BYEFrameBlink.zip into BepInEx\plugins\BYEFrameBlink\, overwriting the old files. Your config is kept.
• Steam Frame (standalone): download frame_install.sh and run sh frame_install.sh --eyes-local in Konsole, then add the launch option from the README.

SHA-256 (BYEFrameBlink.zip): 3243e55180fdc61709b0b8e9bfcad5e4c76b384d41c3ef9fc96c82751e146d99

v0.5.0 - Easier menu picking and fixing small visual bugs

BYE Frame Blink v0.5.0

What's new

• Render From Head Pose: the game now renders from where your head actually is. This fixes lighting effects that used to float in front of you and follow your head in some scenes.
• In-game camera device: it follows your head and eyes, the viewfinder is centred on the aiming dot, and it sits farther away so it's easier to focus on. The viewfinder frame is now drawn at a much higher resolution (3× upscale, sharper edges).
• Menus are easier to pick by gaze: options in the main menu, pause menu and VR settings page are spaced further apart (Menu Spacing, default 1.35×; the VR settings page uses a gentler 1.2×).
• VR mod version in the main menu: shown as VR V 0.5.0 below the game version. Please include it in bug reports.
• Main menu recentres in front of you when it loads.
• The UI camera now matches the main camera's per-eye view, so overlays line up with the world.

Known issues

• The fog in the opening section still moves with your head. It's minor and doesn't affect gameplay.

Install

1. Download BYEFrameBlink.zip and extract it into the game folder, overwriting the old files. Same steps as before; see the README.
2. Your existing BepInEx\config\byeframeblink.cfg is kept, and new settings are added with their default values.

SHA-256 (BYEFrameBlink.zip): 150b5b27d9d6683a4b51d6cbd6e0e568c7929056876f8b4807306d88d7b741a8

v0.4.0 - Steam Frame Standalone

BYE Frame Blink v0.4.0

This release adds support for running the game on the Steam Frame itself (through Proton), and fixes a few things you could see on the Frame.

New

• Performance mode (VR > Performance Mode, default Auto: on under Proton/Wine, off on Windows). Turns on 2x MSAA, turns off HDR, uses lighter shadows, and switches off ambient occlusion, bloom, grain and FXAA. Render quality steps become 80/100/125%. You can tune it with Performance MSAA and Performance HDR.
• Auto Resolution (VR > Auto Resolution, default Auto: on in performance mode). Lowers the render resolution a little in heavy moments so no frame is missed (a missed frame makes the view shake), then raises it again when there's room. Auto Resolution Min sets how far it can drop.
• Aim From Rendered View (Gaze > Aim From Rendered View, default on). Aims from the pose each frame was actually drawn with. On the Frame running the game itself, that pose and the earlier tracking pose were about 7° apart.

Fixes

• Eyelids, fades and the vignette now cover the headset's whole field of view. On the Frame, the open upper eyelid used to show as a black band across the top.
• Render Scale now accepts values from 0.25 to 2. Below 1 is lighter on the GPU but blurrier.

Known issues

• In one scene of chapter 3, a dark band doesn't cover the whole view.
• In chapter 4, the camera's UI doesn't follow your head while you take pictures.

Install

Extract BYEFrameBlink.zip into <BepInEx>\plugins\BYEFrameBlink\. Your existing config is kept, and the new settings are added with their defaults.

SHA-256: 236f2cef56c0b5c81ddcc59c926347ea205db8930323a7354c746e9dc9abcf46

v0.3.0 - Adds controller shortcuts, VR settings menu, play without eye tracking

• Adds controller shortcuts
• Adds VR settings menu
• Allows playing without eye tracking

v0.2.0 - Add VR comfort controls and fix blink-menu gaze interactions

• Heavily improves the blink menu interactions
• Fixes reflections
• Fixes blurriness due to wrong focus
• Adds options to show/hide gaze point, recenter and change world size

v0.1.0 pre-release

Initial release that can be sent for people to test